github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/cloudformation/getStack.go

// Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***

package cloudformation

import (
	"context"
	"reflect"

	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// The CloudFormation Stack data source allows access to stack
// outputs and other useful data including the template body.
//
// ## Example Usage
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/cloudformation"
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			network, err := cloudformation.LookupStack(ctx, &cloudformation.LookupStackArgs{
//				Name: "my-network-stack",
//			}, nil)
//			if err != nil {
//				return err
//			}
//			_, err = ec2.NewInstance(ctx, "web", &ec2.InstanceArgs{
//				Ami:          pulumi.String("ami-abb07bcb"),
//				InstanceType: pulumi.String(ec2.InstanceType_T2_Micro),
//				SubnetId:     pulumi.String(network.Outputs.SubnetId),
//				Tags: pulumi.StringMap{
//					"Name": pulumi.String("HelloWorld"),
//				},
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
func LookupStack(ctx *pulumi.Context, args *LookupStackArgs, opts ...pulumi.InvokeOption) (*LookupStackResult, error) {
	opts = internal.PkgInvokeDefaultOpts(opts)
	var rv LookupStackResult
	err := ctx.Invoke("aws:cloudformation/getStack:getStack", args, &rv, opts...)
	if err != nil {
		return nil, err
	}
	return &rv, nil
}

// A collection of arguments for invoking getStack.
type LookupStackArgs struct {
	// Name of the stack
	Name string `pulumi:"name"`
	// Map of tags associated with this stack.
	Tags map[string]string `pulumi:"tags"`
}

// A collection of values returned by getStack.
type LookupStackResult struct {
	// List of capabilities
	Capabilities []string `pulumi:"capabilities"`
	// Description of the stack
	Description string `pulumi:"description"`
	// Whether the rollback of the stack is disabled when stack creation fails
	DisableRollback bool `pulumi:"disableRollback"`
	// ARN of the IAM role used to create the stack.
	IamRoleArn string `pulumi:"iamRoleArn"`
	// The provider-assigned unique ID for this managed resource.
	Id   string `pulumi:"id"`
	Name string `pulumi:"name"`
	// List of SNS topic ARNs to publish stack related events
	NotificationArns []string `pulumi:"notificationArns"`
	// Map of outputs from the stack.
	Outputs map[string]string `pulumi:"outputs"`
	// Map of parameters that specify input parameters for the stack.
	Parameters map[string]string `pulumi:"parameters"`
	// Map of tags associated with this stack.
	Tags map[string]string `pulumi:"tags"`
	// Structure containing the template body.
	TemplateBody string `pulumi:"templateBody"`
	// Amount of time that can pass before the stack status becomes `CREATE_FAILED`
	TimeoutInMinutes int `pulumi:"timeoutInMinutes"`
}

func LookupStackOutput(ctx *pulumi.Context, args LookupStackOutputArgs, opts ...pulumi.InvokeOption) LookupStackResultOutput {
	return pulumi.ToOutputWithContext(context.Background(), args).
		ApplyT(func(v interface{}) (LookupStackResult, error) {
			args := v.(LookupStackArgs)
			r, err := LookupStack(ctx, &args, opts...)
			var s LookupStackResult
			if r != nil {
				s = *r
			}
			return s, err
		}).(LookupStackResultOutput)
}

// A collection of arguments for invoking getStack.
type LookupStackOutputArgs struct {
	// Name of the stack
	Name pulumi.StringInput `pulumi:"name"`
	// Map of tags associated with this stack.
	Tags pulumi.StringMapInput `pulumi:"tags"`
}

func (LookupStackOutputArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*LookupStackArgs)(nil)).Elem()
}

// A collection of values returned by getStack.
type LookupStackResultOutput struct{ *pulumi.OutputState }

func (LookupStackResultOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*LookupStackResult)(nil)).Elem()
}

func (o LookupStackResultOutput) ToLookupStackResultOutput() LookupStackResultOutput {
	return o
}

func (o LookupStackResultOutput) ToLookupStackResultOutputWithContext(ctx context.Context) LookupStackResultOutput {
	return o
}

// List of capabilities
func (o LookupStackResultOutput) Capabilities() pulumi.StringArrayOutput {
	return o.ApplyT(func(v LookupStackResult) []string { return v.Capabilities }).(pulumi.StringArrayOutput)
}

// Description of the stack
func (o LookupStackResultOutput) Description() pulumi.StringOutput {
	return o.ApplyT(func(v LookupStackResult) string { return v.Description }).(pulumi.StringOutput)
}

// Whether the rollback of the stack is disabled when stack creation fails
func (o LookupStackResultOutput) DisableRollback() pulumi.BoolOutput {
	return o.ApplyT(func(v LookupStackResult) bool { return v.DisableRollback }).(pulumi.BoolOutput)
}

// ARN of the IAM role used to create the stack.
func (o LookupStackResultOutput) IamRoleArn() pulumi.StringOutput {
	return o.ApplyT(func(v LookupStackResult) string { return v.IamRoleArn }).(pulumi.StringOutput)
}

// The provider-assigned unique ID for this managed resource.
func (o LookupStackResultOutput) Id() pulumi.StringOutput {
	return o.ApplyT(func(v LookupStackResult) string { return v.Id }).(pulumi.StringOutput)
}

func (o LookupStackResultOutput) Name() pulumi.StringOutput {
	return o.ApplyT(func(v LookupStackResult) string { return v.Name }).(pulumi.StringOutput)
}

// List of SNS topic ARNs to publish stack related events
func (o LookupStackResultOutput) NotificationArns() pulumi.StringArrayOutput {
	return o.ApplyT(func(v LookupStackResult) []string { return v.NotificationArns }).(pulumi.StringArrayOutput)
}

// Map of outputs from the stack.
func (o LookupStackResultOutput) Outputs() pulumi.StringMapOutput {
	return o.ApplyT(func(v LookupStackResult) map[string]string { return v.Outputs }).(pulumi.StringMapOutput)
}

// Map of parameters that specify input parameters for the stack.
func (o LookupStackResultOutput) Parameters() pulumi.StringMapOutput {
	return o.ApplyT(func(v LookupStackResult) map[string]string { return v.Parameters }).(pulumi.StringMapOutput)
}

// Map of tags associated with this stack.
func (o LookupStackResultOutput) Tags() pulumi.StringMapOutput {
	return o.ApplyT(func(v LookupStackResult) map[string]string { return v.Tags }).(pulumi.StringMapOutput)
}

// Structure containing the template body.
func (o LookupStackResultOutput) TemplateBody() pulumi.StringOutput {
	return o.ApplyT(func(v LookupStackResult) string { return v.TemplateBody }).(pulumi.StringOutput)
}

// Amount of time that can pass before the stack status becomes `CREATE_FAILED`
func (o LookupStackResultOutput) TimeoutInMinutes() pulumi.IntOutput {
	return o.ApplyT(func(v LookupStackResult) int { return v.TimeoutInMinutes }).(pulumi.IntOutput)
}

func init() {
	pulumi.RegisterOutputType(LookupStackResultOutput{})
}