github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/ssm/getInstances.go (about)

     1  // Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
     2  // *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***
     3  
     4  package ssm
     5  
     6  import (
     7  	"context"
     8  	"reflect"
     9  
    10  	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
    11  	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    12  )
    13  
    14  // Use this data source to get the instance IDs of SSM managed instances.
    15  //
    16  // ## Example Usage
    17  //
    18  // <!--Start PulumiCodeChooser -->
    19  // ```go
    20  // package main
    21  //
    22  // import (
    23  //
    24  //	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ssm"
    25  //	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    26  //
    27  // )
    28  //
    29  //	func main() {
    30  //		pulumi.Run(func(ctx *pulumi.Context) error {
    31  //			_, err := ssm.GetInstances(ctx, &ssm.GetInstancesArgs{
    32  //				Filters: []ssm.GetInstancesFilter{
    33  //					{
    34  //						Name: "PlatformTypes",
    35  //						Values: []string{
    36  //							"Linux",
    37  //						},
    38  //					},
    39  //				},
    40  //			}, nil)
    41  //			if err != nil {
    42  //				return err
    43  //			}
    44  //			return nil
    45  //		})
    46  //	}
    47  //
    48  // ```
    49  // <!--End PulumiCodeChooser -->
    50  func GetInstances(ctx *pulumi.Context, args *GetInstancesArgs, opts ...pulumi.InvokeOption) (*GetInstancesResult, error) {
    51  	opts = internal.PkgInvokeDefaultOpts(opts)
    52  	var rv GetInstancesResult
    53  	err := ctx.Invoke("aws:ssm/getInstances:getInstances", args, &rv, opts...)
    54  	if err != nil {
    55  		return nil, err
    56  	}
    57  	return &rv, nil
    58  }
    59  
    60  // A collection of arguments for invoking getInstances.
    61  type GetInstancesArgs struct {
    62  	// Configuration block(s) for filtering. Detailed below.
    63  	Filters []GetInstancesFilter `pulumi:"filters"`
    64  }
    65  
    66  // A collection of values returned by getInstances.
    67  type GetInstancesResult struct {
    68  	Filters []GetInstancesFilter `pulumi:"filters"`
    69  	// The provider-assigned unique ID for this managed resource.
    70  	Id string `pulumi:"id"`
    71  	// Set of instance IDs of the matched SSM managed instances.
    72  	Ids []string `pulumi:"ids"`
    73  }
    74  
    75  func GetInstancesOutput(ctx *pulumi.Context, args GetInstancesOutputArgs, opts ...pulumi.InvokeOption) GetInstancesResultOutput {
    76  	return pulumi.ToOutputWithContext(context.Background(), args).
    77  		ApplyT(func(v interface{}) (GetInstancesResult, error) {
    78  			args := v.(GetInstancesArgs)
    79  			r, err := GetInstances(ctx, &args, opts...)
    80  			var s GetInstancesResult
    81  			if r != nil {
    82  				s = *r
    83  			}
    84  			return s, err
    85  		}).(GetInstancesResultOutput)
    86  }
    87  
    88  // A collection of arguments for invoking getInstances.
    89  type GetInstancesOutputArgs struct {
    90  	// Configuration block(s) for filtering. Detailed below.
    91  	Filters GetInstancesFilterArrayInput `pulumi:"filters"`
    92  }
    93  
    94  func (GetInstancesOutputArgs) ElementType() reflect.Type {
    95  	return reflect.TypeOf((*GetInstancesArgs)(nil)).Elem()
    96  }
    97  
    98  // A collection of values returned by getInstances.
    99  type GetInstancesResultOutput struct{ *pulumi.OutputState }
   100  
   101  func (GetInstancesResultOutput) ElementType() reflect.Type {
   102  	return reflect.TypeOf((*GetInstancesResult)(nil)).Elem()
   103  }
   104  
   105  func (o GetInstancesResultOutput) ToGetInstancesResultOutput() GetInstancesResultOutput {
   106  	return o
   107  }
   108  
   109  func (o GetInstancesResultOutput) ToGetInstancesResultOutputWithContext(ctx context.Context) GetInstancesResultOutput {
   110  	return o
   111  }
   112  
   113  func (o GetInstancesResultOutput) Filters() GetInstancesFilterArrayOutput {
   114  	return o.ApplyT(func(v GetInstancesResult) []GetInstancesFilter { return v.Filters }).(GetInstancesFilterArrayOutput)
   115  }
   116  
   117  // The provider-assigned unique ID for this managed resource.
   118  func (o GetInstancesResultOutput) Id() pulumi.StringOutput {
   119  	return o.ApplyT(func(v GetInstancesResult) string { return v.Id }).(pulumi.StringOutput)
   120  }
   121  
   122  // Set of instance IDs of the matched SSM managed instances.
   123  func (o GetInstancesResultOutput) Ids() pulumi.StringArrayOutput {
   124  	return o.ApplyT(func(v GetInstancesResult) []string { return v.Ids }).(pulumi.StringArrayOutput)
   125  }
   126  
   127  func init() {
   128  	pulumi.RegisterOutputType(GetInstancesResultOutput{})
   129  }