1. Packages
  2. Linode Provider
  3. API Docs
  4. getProducerImageShareGroups
Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi
linode logo
Linode v5.6.0 published on Wednesday, Dec 24, 2025 by Pulumi

    Provides information about a list of Image Share Groups 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 Image Share Groups.

    import * as pulumi from "@pulumi/pulumi";
    import * as linode from "@pulumi/linode";
    
    export = async () => {
        const all = await linode.getProducerImageShareGroups({});
        const filtered = await linode.getProducerImageShareGroups({
            filters: [{
                name: "label",
                values: ["my-label"],
            }],
        });
        return {
            "all-share-groups": all.imageShareGroups,
            "filtered-share-groups": filtered.imageShareGroups,
        };
    }
    
    import pulumi
    import pulumi_linode as linode
    
    all = linode.get_producer_image_share_groups()
    filtered = linode.get_producer_image_share_groups(filters=[{
        "name": "label",
        "values": ["my-label"],
    }])
    pulumi.export("all-share-groups", all.image_share_groups)
    pulumi.export("filtered-share-groups", filtered.image_share_groups)
    
    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.GetProducerImageShareGroups(ctx, &linode.GetProducerImageShareGroupsArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		filtered, err := linode.GetProducerImageShareGroups(ctx, &linode.GetProducerImageShareGroupsArgs{
    			Filters: []linode.GetProducerImageShareGroupsFilter{
    				{
    					Name: "label",
    					Values: []string{
    						"my-label",
    					},
    				},
    			},
    		}, nil)
    		if err != nil {
    			return err
    		}
    		ctx.Export("all-share-groups", all.ImageShareGroups)
    		ctx.Export("filtered-share-groups", filtered.ImageShareGroups)
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Linode = Pulumi.Linode;
    
    return await Deployment.RunAsync(() => 
    {
        var all = Linode.GetProducerImageShareGroups.Invoke();
    
        var filtered = Linode.GetProducerImageShareGroups.Invoke(new()
        {
            Filters = new[]
            {
                new Linode.Inputs.GetProducerImageShareGroupsFilterInputArgs
                {
                    Name = "label",
                    Values = new[]
                    {
                        "my-label",
                    },
                },
            },
        });
    
        return new Dictionary<string, object?>
        {
            ["all-share-groups"] = all.Apply(getProducerImageShareGroupsResult => getProducerImageShareGroupsResult.ImageShareGroups),
            ["filtered-share-groups"] = filtered.Apply(getProducerImageShareGroupsResult => getProducerImageShareGroupsResult.ImageShareGroups),
        };
    });
    
    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.GetProducerImageShareGroupsArgs;
    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.getProducerImageShareGroups(GetProducerImageShareGroupsArgs.builder()
                .build());
    
            final var filtered = LinodeFunctions.getProducerImageShareGroups(GetProducerImageShareGroupsArgs.builder()
                .filters(GetProducerImageShareGroupsFilterArgs.builder()
                    .name("label")
                    .values("my-label")
                    .build())
                .build());
    
            ctx.export("all-share-groups", all.imageShareGroups());
            ctx.export("filtered-share-groups", filtered.imageShareGroups());
        }
    }
    
    variables:
      all:
        fn::invoke:
          function: linode:getProducerImageShareGroups
          arguments: {}
      filtered:
        fn::invoke:
          function: linode:getProducerImageShareGroups
          arguments:
            filters:
              - name: label
                values:
                  - my-label
    outputs:
      all-share-groups: ${all.imageShareGroups}
      filtered-share-groups: ${filtered.imageShareGroups}
    

    Filterable Fields

    • id

    • label

    • is_suspended

    Using getProducerImageShareGroups

    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 getProducerImageShareGroups(args: GetProducerImageShareGroupsArgs, opts?: InvokeOptions): Promise<GetProducerImageShareGroupsResult>
    function getProducerImageShareGroupsOutput(args: GetProducerImageShareGroupsOutputArgs, opts?: InvokeOptions): Output<GetProducerImageShareGroupsResult>
    def get_producer_image_share_groups(filters: Optional[Sequence[GetProducerImageShareGroupsFilter]] = None,
                                        image_share_groups: Optional[Sequence[GetProducerImageShareGroupsImageShareGroup]] = None,
                                        order: Optional[str] = None,
                                        order_by: Optional[str] = None,
                                        opts: Optional[InvokeOptions] = None) -> GetProducerImageShareGroupsResult
    def get_producer_image_share_groups_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetProducerImageShareGroupsFilterArgs]]]] = None,
                                        image_share_groups: Optional[pulumi.Input[Sequence[pulumi.Input[GetProducerImageShareGroupsImageShareGroupArgs]]]] = None,
                                        order: Optional[pulumi.Input[str]] = None,
                                        order_by: Optional[pulumi.Input[str]] = None,
                                        opts: Optional[InvokeOptions] = None) -> Output[GetProducerImageShareGroupsResult]
    func GetProducerImageShareGroups(ctx *Context, args *GetProducerImageShareGroupsArgs, opts ...InvokeOption) (*GetProducerImageShareGroupsResult, error)
    func GetProducerImageShareGroupsOutput(ctx *Context, args *GetProducerImageShareGroupsOutputArgs, opts ...InvokeOption) GetProducerImageShareGroupsResultOutput

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

    public static class GetProducerImageShareGroups 
    {
        public static Task<GetProducerImageShareGroupsResult> InvokeAsync(GetProducerImageShareGroupsArgs args, InvokeOptions? opts = null)
        public static Output<GetProducerImageShareGroupsResult> Invoke(GetProducerImageShareGroupsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetProducerImageShareGroupsResult> getProducerImageShareGroups(GetProducerImageShareGroupsArgs args, InvokeOptions options)
    public static Output<GetProducerImageShareGroupsResult> getProducerImageShareGroups(GetProducerImageShareGroupsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: linode:index/getProducerImageShareGroups:getProducerImageShareGroups
      arguments:
        # arguments dictionary

    The following arguments are supported:

    getProducerImageShareGroups Result

    The following output properties are available:

    id String
    The ID of the Image Share Group.
    filters List<Property Map>
    imageShareGroups List<Property Map>
    order String
    orderBy String

    Supporting Types

    GetProducerImageShareGroupsFilter

    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)

    GetProducerImageShareGroupsImageShareGroup

    Created string
    The date and time the Image Share Group was created.
    Description string
    The description of the Image Share Group.
    Expiry string
    The date and time the Image Share Group will expire.
    Id int
    The ID of the Image Share Group.
    ImagesCount int
    The number of images in the Image Share Group.
    IsSuspended bool
    Whether the Image Share Group is suspended.
    Label string
    The label of the Image Share Group.
    MembersCount int
    The number of members in the Image Share Group.
    Updated string
    The date and time the Image Share Group was last updated.
    Uuid string
    The UUID of the Image Share Group.
    Created string
    The date and time the Image Share Group was created.
    Description string
    The description of the Image Share Group.
    Expiry string
    The date and time the Image Share Group will expire.
    Id int
    The ID of the Image Share Group.
    ImagesCount int
    The number of images in the Image Share Group.
    IsSuspended bool
    Whether the Image Share Group is suspended.
    Label string
    The label of the Image Share Group.
    MembersCount int
    The number of members in the Image Share Group.
    Updated string
    The date and time the Image Share Group was last updated.
    Uuid string
    The UUID of the Image Share Group.
    created String
    The date and time the Image Share Group was created.
    description String
    The description of the Image Share Group.
    expiry String
    The date and time the Image Share Group will expire.
    id Integer
    The ID of the Image Share Group.
    imagesCount Integer
    The number of images in the Image Share Group.
    isSuspended Boolean
    Whether the Image Share Group is suspended.
    label String
    The label of the Image Share Group.
    membersCount Integer
    The number of members in the Image Share Group.
    updated String
    The date and time the Image Share Group was last updated.
    uuid String
    The UUID of the Image Share Group.
    created string
    The date and time the Image Share Group was created.
    description string
    The description of the Image Share Group.
    expiry string
    The date and time the Image Share Group will expire.
    id number
    The ID of the Image Share Group.
    imagesCount number
    The number of images in the Image Share Group.
    isSuspended boolean
    Whether the Image Share Group is suspended.
    label string
    The label of the Image Share Group.
    membersCount number
    The number of members in the Image Share Group.
    updated string
    The date and time the Image Share Group was last updated.
    uuid string
    The UUID of the Image Share Group.
    created str
    The date and time the Image Share Group was created.
    description str
    The description of the Image Share Group.
    expiry str
    The date and time the Image Share Group will expire.
    id int
    The ID of the Image Share Group.
    images_count int
    The number of images in the Image Share Group.
    is_suspended bool
    Whether the Image Share Group is suspended.
    label str
    The label of the Image Share Group.
    members_count int
    The number of members in the Image Share Group.
    updated str
    The date and time the Image Share Group was last updated.
    uuid str
    The UUID of the Image Share Group.
    created String
    The date and time the Image Share Group was created.
    description String
    The description of the Image Share Group.
    expiry String
    The date and time the Image Share Group will expire.
    id Number
    The ID of the Image Share Group.
    imagesCount Number
    The number of images in the Image Share Group.
    isSuspended Boolean
    Whether the Image Share Group is suspended.
    label String
    The label of the Image Share Group.
    membersCount Number
    The number of members in the Image Share Group.
    updated String
    The date and time the Image Share Group was last updated.
    uuid String
    The UUID of the Image Share Group.

    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
      Meet Neo: Your AI Platform Teammate