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
idlabelis_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 dictionaryThe following arguments are supported:
- filters List<Property Map>
- List<Property Map>
- order String
- order
By String
getProducerImageShareGroups Result
The following output properties are available:
- Id string
- The ID of the Image Share Group.
- Filters
List<Get
Producer Image Share Groups Filter> -
List<Get
Producer Image Share Groups Image Share Group> - Order string
- Order
By string
- Id string
- The ID of the Image Share Group.
- Filters
[]Get
Producer Image Share Groups Filter -
[]Get
Producer Image Share Groups Image Share Group - Order string
- Order
By string
- id String
- The ID of the Image Share Group.
- filters
List<Get
Producer Image Share Groups Filter> -
List<Get
Producer Image Share Groups Image Share Group> - order String
- order
By String
- id string
- The ID of the Image Share Group.
- filters
Get
Producer Image Share Groups Filter[] -
Get
Producer Image Share Groups Image Share Group[] - order string
- order
By string
- id str
- The ID of the Image Share Group.
- filters
Sequence[Get
Producer Image Share Groups Filter] -
Sequence[Get
Producer Image Share Groups Image Share Group] - order str
- order_
by str
- id String
- The ID of the Image Share Group.
- filters List<Property Map>
- List<Property Map>
- order String
- order
By 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.
- Match
By string - The method to match the field by. (
exact,regex,substring; defaultexact)
- 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.
- Match
By string - The method to match the field by. (
exact,regex,substring; defaultexact)
- 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.
- match
By String - The method to match the field by. (
exact,regex,substring; defaultexact)
- 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.
- match
By string - The method to match the field by. (
exact,regex,substring; defaultexact)
- 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; defaultexact)
- 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.
- match
By String - The method to match the field by. (
exact,regex,substring; defaultexact)
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.
- Images
Count int - The number of images in the Image Share Group.
- Is
Suspended bool - Whether the Image Share Group is suspended.
- Label string
- The label of the Image Share Group.
- Members
Count 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.
- Images
Count int - The number of images in the Image Share Group.
- Is
Suspended bool - Whether the Image Share Group is suspended.
- Label string
- The label of the Image Share Group.
- Members
Count 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.
- images
Count Integer - The number of images in the Image Share Group.
- is
Suspended Boolean - Whether the Image Share Group is suspended.
- label String
- The label of the Image Share Group.
- members
Count 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.
- images
Count number - The number of images in the Image Share Group.
- is
Suspended boolean - Whether the Image Share Group is suspended.
- label string
- The label of the Image Share Group.
- members
Count 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.
- images
Count Number - The number of images in the Image Share Group.
- is
Suspended Boolean - Whether the Image Share Group is suspended.
- label String
- The label of the Image Share Group.
- members
Count 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
linodeTerraform Provider.
