1. Packages
  2. Linode Provider
  3. API Docs
  4. getProducerImageShareGroupImageShares
Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

linode.getProducerImageShareGroupImageShares

linode logo
Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi
Schema (JSON)
pulumi/pulumi-linode

    Provides information about a list of Images shared in the specified Image Share Group that match a set of filters. For more information, see the Linode APIv4 docs. May not be currently available to all users even under v4beta.

    Example Usage

    The following example shows how one might use this data source to list Images shared in an Image Share Group.

    import * as pulumi from "@pulumi/pulumi";
import * as linode from "@pulumi/linode";

export = async () => {
    const all = await linode.getProducerImageShareGroupImageShares({
        sharegroupId: 123,
    });
    const filtered = await linode.getProducerImageShareGroupImageShares({
        sharegroupId: 123,
        filters: [{
            name: "label",
            values: ["my-label"],
        }],
    });
    return {
        "all-shared-images": all.imageShares,
        "filtered-shared-images": filtered.imageShares,
    };
}

    import pulumi
import pulumi_linode as linode

all = linode.get_producer_image_share_group_image_shares(sharegroup_id=123)
filtered = linode.get_producer_image_share_group_image_shares(sharegroup_id=123,
    filters=[{
        "name": "label",
        "values": ["my-label"],
    }])
pulumi.export("all-shared-images", all.image_shares)
pulumi.export("filtered-shared-images", filtered.image_shares)

    package main

import (
	"github.com/pulumi/pulumi-linode/sdk/v5/go/linode"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		all, err := linode.GetProducerImageShareGroupImageShares(ctx, &linode.GetProducerImageShareGroupImageSharesArgs{
			SharegroupId: 123,
		}, nil)
		if err != nil {
			return err
		}
		filtered, err := linode.GetProducerImageShareGroupImageShares(ctx, &linode.GetProducerImageShareGroupImageSharesArgs{
			SharegroupId: 123,
			Filters: []linode.GetProducerImageShareGroupImageSharesFilter{
				{
					Name: "label",
					Values: []string{
						"my-label",
					},
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("all-shared-images", all.ImageShares)
		ctx.Export("filtered-shared-images", filtered.ImageShares)
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Linode = Pulumi.Linode;

return await Deployment.RunAsync(() => 
{
    var all = Linode.GetProducerImageShareGroupImageShares.Invoke(new()
    {
        SharegroupId = 123,
    });

    var filtered = Linode.GetProducerImageShareGroupImageShares.Invoke(new()
    {
        SharegroupId = 123,
        Filters = new[]
        {
            new Linode.Inputs.GetProducerImageShareGroupImageSharesFilterInputArgs
            {
                Name = "label",
                Values = new[]
                {
                    "my-label",
                },
            },
        },
    });

    return new Dictionary<string, object?>
    {
        ["all-shared-images"] = all.Apply(getProducerImageShareGroupImageSharesResult => getProducerImageShareGroupImageSharesResult.ImageShares),
        ["filtered-shared-images"] = filtered.Apply(getProducerImageShareGroupImageSharesResult => getProducerImageShareGroupImageSharesResult.ImageShares),
    };
});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.linode.LinodeFunctions;
import com.pulumi.linode.inputs.GetProducerImageShareGroupImageSharesArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var all = LinodeFunctions.getProducerImageShareGroupImageShares(GetProducerImageShareGroupImageSharesArgs.builder()
            .sharegroupId(123)
            .build());

        final var filtered = LinodeFunctions.getProducerImageShareGroupImageShares(GetProducerImageShareGroupImageSharesArgs.builder()
            .sharegroupId(123)
            .filters(GetProducerImageShareGroupImageSharesFilterArgs.builder()
                .name("label")
                .values("my-label")
                .build())
            .build());

        ctx.export("all-shared-images", all.imageShares());
        ctx.export("filtered-shared-images", filtered.imageShares());
    }
}

    variables:
  all:
    fn::invoke:
      function: linode:getProducerImageShareGroupImageShares
      arguments:
        sharegroupId: 123
  filtered:
    fn::invoke:
      function: linode:getProducerImageShareGroupImageShares
      arguments:
        sharegroupId: 123
        filters:
          - name: label
            values:
              - my-label
outputs:
  all-shared-images: ${all.imageShares}
  filtered-shared-images: ${filtered.imageShares}

    Filterable Fields

    • id

    • label

    Using getProducerImageShareGroupImageShares

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getProducerImageShareGroupImageShares(args: GetProducerImageShareGroupImageSharesArgs, opts?: InvokeOptions): Promise<GetProducerImageShareGroupImageSharesResult>
function getProducerImageShareGroupImageSharesOutput(args: GetProducerImageShareGroupImageSharesOutputArgs, opts?: InvokeOptions): Output<GetProducerImageShareGroupImageSharesResult>
    def get_producer_image_share_group_image_shares(filters: Optional[Sequence[GetProducerImageShareGroupImageSharesFilter]] = None,
                                                image_shares: Optional[Sequence[GetProducerImageShareGroupImageSharesImageShare]] = None,
                                                order: Optional[str] = None,
                                                order_by: Optional[str] = None,
                                                sharegroup_id: Optional[int] = None,
                                                opts: Optional[InvokeOptions] = None) -> GetProducerImageShareGroupImageSharesResult
def get_producer_image_share_group_image_shares_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetProducerImageShareGroupImageSharesFilterArgs]]]] = None,
                                                image_shares: Optional[pulumi.Input[Sequence[pulumi.Input[GetProducerImageShareGroupImageSharesImageShareArgs]]]] = None,
                                                order: Optional[pulumi.Input[str]] = None,
                                                order_by: Optional[pulumi.Input[str]] = None,
                                                sharegroup_id: Optional[pulumi.Input[int]] = None,
                                                opts: Optional[InvokeOptions] = None) -> Output[GetProducerImageShareGroupImageSharesResult]
    func GetProducerImageShareGroupImageShares(ctx *Context, args *GetProducerImageShareGroupImageSharesArgs, opts ...InvokeOption) (*GetProducerImageShareGroupImageSharesResult, error)
func GetProducerImageShareGroupImageSharesOutput(ctx *Context, args *GetProducerImageShareGroupImageSharesOutputArgs, opts ...InvokeOption) GetProducerImageShareGroupImageSharesResultOutput

    > Note: This function is named GetProducerImageShareGroupImageShares in the Go SDK.

    public static class GetProducerImageShareGroupImageShares 
{
    public static Task<GetProducerImageShareGroupImageSharesResult> InvokeAsync(GetProducerImageShareGroupImageSharesArgs args, InvokeOptions? opts = null)
    public static Output<GetProducerImageShareGroupImageSharesResult> Invoke(GetProducerImageShareGroupImageSharesInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetProducerImageShareGroupImageSharesResult> getProducerImageShareGroupImageShares(GetProducerImageShareGroupImageSharesArgs args, InvokeOptions options)
public static Output<GetProducerImageShareGroupImageSharesResult> getProducerImageShareGroupImageShares(GetProducerImageShareGroupImageSharesArgs args, InvokeOptions options)

    fn::invoke:
  function: linode:index/getProducerImageShareGroupImageShares:getProducerImageShareGroupImageShares
  arguments:
    # arguments dictionary

    The following arguments are supported:

    SharegroupId int
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    Filters List<GetProducerImageShareGroupImageSharesFilter>
    ImageShares List<GetProducerImageShareGroupImageSharesImageShare>
    Order string
    OrderBy string
    SharegroupId int
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    Filters []GetProducerImageShareGroupImageSharesFilter
    ImageShares []GetProducerImageShareGroupImageSharesImageShare
    Order string
    OrderBy string
    sharegroupId Integer
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    filters List<GetProducerImageShareGroupImageSharesFilter>
    imageShares List<GetProducerImageShareGroupImageSharesImageShare>
    order String
    orderBy String
    sharegroupId number
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    filters GetProducerImageShareGroupImageSharesFilter[]
    imageShares GetProducerImageShareGroupImageSharesImageShare[]
    order string
    orderBy string
    sharegroup_id int
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    filters Sequence[GetProducerImageShareGroupImageSharesFilter]
    image_shares Sequence[GetProducerImageShareGroupImageSharesImageShare]
    order str
    order_by str
    sharegroupId Number
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    filters List<Property Map>
    imageShares List<Property Map>
    order String
    orderBy String

    getProducerImageShareGroupImageShares Result

    The following output properties are available:

    Id string
    The unique ID assigned to this Image Share.
    SharegroupId int
    The sharegroup_id from the im_ImageShare row.
    Filters List<GetProducerImageShareGroupImageSharesFilter>
    ImageShares List<GetProducerImageShareGroupImageSharesImageShare>
    Order string
    OrderBy string
    Id string
    The unique ID assigned to this Image Share.
    SharegroupId int
    The sharegroup_id from the im_ImageShare row.
    Filters []GetProducerImageShareGroupImageSharesFilter
    ImageShares []GetProducerImageShareGroupImageSharesImageShare
    Order string
    OrderBy string
    id String
    The unique ID assigned to this Image Share.
    sharegroupId Integer
    The sharegroup_id from the im_ImageShare row.
    filters List<GetProducerImageShareGroupImageSharesFilter>
    imageShares List<GetProducerImageShareGroupImageSharesImageShare>
    order String
    orderBy String
    id string
    The unique ID assigned to this Image Share.
    sharegroupId number
    The sharegroup_id from the im_ImageShare row.
    filters GetProducerImageShareGroupImageSharesFilter[]
    imageShares GetProducerImageShareGroupImageSharesImageShare[]
    order string
    orderBy string
    id str
    The unique ID assigned to this Image Share.
    sharegroup_id int
    The sharegroup_id from the im_ImageShare row.
    filters Sequence[GetProducerImageShareGroupImageSharesFilter]
    image_shares Sequence[GetProducerImageShareGroupImageSharesImageShare]
    order str
    order_by str
    id String
    The unique ID assigned to this Image Share.
    sharegroupId Number
    The sharegroup_id from the im_ImageShare row.
    filters List<Property Map>
    imageShares List<Property Map>
    order String
    orderBy String

    Supporting Types

    GetProducerImageShareGroupImageSharesFilter

    Name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    Values List<string>
    A list of values for the filter to allow. These values should all be in string form.
    MatchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    Name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    Values []string
    A list of values for the filter to allow. These values should all be in string form.
    MatchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    name String
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values List<String>
    A list of values for the filter to allow. These values should all be in string form.
    matchBy String
    The method to match the field by. (exact, regex, substring; default exact)
    name string
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values string[]
    A list of values for the filter to allow. These values should all be in string form.
    matchBy string
    The method to match the field by. (exact, regex, substring; default exact)
    name str
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values Sequence[str]
    A list of values for the filter to allow. These values should all be in string form.
    match_by str
    The method to match the field by. (exact, regex, substring; default exact)
    name String
    The name of the field to filter by. See the Filterable Fields section for a complete list of filterable fields.
    values List<String>
    A list of values for the filter to allow. These values should all be in string form.
    matchBy String
    The method to match the field by. (exact, regex, substring; default exact)

    GetProducerImageShareGroupImageSharesImageShare

    Capabilities List<string>
    The capabilities of the Image represented by the Image Share.
    Created string
    When this Image Share was created.
    Deprecated bool
    Whether this Image is deprecated.
    Description string
    A description of the Image Share.
    Id string
    The unique ID assigned to this Image Share.
    ImageSharing GetProducerImageShareGroupImageSharesImageShareImageSharing
    Details about image sharing, including who the image is shared with and by.
    IsPublic bool
    True if the Image is public.
    Label string
    The label of the Image Share.
    Size int
    The minimum size this Image needs to deploy. Size is in MB. example: 2500
    Status string
    The current status of this image. (creating, pending_upload, available)
    Tags List<string>
    A list of customized tags.
    TotalSize int
    The total size of the image in all available regions.
    Type string
    How the Image was created. Manual Images can be created at any time. "Automatic" Images are created automatically from a deleted Linode. (manual, automatic)
    Capabilities []string
    The capabilities of the Image represented by the Image Share.
    Created string
    When this Image Share was created.
    Deprecated bool
    Whether this Image is deprecated.
    Description string
    A description of the Image Share.
    Id string
    The unique ID assigned to this Image Share.
    ImageSharing GetProducerImageShareGroupImageSharesImageShareImageSharing
    Details about image sharing, including who the image is shared with and by.
    IsPublic bool
    True if the Image is public.
    Label string
    The label of the Image Share.
    Size int
    The minimum size this Image needs to deploy. Size is in MB. example: 2500
    Status string
    The current status of this image. (creating, pending_upload, available)
    Tags []string
    A list of customized tags.
    TotalSize int
    The total size of the image in all available regions.
    Type string
    How the Image was created. Manual Images can be created at any time. "Automatic" Images are created automatically from a deleted Linode. (manual, automatic)
    capabilities List<String>
    The capabilities of the Image represented by the Image Share.
    created String
    When this Image Share was created.
    deprecated Boolean
    Whether this Image is deprecated.
    description String
    A description of the Image Share.
    id String
    The unique ID assigned to this Image Share.
    imageSharing GetProducerImageShareGroupImageSharesImageShareImageSharing
    Details about image sharing, including who the image is shared with and by.
    isPublic Boolean
    True if the Image is public.
    label String
    The label of the Image Share.
    size Integer
    The minimum size this Image needs to deploy. Size is in MB. example: 2500
    status String
    The current status of this image. (creating, pending_upload, available)
    tags List<String>
    A list of customized tags.
    totalSize Integer
    The total size of the image in all available regions.
    type String
    How the Image was created. Manual Images can be created at any time. "Automatic" Images are created automatically from a deleted Linode. (manual, automatic)
    capabilities string[]
    The capabilities of the Image represented by the Image Share.
    created string
    When this Image Share was created.
    deprecated boolean
    Whether this Image is deprecated.
    description string
    A description of the Image Share.
    id string
    The unique ID assigned to this Image Share.
    imageSharing GetProducerImageShareGroupImageSharesImageShareImageSharing
    Details about image sharing, including who the image is shared with and by.
    isPublic boolean
    True if the Image is public.
    label string
    The label of the Image Share.
    size number
    The minimum size this Image needs to deploy. Size is in MB. example: 2500
    status string
    The current status of this image. (creating, pending_upload, available)
    tags string[]
    A list of customized tags.
    totalSize number
    The total size of the image in all available regions.
    type string
    How the Image was created. Manual Images can be created at any time. "Automatic" Images are created automatically from a deleted Linode. (manual, automatic)
    capabilities Sequence[str]
    The capabilities of the Image represented by the Image Share.
    created str
    When this Image Share was created.
    deprecated bool
    Whether this Image is deprecated.
    description str
    A description of the Image Share.
    id str
    The unique ID assigned to this Image Share.
    image_sharing GetProducerImageShareGroupImageSharesImageShareImageSharing
    Details about image sharing, including who the image is shared with and by.
    is_public bool
    True if the Image is public.
    label str
    The label of the Image Share.
    size int
    The minimum size this Image needs to deploy. Size is in MB. example: 2500
    status str
    The current status of this image. (creating, pending_upload, available)
    tags Sequence[str]
    A list of customized tags.
    total_size int
    The total size of the image in all available regions.
    type str
    How the Image was created. Manual Images can be created at any time. "Automatic" Images are created automatically from a deleted Linode. (manual, automatic)
    capabilities List<String>
    The capabilities of the Image represented by the Image Share.
    created String
    When this Image Share was created.
    deprecated Boolean
    Whether this Image is deprecated.
    description String
    A description of the Image Share.
    id String
    The unique ID assigned to this Image Share.
    imageSharing Property Map
    Details about image sharing, including who the image is shared with and by.
    isPublic Boolean
    True if the Image is public.
    label String
    The label of the Image Share.
    size Number
    The minimum size this Image needs to deploy. Size is in MB. example: 2500
    status String
    The current status of this image. (creating, pending_upload, available)
    tags List<String>
    A list of customized tags.
    totalSize Number
    The total size of the image in all available regions.
    type String
    How the Image was created. Manual Images can be created at any time. "Automatic" Images are created automatically from a deleted Linode. (manual, automatic)

    GetProducerImageShareGroupImageSharesImageShareImageSharing

    sharedBy Property Map
    Details about who the image is shared by.
    sharedWith Property Map
    Details about who the image is shared with.

    GetProducerImageShareGroupImageSharesImageShareImageSharingSharedBy

    SharegroupId int
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    SharegroupLabel string
    The label from the associated im_ImageShareGroup row.
    SharegroupUuid string
    The sharegroup_uuid from the im_ImageShare row.
    SourceImageId string
    The image id of the base image (will only be shown to producers, will be null for consumers).
    SharegroupId int
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    SharegroupLabel string
    The label from the associated im_ImageShareGroup row.
    SharegroupUuid string
    The sharegroup_uuid from the im_ImageShare row.
    SourceImageId string
    The image id of the base image (will only be shown to producers, will be null for consumers).
    sharegroupId Integer
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    sharegroupLabel String
    The label from the associated im_ImageShareGroup row.
    sharegroupUuid String
    The sharegroup_uuid from the im_ImageShare row.
    sourceImageId String
    The image id of the base image (will only be shown to producers, will be null for consumers).
    sharegroupId number
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    sharegroupLabel string
    The label from the associated im_ImageShareGroup row.
    sharegroupUuid string
    The sharegroup_uuid from the im_ImageShare row.
    sourceImageId string
    The image id of the base image (will only be shown to producers, will be null for consumers).
    sharegroup_id int
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    sharegroup_label str
    The label from the associated im_ImageShareGroup row.
    sharegroup_uuid str
    The sharegroup_uuid from the im_ImageShare row.
    source_image_id str
    The image id of the base image (will only be shown to producers, will be null for consumers).
    sharegroupId Number
    The ID of the Image Share Group to list shared Images from.

    • filter - (Optional) A set of filters used to select Image Share Groups that meet certain requirements.
    sharegroupLabel String
    The label from the associated im_ImageShareGroup row.
    sharegroupUuid String
    The sharegroup_uuid from the im_ImageShare row.
    sourceImageId String
    The image id of the base image (will only be shown to producers, will be null for consumers).

    GetProducerImageShareGroupImageSharesImageShareImageSharingSharedWith

    SharegroupCount int
    The number of sharegroups the private image is present in.
    SharegroupListUrl string
    The GET api url to view the sharegroups in which the image is shared.
    SharegroupCount int
    The number of sharegroups the private image is present in.
    SharegroupListUrl string
    The GET api url to view the sharegroups in which the image is shared.
    sharegroupCount Integer
    The number of sharegroups the private image is present in.
    sharegroupListUrl String
    The GET api url to view the sharegroups in which the image is shared.
    sharegroupCount number
    The number of sharegroups the private image is present in.
    sharegroupListUrl string
    The GET api url to view the sharegroups in which the image is shared.
    sharegroup_count int
    The number of sharegroups the private image is present in.
    sharegroup_list_url str
    The GET api url to view the sharegroups in which the image is shared.
    sharegroupCount Number
    The number of sharegroups the private image is present in.
    sharegroupListUrl String
    The GET api url to view the sharegroups in which the image is shared.

    Package Details

    Repository
    Linode pulumi/pulumi-linode
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the linode Terraform Provider.
    linode logo
    Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi
    Schema (JSON)
    pulumi/pulumi-linode
      Meet Neo: Your AI Platform Teammate