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

linode.getConsumerImageShareGroupImageShares

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 that match a set of filters that have been shared in the Image Share Group that the provided Token has been accepted into. 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.getConsumerImageShareGroupImageShares({});
    const filtered = await linode.getConsumerImageShareGroupImageShares({
        tokenUuid: "54e1adf3-e499-4685-82be-10d29d4e8fae",
        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_consumer_image_share_group_image_shares()
filtered = linode.get_consumer_image_share_group_image_shares(token_uuid="54e1adf3-e499-4685-82be-10d29d4e8fae",
    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.GetConsumerImageShareGroupImageShares(ctx, &linode.GetConsumerImageShareGroupImageSharesArgs{}, nil)
		if err != nil {
			return err
		}
		filtered, err := linode.GetConsumerImageShareGroupImageShares(ctx, &linode.GetConsumerImageShareGroupImageSharesArgs{
			TokenUuid: "54e1adf3-e499-4685-82be-10d29d4e8fae",
			Filters: []linode.GetConsumerImageShareGroupImageSharesFilter{
				{
					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.GetConsumerImageShareGroupImageShares.Invoke();

    var filtered = Linode.GetConsumerImageShareGroupImageShares.Invoke(new()
    {
        TokenUuid = "54e1adf3-e499-4685-82be-10d29d4e8fae",
        Filters = new[]
        {
            new Linode.Inputs.GetConsumerImageShareGroupImageSharesFilterInputArgs
            {
                Name = "label",
                Values = new[]
                {
                    "my-label",
                },
            },
        },
    });

    return new Dictionary<string, object?>
    {
        ["all-shared-images"] = all.Apply(getConsumerImageShareGroupImageSharesResult => getConsumerImageShareGroupImageSharesResult.ImageShares),
        ["filtered-shared-images"] = filtered.Apply(getConsumerImageShareGroupImageSharesResult => getConsumerImageShareGroupImageSharesResult.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.GetConsumerImageShareGroupImageSharesArgs;
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.getConsumerImageShareGroupImageShares(GetConsumerImageShareGroupImageSharesArgs.builder()
            .build());

        final var filtered = LinodeFunctions.getConsumerImageShareGroupImageShares(GetConsumerImageShareGroupImageSharesArgs.builder()
            .tokenUuid("54e1adf3-e499-4685-82be-10d29d4e8fae")
            .filters(GetConsumerImageShareGroupImageSharesFilterArgs.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:getConsumerImageShareGroupImageShares
      arguments: {}
  filtered:
    fn::invoke:
      function: linode:getConsumerImageShareGroupImageShares
      arguments:
        tokenUuid: 54e1adf3-e499-4685-82be-10d29d4e8fae
        filters:
          - name: label
            values:
              - my-label
outputs:
  all-shared-images: ${all.imageShares}
  filtered-shared-images: ${filtered.imageShares}

    Filterable Fields

    • id

    • label

    Using getConsumerImageShareGroupImageShares

    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 getConsumerImageShareGroupImageShares(args: GetConsumerImageShareGroupImageSharesArgs, opts?: InvokeOptions): Promise<GetConsumerImageShareGroupImageSharesResult>
function getConsumerImageShareGroupImageSharesOutput(args: GetConsumerImageShareGroupImageSharesOutputArgs, opts?: InvokeOptions): Output<GetConsumerImageShareGroupImageSharesResult>
    def get_consumer_image_share_group_image_shares(filters: Optional[Sequence[GetConsumerImageShareGroupImageSharesFilter]] = None,
                                                image_shares: Optional[Sequence[GetConsumerImageShareGroupImageSharesImageShare]] = None,
                                                order: Optional[str] = None,
                                                order_by: Optional[str] = None,
                                                token_uuid: Optional[str] = None,
                                                opts: Optional[InvokeOptions] = None) -> GetConsumerImageShareGroupImageSharesResult
def get_consumer_image_share_group_image_shares_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetConsumerImageShareGroupImageSharesFilterArgs]]]] = None,
                                                image_shares: Optional[pulumi.Input[Sequence[pulumi.Input[GetConsumerImageShareGroupImageSharesImageShareArgs]]]] = None,
                                                order: Optional[pulumi.Input[str]] = None,
                                                order_by: Optional[pulumi.Input[str]] = None,
                                                token_uuid: Optional[pulumi.Input[str]] = None,
                                                opts: Optional[InvokeOptions] = None) -> Output[GetConsumerImageShareGroupImageSharesResult]
    func GetConsumerImageShareGroupImageShares(ctx *Context, args *GetConsumerImageShareGroupImageSharesArgs, opts ...InvokeOption) (*GetConsumerImageShareGroupImageSharesResult, error)
func GetConsumerImageShareGroupImageSharesOutput(ctx *Context, args *GetConsumerImageShareGroupImageSharesOutputArgs, opts ...InvokeOption) GetConsumerImageShareGroupImageSharesResultOutput

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

    public static class GetConsumerImageShareGroupImageShares 
{
    public static Task<GetConsumerImageShareGroupImageSharesResult> InvokeAsync(GetConsumerImageShareGroupImageSharesArgs args, InvokeOptions? opts = null)
    public static Output<GetConsumerImageShareGroupImageSharesResult> Invoke(GetConsumerImageShareGroupImageSharesInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetConsumerImageShareGroupImageSharesResult> getConsumerImageShareGroupImageShares(GetConsumerImageShareGroupImageSharesArgs args, InvokeOptions options)
public static Output<GetConsumerImageShareGroupImageSharesResult> getConsumerImageShareGroupImageShares(GetConsumerImageShareGroupImageSharesArgs args, InvokeOptions options)

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

    The following arguments are supported:

    TokenUuid string
    The UUID of the Token that has been accepted into 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<GetConsumerImageShareGroupImageSharesFilter>
    ImageShares List<GetConsumerImageShareGroupImageSharesImageShare>
    Order string
    OrderBy string
    TokenUuid string
    The UUID of the Token that has been accepted into 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 []GetConsumerImageShareGroupImageSharesFilter
    ImageShares []GetConsumerImageShareGroupImageSharesImageShare
    Order string
    OrderBy string
    tokenUuid String
    The UUID of the Token that has been accepted into 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<GetConsumerImageShareGroupImageSharesFilter>
    imageShares List<GetConsumerImageShareGroupImageSharesImageShare>
    order String
    orderBy String
    tokenUuid string
    The UUID of the Token that has been accepted into 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 GetConsumerImageShareGroupImageSharesFilter[]
    imageShares GetConsumerImageShareGroupImageSharesImageShare[]
    order string
    orderBy string
    token_uuid str
    The UUID of the Token that has been accepted into 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[GetConsumerImageShareGroupImageSharesFilter]
    image_shares Sequence[GetConsumerImageShareGroupImageSharesImageShare]
    order str
    order_by str
    tokenUuid String
    The UUID of the Token that has been accepted into 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

    getConsumerImageShareGroupImageShares Result

    The following output properties are available:

    id String
    The unique ID assigned to this Image Share.
    tokenUuid String
    filters List<Property Map>
    imageShares List<Property Map>
    order String
    orderBy String

    Supporting Types

    GetConsumerImageShareGroupImageSharesFilter

    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)

    GetConsumerImageShareGroupImageSharesImageShare

    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 GetConsumerImageShareGroupImageSharesImageShareImageSharing
    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 GetConsumerImageShareGroupImageSharesImageShareImageSharing
    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 GetConsumerImageShareGroupImageSharesImageShareImageSharing
    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 GetConsumerImageShareGroupImageSharesImageShareImageSharing
    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 GetConsumerImageShareGroupImageSharesImageShareImageSharing
    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)

    GetConsumerImageShareGroupImageSharesImageShareImageSharing

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

    GetConsumerImageShareGroupImageSharesImageShareImageSharingSharedBy

    SharegroupId int
    The sharegroup_id from the im_ImageShare row.
    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 sharegroup_id from the im_ImageShare row.
    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 sharegroup_id from the im_ImageShare row.
    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 sharegroup_id from the im_ImageShare row.
    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 sharegroup_id from the im_ImageShare row.
    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 sharegroup_id from the im_ImageShare row.
    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).

    GetConsumerImageShareGroupImageSharesImageShareImageSharingSharedWith

    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