cloudformation

package
v5.43.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 21, 2023 License: Apache-2.0 Imports: 7 Imported by: 1

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type CloudFormationType

type CloudFormationType struct {
	pulumi.CustomResourceState

	// (Optional) Amazon Resource Name (ARN) of the CloudFormation Type version. See also `typeArn`.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// Identifier of the CloudFormation Type default version.
	DefaultVersionId pulumi.StringOutput `pulumi:"defaultVersionId"`
	// Deprecation status of the version.
	DeprecatedStatus pulumi.StringOutput `pulumi:"deprecatedStatus"`
	// Description of the version.
	Description pulumi.StringOutput `pulumi:"description"`
	// URL of the documentation for the CloudFormation Type.
	DocumentationUrl pulumi.StringOutput `pulumi:"documentationUrl"`
	// Amazon Resource Name (ARN) of the IAM Role for CloudFormation to assume when invoking the extension. If your extension calls AWS APIs in any of its handlers, you must create an IAM execution role that includes the necessary permissions to call those AWS APIs, and provision that execution role in your account. When CloudFormation needs to invoke the extension handler, CloudFormation assumes this execution role to create a temporary session token, which it then passes to the extension handler, thereby supplying your extension with the appropriate credentials.
	ExecutionRoleArn pulumi.StringPtrOutput `pulumi:"executionRoleArn"`
	// Whether the CloudFormation Type version is the default version.
	IsDefaultVersion pulumi.BoolOutput `pulumi:"isDefaultVersion"`
	// Configuration block containing logging configuration.
	LoggingConfig CloudFormationTypeLoggingConfigPtrOutput `pulumi:"loggingConfig"`
	// Provisioning behavior of the CloudFormation Type.
	ProvisioningType pulumi.StringOutput `pulumi:"provisioningType"`
	// JSON document of the CloudFormation Type schema.
	Schema pulumi.StringOutput `pulumi:"schema"`
	// URL to the S3 bucket containing the extension project package that contains the necessary files for the extension you want to register. Must begin with `s3://` or `https://`. For example, `s3://example-bucket/example-object`.
	SchemaHandlerPackage pulumi.StringOutput `pulumi:"schemaHandlerPackage"`
	// URL of the source code for the CloudFormation Type.
	SourceUrl pulumi.StringOutput `pulumi:"sourceUrl"`
	// CloudFormation Registry Type. For example, `RESOURCE` or `MODULE`.
	Type pulumi.StringOutput `pulumi:"type"`
	// (Optional) Amazon Resource Name (ARN) of the CloudFormation Type. See also `arn`.
	TypeArn pulumi.StringOutput `pulumi:"typeArn"`
	// CloudFormation Type name. For example, `ExampleCompany::ExampleService::ExampleResource`.
	TypeName pulumi.StringOutput `pulumi:"typeName"`
	// (Optional) Identifier of the CloudFormation Type version.
	VersionId pulumi.StringOutput `pulumi:"versionId"`
	// Scope of the CloudFormation Type.
	Visibility pulumi.StringOutput `pulumi:"visibility"`
}

Manages a version of a CloudFormation Type.

## Example Usage

```go package main

import (

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudformation.NewCloudFormationType(ctx, "example", &cloudformation.CloudFormationTypeArgs{
			SchemaHandlerPackage: pulumi.String(fmt.Sprintf("s3://%v/%v", aws_s3_object.Example.Bucket, aws_s3_object.Example.Key)),
			Type:                 pulumi.String("RESOURCE"),
			TypeName:             pulumi.String("ExampleCompany::ExampleService::ExampleResource"),
			LoggingConfig: &cloudformation.CloudFormationTypeLoggingConfigArgs{
				LogGroupName: pulumi.Any(aws_cloudwatch_log_group.Example.Name),
				LogRoleArn:   pulumi.Any(aws_iam_role.Example.Arn),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

`aws_cloudformation_type` can be imported with their type version Amazon Resource Name (ARN), e.g.,

```sh

$ pulumi import aws:cloudformation/cloudFormationType:CloudFormationType example arn:aws:cloudformation:us-east-1:123456789012:type/resource/ExampleCompany-ExampleService-ExampleType/1

```

func GetCloudFormationType

func GetCloudFormationType(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *CloudFormationTypeState, opts ...pulumi.ResourceOption) (*CloudFormationType, error)

GetCloudFormationType gets an existing CloudFormationType resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewCloudFormationType

func NewCloudFormationType(ctx *pulumi.Context,
	name string, args *CloudFormationTypeArgs, opts ...pulumi.ResourceOption) (*CloudFormationType, error)

NewCloudFormationType registers a new resource with the given unique name, arguments, and options.

func (*CloudFormationType) ElementType

func (*CloudFormationType) ElementType() reflect.Type

func (*CloudFormationType) ToCloudFormationTypeOutput

func (i *CloudFormationType) ToCloudFormationTypeOutput() CloudFormationTypeOutput

func (*CloudFormationType) ToCloudFormationTypeOutputWithContext

func (i *CloudFormationType) ToCloudFormationTypeOutputWithContext(ctx context.Context) CloudFormationTypeOutput

type CloudFormationTypeArgs

type CloudFormationTypeArgs struct {
	// Amazon Resource Name (ARN) of the IAM Role for CloudFormation to assume when invoking the extension. If your extension calls AWS APIs in any of its handlers, you must create an IAM execution role that includes the necessary permissions to call those AWS APIs, and provision that execution role in your account. When CloudFormation needs to invoke the extension handler, CloudFormation assumes this execution role to create a temporary session token, which it then passes to the extension handler, thereby supplying your extension with the appropriate credentials.
	ExecutionRoleArn pulumi.StringPtrInput
	// Configuration block containing logging configuration.
	LoggingConfig CloudFormationTypeLoggingConfigPtrInput
	// URL to the S3 bucket containing the extension project package that contains the necessary files for the extension you want to register. Must begin with `s3://` or `https://`. For example, `s3://example-bucket/example-object`.
	SchemaHandlerPackage pulumi.StringInput
	// CloudFormation Registry Type. For example, `RESOURCE` or `MODULE`.
	Type pulumi.StringPtrInput
	// CloudFormation Type name. For example, `ExampleCompany::ExampleService::ExampleResource`.
	TypeName pulumi.StringInput
}

The set of arguments for constructing a CloudFormationType resource.

func (CloudFormationTypeArgs) ElementType

func (CloudFormationTypeArgs) ElementType() reflect.Type

type CloudFormationTypeArray

type CloudFormationTypeArray []CloudFormationTypeInput

func (CloudFormationTypeArray) ElementType

func (CloudFormationTypeArray) ElementType() reflect.Type

func (CloudFormationTypeArray) ToCloudFormationTypeArrayOutput

func (i CloudFormationTypeArray) ToCloudFormationTypeArrayOutput() CloudFormationTypeArrayOutput

func (CloudFormationTypeArray) ToCloudFormationTypeArrayOutputWithContext

func (i CloudFormationTypeArray) ToCloudFormationTypeArrayOutputWithContext(ctx context.Context) CloudFormationTypeArrayOutput

type CloudFormationTypeArrayInput

type CloudFormationTypeArrayInput interface {
	pulumi.Input

	ToCloudFormationTypeArrayOutput() CloudFormationTypeArrayOutput
	ToCloudFormationTypeArrayOutputWithContext(context.Context) CloudFormationTypeArrayOutput
}

CloudFormationTypeArrayInput is an input type that accepts CloudFormationTypeArray and CloudFormationTypeArrayOutput values. You can construct a concrete instance of `CloudFormationTypeArrayInput` via:

CloudFormationTypeArray{ CloudFormationTypeArgs{...} }

type CloudFormationTypeArrayOutput

type CloudFormationTypeArrayOutput struct{ *pulumi.OutputState }

func (CloudFormationTypeArrayOutput) ElementType

func (CloudFormationTypeArrayOutput) Index

func (CloudFormationTypeArrayOutput) ToCloudFormationTypeArrayOutput

func (o CloudFormationTypeArrayOutput) ToCloudFormationTypeArrayOutput() CloudFormationTypeArrayOutput

func (CloudFormationTypeArrayOutput) ToCloudFormationTypeArrayOutputWithContext

func (o CloudFormationTypeArrayOutput) ToCloudFormationTypeArrayOutputWithContext(ctx context.Context) CloudFormationTypeArrayOutput

type CloudFormationTypeInput

type CloudFormationTypeInput interface {
	pulumi.Input

	ToCloudFormationTypeOutput() CloudFormationTypeOutput
	ToCloudFormationTypeOutputWithContext(ctx context.Context) CloudFormationTypeOutput
}

type CloudFormationTypeLoggingConfig

type CloudFormationTypeLoggingConfig struct {
	// Name of the CloudWatch Log Group where CloudFormation sends error logging information when invoking the type's handlers.
	LogGroupName string `pulumi:"logGroupName"`
	// Amazon Resource Name (ARN) of the IAM Role CloudFormation assumes when sending error logging information to CloudWatch Logs.
	LogRoleArn string `pulumi:"logRoleArn"`
}

type CloudFormationTypeLoggingConfigArgs

type CloudFormationTypeLoggingConfigArgs struct {
	// Name of the CloudWatch Log Group where CloudFormation sends error logging information when invoking the type's handlers.
	LogGroupName pulumi.StringInput `pulumi:"logGroupName"`
	// Amazon Resource Name (ARN) of the IAM Role CloudFormation assumes when sending error logging information to CloudWatch Logs.
	LogRoleArn pulumi.StringInput `pulumi:"logRoleArn"`
}

func (CloudFormationTypeLoggingConfigArgs) ElementType

func (CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigOutput

func (i CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigOutput() CloudFormationTypeLoggingConfigOutput

func (CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigOutputWithContext

func (i CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigOutputWithContext(ctx context.Context) CloudFormationTypeLoggingConfigOutput

func (CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigPtrOutput

func (i CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigPtrOutput() CloudFormationTypeLoggingConfigPtrOutput

func (CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigPtrOutputWithContext

func (i CloudFormationTypeLoggingConfigArgs) ToCloudFormationTypeLoggingConfigPtrOutputWithContext(ctx context.Context) CloudFormationTypeLoggingConfigPtrOutput

type CloudFormationTypeLoggingConfigInput

type CloudFormationTypeLoggingConfigInput interface {
	pulumi.Input

	ToCloudFormationTypeLoggingConfigOutput() CloudFormationTypeLoggingConfigOutput
	ToCloudFormationTypeLoggingConfigOutputWithContext(context.Context) CloudFormationTypeLoggingConfigOutput
}

CloudFormationTypeLoggingConfigInput is an input type that accepts CloudFormationTypeLoggingConfigArgs and CloudFormationTypeLoggingConfigOutput values. You can construct a concrete instance of `CloudFormationTypeLoggingConfigInput` via:

CloudFormationTypeLoggingConfigArgs{...}

type CloudFormationTypeLoggingConfigOutput

type CloudFormationTypeLoggingConfigOutput struct{ *pulumi.OutputState }

func (CloudFormationTypeLoggingConfigOutput) ElementType

func (CloudFormationTypeLoggingConfigOutput) LogGroupName

Name of the CloudWatch Log Group where CloudFormation sends error logging information when invoking the type's handlers.

func (CloudFormationTypeLoggingConfigOutput) LogRoleArn

Amazon Resource Name (ARN) of the IAM Role CloudFormation assumes when sending error logging information to CloudWatch Logs.

func (CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigOutput

func (o CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigOutput() CloudFormationTypeLoggingConfigOutput

func (CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigOutputWithContext

func (o CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigOutputWithContext(ctx context.Context) CloudFormationTypeLoggingConfigOutput

func (CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigPtrOutput

func (o CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigPtrOutput() CloudFormationTypeLoggingConfigPtrOutput

func (CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigPtrOutputWithContext

func (o CloudFormationTypeLoggingConfigOutput) ToCloudFormationTypeLoggingConfigPtrOutputWithContext(ctx context.Context) CloudFormationTypeLoggingConfigPtrOutput

type CloudFormationTypeLoggingConfigPtrInput

type CloudFormationTypeLoggingConfigPtrInput interface {
	pulumi.Input

	ToCloudFormationTypeLoggingConfigPtrOutput() CloudFormationTypeLoggingConfigPtrOutput
	ToCloudFormationTypeLoggingConfigPtrOutputWithContext(context.Context) CloudFormationTypeLoggingConfigPtrOutput
}

CloudFormationTypeLoggingConfigPtrInput is an input type that accepts CloudFormationTypeLoggingConfigArgs, CloudFormationTypeLoggingConfigPtr and CloudFormationTypeLoggingConfigPtrOutput values. You can construct a concrete instance of `CloudFormationTypeLoggingConfigPtrInput` via:

        CloudFormationTypeLoggingConfigArgs{...}

or:

        nil

type CloudFormationTypeLoggingConfigPtrOutput

type CloudFormationTypeLoggingConfigPtrOutput struct{ *pulumi.OutputState }

func (CloudFormationTypeLoggingConfigPtrOutput) Elem

func (CloudFormationTypeLoggingConfigPtrOutput) ElementType

func (CloudFormationTypeLoggingConfigPtrOutput) LogGroupName

Name of the CloudWatch Log Group where CloudFormation sends error logging information when invoking the type's handlers.

func (CloudFormationTypeLoggingConfigPtrOutput) LogRoleArn

Amazon Resource Name (ARN) of the IAM Role CloudFormation assumes when sending error logging information to CloudWatch Logs.

func (CloudFormationTypeLoggingConfigPtrOutput) ToCloudFormationTypeLoggingConfigPtrOutput

func (o CloudFormationTypeLoggingConfigPtrOutput) ToCloudFormationTypeLoggingConfigPtrOutput() CloudFormationTypeLoggingConfigPtrOutput

func (CloudFormationTypeLoggingConfigPtrOutput) ToCloudFormationTypeLoggingConfigPtrOutputWithContext

func (o CloudFormationTypeLoggingConfigPtrOutput) ToCloudFormationTypeLoggingConfigPtrOutputWithContext(ctx context.Context) CloudFormationTypeLoggingConfigPtrOutput

type CloudFormationTypeMap

type CloudFormationTypeMap map[string]CloudFormationTypeInput

func (CloudFormationTypeMap) ElementType

func (CloudFormationTypeMap) ElementType() reflect.Type

func (CloudFormationTypeMap) ToCloudFormationTypeMapOutput

func (i CloudFormationTypeMap) ToCloudFormationTypeMapOutput() CloudFormationTypeMapOutput

func (CloudFormationTypeMap) ToCloudFormationTypeMapOutputWithContext

func (i CloudFormationTypeMap) ToCloudFormationTypeMapOutputWithContext(ctx context.Context) CloudFormationTypeMapOutput

type CloudFormationTypeMapInput

type CloudFormationTypeMapInput interface {
	pulumi.Input

	ToCloudFormationTypeMapOutput() CloudFormationTypeMapOutput
	ToCloudFormationTypeMapOutputWithContext(context.Context) CloudFormationTypeMapOutput
}

CloudFormationTypeMapInput is an input type that accepts CloudFormationTypeMap and CloudFormationTypeMapOutput values. You can construct a concrete instance of `CloudFormationTypeMapInput` via:

CloudFormationTypeMap{ "key": CloudFormationTypeArgs{...} }

type CloudFormationTypeMapOutput

type CloudFormationTypeMapOutput struct{ *pulumi.OutputState }

func (CloudFormationTypeMapOutput) ElementType

func (CloudFormationTypeMapOutput) MapIndex

func (CloudFormationTypeMapOutput) ToCloudFormationTypeMapOutput

func (o CloudFormationTypeMapOutput) ToCloudFormationTypeMapOutput() CloudFormationTypeMapOutput

func (CloudFormationTypeMapOutput) ToCloudFormationTypeMapOutputWithContext

func (o CloudFormationTypeMapOutput) ToCloudFormationTypeMapOutputWithContext(ctx context.Context) CloudFormationTypeMapOutput

type CloudFormationTypeOutput

type CloudFormationTypeOutput struct{ *pulumi.OutputState }

func (CloudFormationTypeOutput) Arn added in v5.4.0

(Optional) Amazon Resource Name (ARN) of the CloudFormation Type version. See also `typeArn`.

func (CloudFormationTypeOutput) DefaultVersionId added in v5.4.0

func (o CloudFormationTypeOutput) DefaultVersionId() pulumi.StringOutput

Identifier of the CloudFormation Type default version.

func (CloudFormationTypeOutput) DeprecatedStatus added in v5.4.0

func (o CloudFormationTypeOutput) DeprecatedStatus() pulumi.StringOutput

Deprecation status of the version.

func (CloudFormationTypeOutput) Description added in v5.4.0

Description of the version.

func (CloudFormationTypeOutput) DocumentationUrl added in v5.4.0

func (o CloudFormationTypeOutput) DocumentationUrl() pulumi.StringOutput

URL of the documentation for the CloudFormation Type.

func (CloudFormationTypeOutput) ElementType

func (CloudFormationTypeOutput) ElementType() reflect.Type

func (CloudFormationTypeOutput) ExecutionRoleArn added in v5.4.0

func (o CloudFormationTypeOutput) ExecutionRoleArn() pulumi.StringPtrOutput

Amazon Resource Name (ARN) of the IAM Role for CloudFormation to assume when invoking the extension. If your extension calls AWS APIs in any of its handlers, you must create an IAM execution role that includes the necessary permissions to call those AWS APIs, and provision that execution role in your account. When CloudFormation needs to invoke the extension handler, CloudFormation assumes this execution role to create a temporary session token, which it then passes to the extension handler, thereby supplying your extension with the appropriate credentials.

func (CloudFormationTypeOutput) IsDefaultVersion added in v5.4.0

func (o CloudFormationTypeOutput) IsDefaultVersion() pulumi.BoolOutput

Whether the CloudFormation Type version is the default version.

func (CloudFormationTypeOutput) LoggingConfig added in v5.4.0

Configuration block containing logging configuration.

func (CloudFormationTypeOutput) ProvisioningType added in v5.4.0

func (o CloudFormationTypeOutput) ProvisioningType() pulumi.StringOutput

Provisioning behavior of the CloudFormation Type.

func (CloudFormationTypeOutput) Schema added in v5.4.0

JSON document of the CloudFormation Type schema.

func (CloudFormationTypeOutput) SchemaHandlerPackage added in v5.4.0

func (o CloudFormationTypeOutput) SchemaHandlerPackage() pulumi.StringOutput

URL to the S3 bucket containing the extension project package that contains the necessary files for the extension you want to register. Must begin with `s3://` or `https://`. For example, `s3://example-bucket/example-object`.

func (CloudFormationTypeOutput) SourceUrl added in v5.4.0

URL of the source code for the CloudFormation Type.

func (CloudFormationTypeOutput) ToCloudFormationTypeOutput

func (o CloudFormationTypeOutput) ToCloudFormationTypeOutput() CloudFormationTypeOutput

func (CloudFormationTypeOutput) ToCloudFormationTypeOutputWithContext

func (o CloudFormationTypeOutput) ToCloudFormationTypeOutputWithContext(ctx context.Context) CloudFormationTypeOutput

func (CloudFormationTypeOutput) Type added in v5.4.0

CloudFormation Registry Type. For example, `RESOURCE` or `MODULE`.

func (CloudFormationTypeOutput) TypeArn added in v5.4.0

(Optional) Amazon Resource Name (ARN) of the CloudFormation Type. See also `arn`.

func (CloudFormationTypeOutput) TypeName added in v5.4.0

CloudFormation Type name. For example, `ExampleCompany::ExampleService::ExampleResource`.

func (CloudFormationTypeOutput) VersionId added in v5.4.0

(Optional) Identifier of the CloudFormation Type version.

func (CloudFormationTypeOutput) Visibility added in v5.4.0

Scope of the CloudFormation Type.

type CloudFormationTypeState

type CloudFormationTypeState struct {
	// (Optional) Amazon Resource Name (ARN) of the CloudFormation Type version. See also `typeArn`.
	Arn pulumi.StringPtrInput
	// Identifier of the CloudFormation Type default version.
	DefaultVersionId pulumi.StringPtrInput
	// Deprecation status of the version.
	DeprecatedStatus pulumi.StringPtrInput
	// Description of the version.
	Description pulumi.StringPtrInput
	// URL of the documentation for the CloudFormation Type.
	DocumentationUrl pulumi.StringPtrInput
	// Amazon Resource Name (ARN) of the IAM Role for CloudFormation to assume when invoking the extension. If your extension calls AWS APIs in any of its handlers, you must create an IAM execution role that includes the necessary permissions to call those AWS APIs, and provision that execution role in your account. When CloudFormation needs to invoke the extension handler, CloudFormation assumes this execution role to create a temporary session token, which it then passes to the extension handler, thereby supplying your extension with the appropriate credentials.
	ExecutionRoleArn pulumi.StringPtrInput
	// Whether the CloudFormation Type version is the default version.
	IsDefaultVersion pulumi.BoolPtrInput
	// Configuration block containing logging configuration.
	LoggingConfig CloudFormationTypeLoggingConfigPtrInput
	// Provisioning behavior of the CloudFormation Type.
	ProvisioningType pulumi.StringPtrInput
	// JSON document of the CloudFormation Type schema.
	Schema pulumi.StringPtrInput
	// URL to the S3 bucket containing the extension project package that contains the necessary files for the extension you want to register. Must begin with `s3://` or `https://`. For example, `s3://example-bucket/example-object`.
	SchemaHandlerPackage pulumi.StringPtrInput
	// URL of the source code for the CloudFormation Type.
	SourceUrl pulumi.StringPtrInput
	// CloudFormation Registry Type. For example, `RESOURCE` or `MODULE`.
	Type pulumi.StringPtrInput
	// (Optional) Amazon Resource Name (ARN) of the CloudFormation Type. See also `arn`.
	TypeArn pulumi.StringPtrInput
	// CloudFormation Type name. For example, `ExampleCompany::ExampleService::ExampleResource`.
	TypeName pulumi.StringPtrInput
	// (Optional) Identifier of the CloudFormation Type version.
	VersionId pulumi.StringPtrInput
	// Scope of the CloudFormation Type.
	Visibility pulumi.StringPtrInput
}

func (CloudFormationTypeState) ElementType

func (CloudFormationTypeState) ElementType() reflect.Type

type GetCloudFormationTypeLoggingConfig

type GetCloudFormationTypeLoggingConfig struct {
	// Name of the CloudWatch Log Group where CloudFormation sends error logging information when invoking the type's handlers.
	LogGroupName string `pulumi:"logGroupName"`
	// ARN of the IAM Role CloudFormation assumes when sending error logging information to CloudWatch Logs.
	LogRoleArn string `pulumi:"logRoleArn"`
}

type GetCloudFormationTypeLoggingConfigArgs

type GetCloudFormationTypeLoggingConfigArgs struct {
	// Name of the CloudWatch Log Group where CloudFormation sends error logging information when invoking the type's handlers.
	LogGroupName pulumi.StringInput `pulumi:"logGroupName"`
	// ARN of the IAM Role CloudFormation assumes when sending error logging information to CloudWatch Logs.
	LogRoleArn pulumi.StringInput `pulumi:"logRoleArn"`
}

func (GetCloudFormationTypeLoggingConfigArgs) ElementType

func (GetCloudFormationTypeLoggingConfigArgs) ToGetCloudFormationTypeLoggingConfigOutput

func (i GetCloudFormationTypeLoggingConfigArgs) ToGetCloudFormationTypeLoggingConfigOutput() GetCloudFormationTypeLoggingConfigOutput

func (GetCloudFormationTypeLoggingConfigArgs) ToGetCloudFormationTypeLoggingConfigOutputWithContext

func (i GetCloudFormationTypeLoggingConfigArgs) ToGetCloudFormationTypeLoggingConfigOutputWithContext(ctx context.Context) GetCloudFormationTypeLoggingConfigOutput

type GetCloudFormationTypeLoggingConfigArray

type GetCloudFormationTypeLoggingConfigArray []GetCloudFormationTypeLoggingConfigInput

func (GetCloudFormationTypeLoggingConfigArray) ElementType

func (GetCloudFormationTypeLoggingConfigArray) ToGetCloudFormationTypeLoggingConfigArrayOutput

func (i GetCloudFormationTypeLoggingConfigArray) ToGetCloudFormationTypeLoggingConfigArrayOutput() GetCloudFormationTypeLoggingConfigArrayOutput

func (GetCloudFormationTypeLoggingConfigArray) ToGetCloudFormationTypeLoggingConfigArrayOutputWithContext

func (i GetCloudFormationTypeLoggingConfigArray) ToGetCloudFormationTypeLoggingConfigArrayOutputWithContext(ctx context.Context) GetCloudFormationTypeLoggingConfigArrayOutput

type GetCloudFormationTypeLoggingConfigArrayInput

type GetCloudFormationTypeLoggingConfigArrayInput interface {
	pulumi.Input

	ToGetCloudFormationTypeLoggingConfigArrayOutput() GetCloudFormationTypeLoggingConfigArrayOutput
	ToGetCloudFormationTypeLoggingConfigArrayOutputWithContext(context.Context) GetCloudFormationTypeLoggingConfigArrayOutput
}

GetCloudFormationTypeLoggingConfigArrayInput is an input type that accepts GetCloudFormationTypeLoggingConfigArray and GetCloudFormationTypeLoggingConfigArrayOutput values. You can construct a concrete instance of `GetCloudFormationTypeLoggingConfigArrayInput` via:

GetCloudFormationTypeLoggingConfigArray{ GetCloudFormationTypeLoggingConfigArgs{...} }

type GetCloudFormationTypeLoggingConfigArrayOutput

type GetCloudFormationTypeLoggingConfigArrayOutput struct{ *pulumi.OutputState }

func (GetCloudFormationTypeLoggingConfigArrayOutput) ElementType

func (GetCloudFormationTypeLoggingConfigArrayOutput) Index

func (GetCloudFormationTypeLoggingConfigArrayOutput) ToGetCloudFormationTypeLoggingConfigArrayOutput

func (o GetCloudFormationTypeLoggingConfigArrayOutput) ToGetCloudFormationTypeLoggingConfigArrayOutput() GetCloudFormationTypeLoggingConfigArrayOutput

func (GetCloudFormationTypeLoggingConfigArrayOutput) ToGetCloudFormationTypeLoggingConfigArrayOutputWithContext

func (o GetCloudFormationTypeLoggingConfigArrayOutput) ToGetCloudFormationTypeLoggingConfigArrayOutputWithContext(ctx context.Context) GetCloudFormationTypeLoggingConfigArrayOutput

type GetCloudFormationTypeLoggingConfigInput

type GetCloudFormationTypeLoggingConfigInput interface {
	pulumi.Input

	ToGetCloudFormationTypeLoggingConfigOutput() GetCloudFormationTypeLoggingConfigOutput
	ToGetCloudFormationTypeLoggingConfigOutputWithContext(context.Context) GetCloudFormationTypeLoggingConfigOutput
}

GetCloudFormationTypeLoggingConfigInput is an input type that accepts GetCloudFormationTypeLoggingConfigArgs and GetCloudFormationTypeLoggingConfigOutput values. You can construct a concrete instance of `GetCloudFormationTypeLoggingConfigInput` via:

GetCloudFormationTypeLoggingConfigArgs{...}

type GetCloudFormationTypeLoggingConfigOutput

type GetCloudFormationTypeLoggingConfigOutput struct{ *pulumi.OutputState }

func (GetCloudFormationTypeLoggingConfigOutput) ElementType

func (GetCloudFormationTypeLoggingConfigOutput) LogGroupName

Name of the CloudWatch Log Group where CloudFormation sends error logging information when invoking the type's handlers.

func (GetCloudFormationTypeLoggingConfigOutput) LogRoleArn

ARN of the IAM Role CloudFormation assumes when sending error logging information to CloudWatch Logs.

func (GetCloudFormationTypeLoggingConfigOutput) ToGetCloudFormationTypeLoggingConfigOutput

func (o GetCloudFormationTypeLoggingConfigOutput) ToGetCloudFormationTypeLoggingConfigOutput() GetCloudFormationTypeLoggingConfigOutput

func (GetCloudFormationTypeLoggingConfigOutput) ToGetCloudFormationTypeLoggingConfigOutputWithContext

func (o GetCloudFormationTypeLoggingConfigOutput) ToGetCloudFormationTypeLoggingConfigOutputWithContext(ctx context.Context) GetCloudFormationTypeLoggingConfigOutput

type GetExportArgs

type GetExportArgs struct {
	// Name of the export as it appears in the console or from [list-exports](http://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-exports.html)
	Name string `pulumi:"name"`
}

A collection of arguments for invoking getExport.

type GetExportOutputArgs

type GetExportOutputArgs struct {
	// Name of the export as it appears in the console or from [list-exports](http://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-exports.html)
	Name pulumi.StringInput `pulumi:"name"`
}

A collection of arguments for invoking getExport.

func (GetExportOutputArgs) ElementType

func (GetExportOutputArgs) ElementType() reflect.Type

type GetExportResult

type GetExportResult struct {
	// ARN of stack that contains the exported output name and value.
	ExportingStackId string `pulumi:"exportingStackId"`
	// The provider-assigned unique ID for this managed resource.
	Id   string `pulumi:"id"`
	Name string `pulumi:"name"`
	// Value from Cloudformation export identified by the export name found from [list-exports](http://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-exports.html)
	Value string `pulumi:"value"`
}

A collection of values returned by getExport.

func GetExport

func GetExport(ctx *pulumi.Context, args *GetExportArgs, opts ...pulumi.InvokeOption) (*GetExportResult, error)

The CloudFormation Export data source allows access to stack exports specified in the [Output](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html) section of the Cloudformation Template using the optional Export Property.

> Note: If you are trying to use a value from a Cloudformation Stack in the same deployment please use normal interpolation or Cloudformation Outputs.

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		subnetId, err := cloudformation.GetExport(ctx, &cloudformation.GetExportArgs{
			Name: "mySubnetIdExportName",
		}, nil)
		if err != nil {
			return err
		}
		_, err = ec2.NewInstance(ctx, "web", &ec2.InstanceArgs{
			Ami:          pulumi.String("ami-abb07bcb"),
			InstanceType: pulumi.String("t2.micro"),
			SubnetId:     *pulumi.String(subnetId.Value),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

type GetExportResultOutput

type GetExportResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getExport.

func (GetExportResultOutput) ElementType

func (GetExportResultOutput) ElementType() reflect.Type

func (GetExportResultOutput) ExportingStackId

func (o GetExportResultOutput) ExportingStackId() pulumi.StringOutput

ARN of stack that contains the exported output name and value.

func (GetExportResultOutput) Id

The provider-assigned unique ID for this managed resource.

func (GetExportResultOutput) Name

func (GetExportResultOutput) ToGetExportResultOutput

func (o GetExportResultOutput) ToGetExportResultOutput() GetExportResultOutput

func (GetExportResultOutput) ToGetExportResultOutputWithContext

func (o GetExportResultOutput) ToGetExportResultOutputWithContext(ctx context.Context) GetExportResultOutput

func (GetExportResultOutput) Value

Value from Cloudformation export identified by the export name found from [list-exports](http://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-exports.html)

type LookupCloudFormationTypeArgs

type LookupCloudFormationTypeArgs struct {
	// ARN of the CloudFormation Type. For example, `arn:aws:cloudformation:us-west-2::type/resource/AWS-EC2-VPC`.
	Arn *string `pulumi:"arn"`
	// CloudFormation Registry Type. For example, `RESOURCE`.
	Type *string `pulumi:"type"`
	// CloudFormation Type name. For example, `AWS::EC2::VPC`.
	TypeName *string `pulumi:"typeName"`
	// Identifier of the CloudFormation Type version.
	VersionId *string `pulumi:"versionId"`
}

A collection of arguments for invoking getCloudFormationType.

type LookupCloudFormationTypeOutputArgs

type LookupCloudFormationTypeOutputArgs struct {
	// ARN of the CloudFormation Type. For example, `arn:aws:cloudformation:us-west-2::type/resource/AWS-EC2-VPC`.
	Arn pulumi.StringPtrInput `pulumi:"arn"`
	// CloudFormation Registry Type. For example, `RESOURCE`.
	Type pulumi.StringPtrInput `pulumi:"type"`
	// CloudFormation Type name. For example, `AWS::EC2::VPC`.
	TypeName pulumi.StringPtrInput `pulumi:"typeName"`
	// Identifier of the CloudFormation Type version.
	VersionId pulumi.StringPtrInput `pulumi:"versionId"`
}

A collection of arguments for invoking getCloudFormationType.

func (LookupCloudFormationTypeOutputArgs) ElementType

type LookupCloudFormationTypeResult

type LookupCloudFormationTypeResult struct {
	Arn string `pulumi:"arn"`
	// Identifier of the CloudFormation Type default version.
	DefaultVersionId string `pulumi:"defaultVersionId"`
	// Deprecation status of the CloudFormation Type.
	DeprecatedStatus string `pulumi:"deprecatedStatus"`
	// Description of the CloudFormation Type.
	Description string `pulumi:"description"`
	// URL of the documentation for the CloudFormation Type.
	DocumentationUrl string `pulumi:"documentationUrl"`
	// ARN of the IAM Role used to register the CloudFormation Type.
	ExecutionRoleArn string `pulumi:"executionRoleArn"`
	// The provider-assigned unique ID for this managed resource.
	Id string `pulumi:"id"`
	// Whether the CloudFormation Type version is the default version.
	IsDefaultVersion bool `pulumi:"isDefaultVersion"`
	// List of objects containing logging configuration.
	LoggingConfigs []GetCloudFormationTypeLoggingConfig `pulumi:"loggingConfigs"`
	// Provisioning behavior of the CloudFormation Type.
	ProvisioningType string `pulumi:"provisioningType"`
	// JSON document of the CloudFormation Type schema.
	Schema string `pulumi:"schema"`
	// URL of the source code for the CloudFormation Type.
	SourceUrl string  `pulumi:"sourceUrl"`
	Type      string  `pulumi:"type"`
	TypeArn   string  `pulumi:"typeArn"`
	TypeName  string  `pulumi:"typeName"`
	VersionId *string `pulumi:"versionId"`
	// Scope of the CloudFormation Type.
	Visibility string `pulumi:"visibility"`
}

A collection of values returned by getCloudFormationType.

func LookupCloudFormationType

func LookupCloudFormationType(ctx *pulumi.Context, args *LookupCloudFormationTypeArgs, opts ...pulumi.InvokeOption) (*LookupCloudFormationTypeResult, error)

Provides details about a CloudFormation Type.

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudformation.LookupCloudFormationType(ctx, &cloudformation.LookupCloudFormationTypeArgs{
			Type:     pulumi.StringRef("RESOURCE"),
			TypeName: pulumi.StringRef("AWS::Athena::WorkGroup"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

type LookupCloudFormationTypeResultOutput

type LookupCloudFormationTypeResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getCloudFormationType.

func (LookupCloudFormationTypeResultOutput) Arn

func (LookupCloudFormationTypeResultOutput) DefaultVersionId

Identifier of the CloudFormation Type default version.

func (LookupCloudFormationTypeResultOutput) DeprecatedStatus

Deprecation status of the CloudFormation Type.

func (LookupCloudFormationTypeResultOutput) Description

Description of the CloudFormation Type.

func (LookupCloudFormationTypeResultOutput) DocumentationUrl

URL of the documentation for the CloudFormation Type.

func (LookupCloudFormationTypeResultOutput) ElementType

func (LookupCloudFormationTypeResultOutput) ExecutionRoleArn

ARN of the IAM Role used to register the CloudFormation Type.

func (LookupCloudFormationTypeResultOutput) Id

The provider-assigned unique ID for this managed resource.

func (LookupCloudFormationTypeResultOutput) IsDefaultVersion

Whether the CloudFormation Type version is the default version.

func (LookupCloudFormationTypeResultOutput) LoggingConfigs

List of objects containing logging configuration.

func (LookupCloudFormationTypeResultOutput) ProvisioningType

Provisioning behavior of the CloudFormation Type.

func (LookupCloudFormationTypeResultOutput) Schema

JSON document of the CloudFormation Type schema.

func (LookupCloudFormationTypeResultOutput) SourceUrl

URL of the source code for the CloudFormation Type.

func (LookupCloudFormationTypeResultOutput) ToLookupCloudFormationTypeResultOutput

func (o LookupCloudFormationTypeResultOutput) ToLookupCloudFormationTypeResultOutput() LookupCloudFormationTypeResultOutput

func (LookupCloudFormationTypeResultOutput) ToLookupCloudFormationTypeResultOutputWithContext

func (o LookupCloudFormationTypeResultOutput) ToLookupCloudFormationTypeResultOutputWithContext(ctx context.Context) LookupCloudFormationTypeResultOutput

func (LookupCloudFormationTypeResultOutput) Type

func (LookupCloudFormationTypeResultOutput) TypeArn

func (LookupCloudFormationTypeResultOutput) TypeName

func (LookupCloudFormationTypeResultOutput) VersionId

func (LookupCloudFormationTypeResultOutput) Visibility

Scope of the CloudFormation Type.

type LookupStackArgs

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 arguments for invoking getStack.

type LookupStackOutputArgs

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

A collection of arguments for invoking getStack.

func (LookupStackOutputArgs) ElementType

func (LookupStackOutputArgs) ElementType() reflect.Type

type LookupStackResult

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"`
}

A collection of values returned by getStack.

func LookupStack

func LookupStack(ctx *pulumi.Context, args *LookupStackArgs, opts ...pulumi.InvokeOption) (*LookupStackResult, error)

The CloudFormation Stack data source allows access to stack outputs and other useful data including the template body.

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi-aws/sdk/v5/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("t2.micro"),
			SubnetId:     *pulumi.String(network.Outputs.SubnetId),
			Tags: pulumi.StringMap{
				"Name": pulumi.String("HelloWorld"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

type LookupStackResultOutput

type LookupStackResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getStack.

func (LookupStackResultOutput) Capabilities

List of capabilities

func (LookupStackResultOutput) Description

Description of the stack

func (LookupStackResultOutput) DisableRollback

func (o LookupStackResultOutput) DisableRollback() pulumi.BoolOutput

Whether the rollback of the stack is disabled when stack creation fails

func (LookupStackResultOutput) ElementType

func (LookupStackResultOutput) ElementType() reflect.Type

func (LookupStackResultOutput) IamRoleArn

ARN of the IAM role used to create the stack.

func (LookupStackResultOutput) Id

The provider-assigned unique ID for this managed resource.

func (LookupStackResultOutput) Name

func (LookupStackResultOutput) NotificationArns

func (o LookupStackResultOutput) NotificationArns() pulumi.StringArrayOutput

List of SNS topic ARNs to publish stack related events

func (LookupStackResultOutput) Outputs

Map of outputs from the stack.

func (LookupStackResultOutput) Parameters

Map of parameters that specify input parameters for the stack.

func (LookupStackResultOutput) Tags

Map of tags associated with this stack.

func (LookupStackResultOutput) TemplateBody

func (o LookupStackResultOutput) TemplateBody() pulumi.StringOutput

Structure containing the template body.

func (LookupStackResultOutput) TimeoutInMinutes

func (o LookupStackResultOutput) TimeoutInMinutes() pulumi.IntOutput

Amount of time that can pass before the stack status becomes `CREATE_FAILED`

func (LookupStackResultOutput) ToLookupStackResultOutput

func (o LookupStackResultOutput) ToLookupStackResultOutput() LookupStackResultOutput

func (LookupStackResultOutput) ToLookupStackResultOutputWithContext

func (o LookupStackResultOutput) ToLookupStackResultOutputWithContext(ctx context.Context) LookupStackResultOutput

type Stack

type Stack struct {
	pulumi.CustomResourceState

	// A list of capabilities.
	// Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, or `CAPABILITY_AUTO_EXPAND`
	Capabilities pulumi.StringArrayOutput `pulumi:"capabilities"`
	// Set to true to disable rollback of the stack if stack creation failed.
	// Conflicts with `onFailure`.
	DisableRollback pulumi.BoolPtrOutput `pulumi:"disableRollback"`
	// The ARN of an IAM role that AWS CloudFormation assumes to create the stack. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.
	IamRoleArn pulumi.StringPtrOutput `pulumi:"iamRoleArn"`
	// Stack name.
	Name pulumi.StringOutput `pulumi:"name"`
	// A list of SNS topic ARNs to publish stack related events.
	NotificationArns pulumi.StringArrayOutput `pulumi:"notificationArns"`
	// Action to be taken if stack creation fails. This must be
	// one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. Conflicts with `disableRollback`.
	OnFailure pulumi.StringPtrOutput `pulumi:"onFailure"`
	// A map of outputs from the stack.
	Outputs pulumi.StringMapOutput `pulumi:"outputs"`
	// A map of Parameter structures that specify input parameters for the stack.
	Parameters pulumi.StringMapOutput `pulumi:"parameters"`
	// Structure containing the stack policy body.
	// Conflicts w/ `policyUrl`.
	PolicyBody pulumi.StringOutput `pulumi:"policyBody"`
	// Location of a file containing the stack policy.
	// Conflicts w/ `policyBody`.
	PolicyUrl pulumi.StringPtrOutput `pulumi:"policyUrl"`
	// Map of resource tags to associate with this stack. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
	// Structure containing the template body (max size: 51,200 bytes).
	TemplateBody pulumi.StringOutput `pulumi:"templateBody"`
	// Location of a file containing the template body (max size: 460,800 bytes).
	TemplateUrl pulumi.StringPtrOutput `pulumi:"templateUrl"`
	// The amount of time that can pass before the stack status becomes `CREATE_FAILED`.
	TimeoutInMinutes pulumi.IntPtrOutput `pulumi:"timeoutInMinutes"`
}

Provides a CloudFormation Stack resource.

## Example Usage

```go package main

import (

"encoding/json"

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		tmpJSON0, err := json.Marshal(map[string]interface{}{
			"Parameters": map[string]interface{}{
				"VPCCidr": map[string]interface{}{
					"Type":        "String",
					"Default":     "10.0.0.0/16",
					"Description": "Enter the CIDR block for the VPC. Default is 10.0.0.0/16.",
				},
			},
			"Resources": map[string]interface{}{
				"myVpc": map[string]interface{}{
					"Type": "AWS::EC2::VPC",
					"Properties": map[string]interface{}{
						"CidrBlock": map[string]interface{}{
							"Ref": "VPCCidr",
						},
						"Tags": []map[string]interface{}{
							map[string]interface{}{
								"Key":   "Name",
								"Value": "Primary_CF_VPC",
							},
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		json0 := string(tmpJSON0)
		_, err = cloudformation.NewStack(ctx, "network", &cloudformation.StackArgs{
			Parameters: pulumi.StringMap{
				"VPCCidr": pulumi.String("10.0.0.0/16"),
			},
			TemplateBody: pulumi.String(json0),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Cloudformation Stacks can be imported using the `name`, e.g.,

```sh

$ pulumi import aws:cloudformation/stack:Stack stack networking-stack

```

func GetStack

func GetStack(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *StackState, opts ...pulumi.ResourceOption) (*Stack, error)

GetStack gets an existing Stack resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewStack

func NewStack(ctx *pulumi.Context,
	name string, args *StackArgs, opts ...pulumi.ResourceOption) (*Stack, error)

NewStack registers a new resource with the given unique name, arguments, and options.

func (*Stack) ElementType

func (*Stack) ElementType() reflect.Type

func (*Stack) ToStackOutput

func (i *Stack) ToStackOutput() StackOutput

func (*Stack) ToStackOutputWithContext

func (i *Stack) ToStackOutputWithContext(ctx context.Context) StackOutput

type StackArgs

type StackArgs struct {
	// A list of capabilities.
	// Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, or `CAPABILITY_AUTO_EXPAND`
	Capabilities pulumi.StringArrayInput
	// Set to true to disable rollback of the stack if stack creation failed.
	// Conflicts with `onFailure`.
	DisableRollback pulumi.BoolPtrInput
	// The ARN of an IAM role that AWS CloudFormation assumes to create the stack. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.
	IamRoleArn pulumi.StringPtrInput
	// Stack name.
	Name pulumi.StringPtrInput
	// A list of SNS topic ARNs to publish stack related events.
	NotificationArns pulumi.StringArrayInput
	// Action to be taken if stack creation fails. This must be
	// one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. Conflicts with `disableRollback`.
	OnFailure pulumi.StringPtrInput
	// A map of Parameter structures that specify input parameters for the stack.
	Parameters pulumi.StringMapInput
	// Structure containing the stack policy body.
	// Conflicts w/ `policyUrl`.
	PolicyBody pulumi.StringPtrInput
	// Location of a file containing the stack policy.
	// Conflicts w/ `policyBody`.
	PolicyUrl pulumi.StringPtrInput
	// Map of resource tags to associate with this stack. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// Structure containing the template body (max size: 51,200 bytes).
	TemplateBody pulumi.StringPtrInput
	// Location of a file containing the template body (max size: 460,800 bytes).
	TemplateUrl pulumi.StringPtrInput
	// The amount of time that can pass before the stack status becomes `CREATE_FAILED`.
	TimeoutInMinutes pulumi.IntPtrInput
}

The set of arguments for constructing a Stack resource.

func (StackArgs) ElementType

func (StackArgs) ElementType() reflect.Type

type StackArray

type StackArray []StackInput

func (StackArray) ElementType

func (StackArray) ElementType() reflect.Type

func (StackArray) ToStackArrayOutput

func (i StackArray) ToStackArrayOutput() StackArrayOutput

func (StackArray) ToStackArrayOutputWithContext

func (i StackArray) ToStackArrayOutputWithContext(ctx context.Context) StackArrayOutput

type StackArrayInput

type StackArrayInput interface {
	pulumi.Input

	ToStackArrayOutput() StackArrayOutput
	ToStackArrayOutputWithContext(context.Context) StackArrayOutput
}

StackArrayInput is an input type that accepts StackArray and StackArrayOutput values. You can construct a concrete instance of `StackArrayInput` via:

StackArray{ StackArgs{...} }

type StackArrayOutput

type StackArrayOutput struct{ *pulumi.OutputState }

func (StackArrayOutput) ElementType

func (StackArrayOutput) ElementType() reflect.Type

func (StackArrayOutput) Index

func (StackArrayOutput) ToStackArrayOutput

func (o StackArrayOutput) ToStackArrayOutput() StackArrayOutput

func (StackArrayOutput) ToStackArrayOutputWithContext

func (o StackArrayOutput) ToStackArrayOutputWithContext(ctx context.Context) StackArrayOutput

type StackInput

type StackInput interface {
	pulumi.Input

	ToStackOutput() StackOutput
	ToStackOutputWithContext(ctx context.Context) StackOutput
}

type StackMap

type StackMap map[string]StackInput

func (StackMap) ElementType

func (StackMap) ElementType() reflect.Type

func (StackMap) ToStackMapOutput

func (i StackMap) ToStackMapOutput() StackMapOutput

func (StackMap) ToStackMapOutputWithContext

func (i StackMap) ToStackMapOutputWithContext(ctx context.Context) StackMapOutput

type StackMapInput

type StackMapInput interface {
	pulumi.Input

	ToStackMapOutput() StackMapOutput
	ToStackMapOutputWithContext(context.Context) StackMapOutput
}

StackMapInput is an input type that accepts StackMap and StackMapOutput values. You can construct a concrete instance of `StackMapInput` via:

StackMap{ "key": StackArgs{...} }

type StackMapOutput

type StackMapOutput struct{ *pulumi.OutputState }

func (StackMapOutput) ElementType

func (StackMapOutput) ElementType() reflect.Type

func (StackMapOutput) MapIndex

func (StackMapOutput) ToStackMapOutput

func (o StackMapOutput) ToStackMapOutput() StackMapOutput

func (StackMapOutput) ToStackMapOutputWithContext

func (o StackMapOutput) ToStackMapOutputWithContext(ctx context.Context) StackMapOutput

type StackOutput

type StackOutput struct{ *pulumi.OutputState }

func (StackOutput) Capabilities added in v5.4.0

func (o StackOutput) Capabilities() pulumi.StringArrayOutput

A list of capabilities. Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, or `CAPABILITY_AUTO_EXPAND`

func (StackOutput) DisableRollback added in v5.4.0

func (o StackOutput) DisableRollback() pulumi.BoolPtrOutput

Set to true to disable rollback of the stack if stack creation failed. Conflicts with `onFailure`.

func (StackOutput) ElementType

func (StackOutput) ElementType() reflect.Type

func (StackOutput) IamRoleArn added in v5.4.0

func (o StackOutput) IamRoleArn() pulumi.StringPtrOutput

The ARN of an IAM role that AWS CloudFormation assumes to create the stack. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.

func (StackOutput) Name added in v5.4.0

func (o StackOutput) Name() pulumi.StringOutput

Stack name.

func (StackOutput) NotificationArns added in v5.4.0

func (o StackOutput) NotificationArns() pulumi.StringArrayOutput

A list of SNS topic ARNs to publish stack related events.

func (StackOutput) OnFailure added in v5.4.0

func (o StackOutput) OnFailure() pulumi.StringPtrOutput

Action to be taken if stack creation fails. This must be one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. Conflicts with `disableRollback`.

func (StackOutput) Outputs added in v5.4.0

func (o StackOutput) Outputs() pulumi.StringMapOutput

A map of outputs from the stack.

func (StackOutput) Parameters added in v5.4.0

func (o StackOutput) Parameters() pulumi.StringMapOutput

A map of Parameter structures that specify input parameters for the stack.

func (StackOutput) PolicyBody added in v5.4.0

func (o StackOutput) PolicyBody() pulumi.StringOutput

Structure containing the stack policy body. Conflicts w/ `policyUrl`.

func (StackOutput) PolicyUrl added in v5.4.0

func (o StackOutput) PolicyUrl() pulumi.StringPtrOutput

Location of a file containing the stack policy. Conflicts w/ `policyBody`.

func (StackOutput) Tags added in v5.4.0

Map of resource tags to associate with this stack. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.

func (StackOutput) TagsAll added in v5.4.0

func (o StackOutput) TagsAll() pulumi.StringMapOutput

A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.

func (StackOutput) TemplateBody added in v5.4.0

func (o StackOutput) TemplateBody() pulumi.StringOutput

Structure containing the template body (max size: 51,200 bytes).

func (StackOutput) TemplateUrl added in v5.4.0

func (o StackOutput) TemplateUrl() pulumi.StringPtrOutput

Location of a file containing the template body (max size: 460,800 bytes).

func (StackOutput) TimeoutInMinutes added in v5.4.0

func (o StackOutput) TimeoutInMinutes() pulumi.IntPtrOutput

The amount of time that can pass before the stack status becomes `CREATE_FAILED`.

func (StackOutput) ToStackOutput

func (o StackOutput) ToStackOutput() StackOutput

func (StackOutput) ToStackOutputWithContext

func (o StackOutput) ToStackOutputWithContext(ctx context.Context) StackOutput

type StackSet

type StackSet struct {
	pulumi.CustomResourceState

	// Amazon Resource Number (ARN) of the IAM Role in the administrator account. This must be defined when using the `SELF_MANAGED` permission model.
	AdministrationRoleArn pulumi.StringPtrOutput `pulumi:"administrationRoleArn"`
	// Amazon Resource Name (ARN) of the StackSet.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// Configuration block containing the auto-deployment model for your StackSet. This can only be defined when using the `SERVICE_MANAGED` permission model.
	AutoDeployment StackSetAutoDeploymentPtrOutput `pulumi:"autoDeployment"`
	// Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.
	CallAs pulumi.StringPtrOutput `pulumi:"callAs"`
	// A list of capabilities. Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, `CAPABILITY_AUTO_EXPAND`.
	Capabilities pulumi.StringArrayOutput `pulumi:"capabilities"`
	// Description of the StackSet.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// Name of the IAM Role in all target accounts for StackSet operations. Defaults to `AWSCloudFormationStackSetExecutionRole` when using the `SELF_MANAGED` permission model. This should not be defined when using the `SERVICE_MANAGED` permission model.
	ExecutionRoleName pulumi.StringOutput `pulumi:"executionRoleName"`
	// Name of the StackSet. The name must be unique in the region where you create your StackSet. The name can contain only alphanumeric characters (case-sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 128 characters.
	Name pulumi.StringOutput `pulumi:"name"`
	// Preferences for how AWS CloudFormation performs a stack set update.
	OperationPreferences StackSetOperationPreferencesPtrOutput `pulumi:"operationPreferences"`
	// Key-value map of input parameters for the StackSet template. All template parameters, including those with a `Default`, must be configured or ignored with `lifecycle` configuration block `ignoreChanges` argument. All `NoEcho` template parameters must be ignored with the `lifecycle` configuration block `ignoreChanges` argument.
	Parameters pulumi.StringMapOutput `pulumi:"parameters"`
	// Describes how the IAM roles required for your StackSet are created. Valid values: `SELF_MANAGED` (default), `SERVICE_MANAGED`.
	PermissionModel pulumi.StringPtrOutput `pulumi:"permissionModel"`
	// Unique identifier of the StackSet.
	StackSetId pulumi.StringOutput `pulumi:"stackSetId"`
	// Key-value map of tags to associate with this StackSet and the Stacks created from it. AWS CloudFormation also propagates these tags to supported resources that are created in the Stacks. A maximum number of 50 tags can be specified. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
	// String containing the CloudFormation template body. Maximum size: 51,200 bytes. Conflicts with `templateUrl`.
	TemplateBody pulumi.StringOutput `pulumi:"templateBody"`
	// String containing the location of a file containing the CloudFormation template body. The URL must point to a template that is located in an Amazon S3 bucket. Maximum location file size: 460,800 bytes. Conflicts with `templateBody`.
	TemplateUrl pulumi.StringPtrOutput `pulumi:"templateUrl"`
}

Manages a CloudFormation StackSet. StackSets allow CloudFormation templates to be easily deployed across multiple accounts and regions via StackSet Instances (`cloudformation.StackSetInstance` resource). Additional information about StackSets can be found in the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html).

> **NOTE:** All template parameters, including those with a `Default`, must be configured or ignored with the `lifecycle` configuration block `ignoreChanges` argument.

> **NOTE:** All `NoEcho` template parameters must be ignored with the `lifecycle` configuration block `ignoreChanges` argument.

## Example Usage

```go package main

import (

"encoding/json"
"fmt"

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/iam"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		aWSCloudFormationStackSetAdministrationRoleAssumeRolePolicy, err := iam.GetPolicyDocument(ctx, &iam.GetPolicyDocumentArgs{
			Statements: []iam.GetPolicyDocumentStatement{
				{
					Actions: []string{
						"sts:AssumeRole",
					},
					Effect: pulumi.StringRef("Allow"),
					Principals: []iam.GetPolicyDocumentStatementPrincipal{
						{
							Identifiers: []string{
								"cloudformation.amazonaws.com",
							},
							Type: "Service",
						},
					},
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		aWSCloudFormationStackSetAdministrationRole, err := iam.NewRole(ctx, "aWSCloudFormationStackSetAdministrationRole", &iam.RoleArgs{
			AssumeRolePolicy: *pulumi.String(aWSCloudFormationStackSetAdministrationRoleAssumeRolePolicy.Json),
		})
		if err != nil {
			return err
		}
		tmpJSON0, err := json.Marshal(map[string]interface{}{
			"Parameters": map[string]interface{}{
				"VPCCidr": map[string]interface{}{
					"Type":        "String",
					"Default":     "10.0.0.0/16",
					"Description": "Enter the CIDR block for the VPC. Default is 10.0.0.0/16.",
				},
			},
			"Resources": map[string]interface{}{
				"myVpc": map[string]interface{}{
					"Type": "AWS::EC2::VPC",
					"Properties": map[string]interface{}{
						"CidrBlock": map[string]interface{}{
							"Ref": "VPCCidr",
						},
						"Tags": []map[string]interface{}{
							map[string]interface{}{
								"Key":   "Name",
								"Value": "Primary_CF_VPC",
							},
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		json0 := string(tmpJSON0)
		example, err := cloudformation.NewStackSet(ctx, "example", &cloudformation.StackSetArgs{
			AdministrationRoleArn: aWSCloudFormationStackSetAdministrationRole.Arn,
			Parameters: pulumi.StringMap{
				"VPCCidr": pulumi.String("10.0.0.0/16"),
			},
			TemplateBody: pulumi.String(json0),
		})
		if err != nil {
			return err
		}
		aWSCloudFormationStackSetAdministrationRoleExecutionPolicyPolicyDocument := iam.GetPolicyDocumentOutput(ctx, iam.GetPolicyDocumentOutputArgs{
			Statements: iam.GetPolicyDocumentStatementArray{
				&iam.GetPolicyDocumentStatementArgs{
					Actions: pulumi.StringArray{
						pulumi.String("sts:AssumeRole"),
					},
					Effect: pulumi.String("Allow"),
					Resources: pulumi.StringArray{
						example.ExecutionRoleName.ApplyT(func(executionRoleName string) (string, error) {
							return fmt.Sprintf("arn:aws:iam::*:role/%v", executionRoleName), nil
						}).(pulumi.StringOutput),
					},
				},
			},
		}, nil)
		_, err = iam.NewRolePolicy(ctx, "aWSCloudFormationStackSetAdministrationRoleExecutionPolicyRolePolicy", &iam.RolePolicyArgs{
			Policy: aWSCloudFormationStackSetAdministrationRoleExecutionPolicyPolicyDocument.ApplyT(func(aWSCloudFormationStackSetAdministrationRoleExecutionPolicyPolicyDocument iam.GetPolicyDocumentResult) (*string, error) {
				return &aWSCloudFormationStackSetAdministrationRoleExecutionPolicyPolicyDocument.Json, nil
			}).(pulumi.StringPtrOutput),
			Role: aWSCloudFormationStackSetAdministrationRole.Name,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

CloudFormation StackSets can be imported using the `name`, e.g.,

```sh

$ pulumi import aws:cloudformation/stackSet:StackSet example example

```

func GetStackSet

func GetStackSet(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *StackSetState, opts ...pulumi.ResourceOption) (*StackSet, error)

GetStackSet gets an existing StackSet resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewStackSet

func NewStackSet(ctx *pulumi.Context,
	name string, args *StackSetArgs, opts ...pulumi.ResourceOption) (*StackSet, error)

NewStackSet registers a new resource with the given unique name, arguments, and options.

func (*StackSet) ElementType

func (*StackSet) ElementType() reflect.Type

func (*StackSet) ToStackSetOutput

func (i *StackSet) ToStackSetOutput() StackSetOutput

func (*StackSet) ToStackSetOutputWithContext

func (i *StackSet) ToStackSetOutputWithContext(ctx context.Context) StackSetOutput

type StackSetArgs

type StackSetArgs struct {
	// Amazon Resource Number (ARN) of the IAM Role in the administrator account. This must be defined when using the `SELF_MANAGED` permission model.
	AdministrationRoleArn pulumi.StringPtrInput
	// Configuration block containing the auto-deployment model for your StackSet. This can only be defined when using the `SERVICE_MANAGED` permission model.
	AutoDeployment StackSetAutoDeploymentPtrInput
	// Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.
	CallAs pulumi.StringPtrInput
	// A list of capabilities. Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, `CAPABILITY_AUTO_EXPAND`.
	Capabilities pulumi.StringArrayInput
	// Description of the StackSet.
	Description pulumi.StringPtrInput
	// Name of the IAM Role in all target accounts for StackSet operations. Defaults to `AWSCloudFormationStackSetExecutionRole` when using the `SELF_MANAGED` permission model. This should not be defined when using the `SERVICE_MANAGED` permission model.
	ExecutionRoleName pulumi.StringPtrInput
	// Name of the StackSet. The name must be unique in the region where you create your StackSet. The name can contain only alphanumeric characters (case-sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 128 characters.
	Name pulumi.StringPtrInput
	// Preferences for how AWS CloudFormation performs a stack set update.
	OperationPreferences StackSetOperationPreferencesPtrInput
	// Key-value map of input parameters for the StackSet template. All template parameters, including those with a `Default`, must be configured or ignored with `lifecycle` configuration block `ignoreChanges` argument. All `NoEcho` template parameters must be ignored with the `lifecycle` configuration block `ignoreChanges` argument.
	Parameters pulumi.StringMapInput
	// Describes how the IAM roles required for your StackSet are created. Valid values: `SELF_MANAGED` (default), `SERVICE_MANAGED`.
	PermissionModel pulumi.StringPtrInput
	// Key-value map of tags to associate with this StackSet and the Stacks created from it. AWS CloudFormation also propagates these tags to supported resources that are created in the Stacks. A maximum number of 50 tags can be specified. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// String containing the CloudFormation template body. Maximum size: 51,200 bytes. Conflicts with `templateUrl`.
	TemplateBody pulumi.StringPtrInput
	// String containing the location of a file containing the CloudFormation template body. The URL must point to a template that is located in an Amazon S3 bucket. Maximum location file size: 460,800 bytes. Conflicts with `templateBody`.
	TemplateUrl pulumi.StringPtrInput
}

The set of arguments for constructing a StackSet resource.

func (StackSetArgs) ElementType

func (StackSetArgs) ElementType() reflect.Type

type StackSetArray

type StackSetArray []StackSetInput

func (StackSetArray) ElementType

func (StackSetArray) ElementType() reflect.Type

func (StackSetArray) ToStackSetArrayOutput

func (i StackSetArray) ToStackSetArrayOutput() StackSetArrayOutput

func (StackSetArray) ToStackSetArrayOutputWithContext

func (i StackSetArray) ToStackSetArrayOutputWithContext(ctx context.Context) StackSetArrayOutput

type StackSetArrayInput

type StackSetArrayInput interface {
	pulumi.Input

	ToStackSetArrayOutput() StackSetArrayOutput
	ToStackSetArrayOutputWithContext(context.Context) StackSetArrayOutput
}

StackSetArrayInput is an input type that accepts StackSetArray and StackSetArrayOutput values. You can construct a concrete instance of `StackSetArrayInput` via:

StackSetArray{ StackSetArgs{...} }

type StackSetArrayOutput

type StackSetArrayOutput struct{ *pulumi.OutputState }

func (StackSetArrayOutput) ElementType

func (StackSetArrayOutput) ElementType() reflect.Type

func (StackSetArrayOutput) Index

func (StackSetArrayOutput) ToStackSetArrayOutput

func (o StackSetArrayOutput) ToStackSetArrayOutput() StackSetArrayOutput

func (StackSetArrayOutput) ToStackSetArrayOutputWithContext

func (o StackSetArrayOutput) ToStackSetArrayOutputWithContext(ctx context.Context) StackSetArrayOutput

type StackSetAutoDeployment

type StackSetAutoDeployment struct {
	// Whether or not auto-deployment is enabled.
	Enabled *bool `pulumi:"enabled"`
	// Whether or not to retain stacks when the account is removed.
	RetainStacksOnAccountRemoval *bool `pulumi:"retainStacksOnAccountRemoval"`
}

type StackSetAutoDeploymentArgs

type StackSetAutoDeploymentArgs struct {
	// Whether or not auto-deployment is enabled.
	Enabled pulumi.BoolPtrInput `pulumi:"enabled"`
	// Whether or not to retain stacks when the account is removed.
	RetainStacksOnAccountRemoval pulumi.BoolPtrInput `pulumi:"retainStacksOnAccountRemoval"`
}

func (StackSetAutoDeploymentArgs) ElementType

func (StackSetAutoDeploymentArgs) ElementType() reflect.Type

func (StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentOutput

func (i StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentOutput() StackSetAutoDeploymentOutput

func (StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentOutputWithContext

func (i StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentOutputWithContext(ctx context.Context) StackSetAutoDeploymentOutput

func (StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentPtrOutput

func (i StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentPtrOutput() StackSetAutoDeploymentPtrOutput

func (StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentPtrOutputWithContext

func (i StackSetAutoDeploymentArgs) ToStackSetAutoDeploymentPtrOutputWithContext(ctx context.Context) StackSetAutoDeploymentPtrOutput

type StackSetAutoDeploymentInput

type StackSetAutoDeploymentInput interface {
	pulumi.Input

	ToStackSetAutoDeploymentOutput() StackSetAutoDeploymentOutput
	ToStackSetAutoDeploymentOutputWithContext(context.Context) StackSetAutoDeploymentOutput
}

StackSetAutoDeploymentInput is an input type that accepts StackSetAutoDeploymentArgs and StackSetAutoDeploymentOutput values. You can construct a concrete instance of `StackSetAutoDeploymentInput` via:

StackSetAutoDeploymentArgs{...}

type StackSetAutoDeploymentOutput

type StackSetAutoDeploymentOutput struct{ *pulumi.OutputState }

func (StackSetAutoDeploymentOutput) ElementType

func (StackSetAutoDeploymentOutput) Enabled

Whether or not auto-deployment is enabled.

func (StackSetAutoDeploymentOutput) RetainStacksOnAccountRemoval

func (o StackSetAutoDeploymentOutput) RetainStacksOnAccountRemoval() pulumi.BoolPtrOutput

Whether or not to retain stacks when the account is removed.

func (StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentOutput

func (o StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentOutput() StackSetAutoDeploymentOutput

func (StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentOutputWithContext

func (o StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentOutputWithContext(ctx context.Context) StackSetAutoDeploymentOutput

func (StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentPtrOutput

func (o StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentPtrOutput() StackSetAutoDeploymentPtrOutput

func (StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentPtrOutputWithContext

func (o StackSetAutoDeploymentOutput) ToStackSetAutoDeploymentPtrOutputWithContext(ctx context.Context) StackSetAutoDeploymentPtrOutput

type StackSetAutoDeploymentPtrInput

type StackSetAutoDeploymentPtrInput interface {
	pulumi.Input

	ToStackSetAutoDeploymentPtrOutput() StackSetAutoDeploymentPtrOutput
	ToStackSetAutoDeploymentPtrOutputWithContext(context.Context) StackSetAutoDeploymentPtrOutput
}

StackSetAutoDeploymentPtrInput is an input type that accepts StackSetAutoDeploymentArgs, StackSetAutoDeploymentPtr and StackSetAutoDeploymentPtrOutput values. You can construct a concrete instance of `StackSetAutoDeploymentPtrInput` via:

        StackSetAutoDeploymentArgs{...}

or:

        nil

type StackSetAutoDeploymentPtrOutput

type StackSetAutoDeploymentPtrOutput struct{ *pulumi.OutputState }

func (StackSetAutoDeploymentPtrOutput) Elem

func (StackSetAutoDeploymentPtrOutput) ElementType

func (StackSetAutoDeploymentPtrOutput) Enabled

Whether or not auto-deployment is enabled.

func (StackSetAutoDeploymentPtrOutput) RetainStacksOnAccountRemoval

func (o StackSetAutoDeploymentPtrOutput) RetainStacksOnAccountRemoval() pulumi.BoolPtrOutput

Whether or not to retain stacks when the account is removed.

func (StackSetAutoDeploymentPtrOutput) ToStackSetAutoDeploymentPtrOutput

func (o StackSetAutoDeploymentPtrOutput) ToStackSetAutoDeploymentPtrOutput() StackSetAutoDeploymentPtrOutput

func (StackSetAutoDeploymentPtrOutput) ToStackSetAutoDeploymentPtrOutputWithContext

func (o StackSetAutoDeploymentPtrOutput) ToStackSetAutoDeploymentPtrOutputWithContext(ctx context.Context) StackSetAutoDeploymentPtrOutput

type StackSetInput

type StackSetInput interface {
	pulumi.Input

	ToStackSetOutput() StackSetOutput
	ToStackSetOutputWithContext(ctx context.Context) StackSetOutput
}

type StackSetInstance

type StackSetInstance struct {
	pulumi.CustomResourceState

	// Target AWS Account ID to create a Stack based on the StackSet. Defaults to current account.
	AccountId pulumi.StringOutput `pulumi:"accountId"`
	// Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.
	CallAs pulumi.StringPtrOutput `pulumi:"callAs"`
	// The AWS Organizations accounts to which StackSets deploys. StackSets doesn't deploy stack instances to the organization management account, even if the organization management account is in your organization or in an OU in your organization. Drift detection is not possible for this argument. See deploymentTargets below.
	DeploymentTargets StackSetInstanceDeploymentTargetsPtrOutput `pulumi:"deploymentTargets"`
	// Preferences for how AWS CloudFormation performs a stack set operation.
	OperationPreferences StackSetInstanceOperationPreferencesPtrOutput `pulumi:"operationPreferences"`
	// The organization root ID or organizational unit (OU) IDs specified for `deploymentTargets`.
	OrganizationalUnitId pulumi.StringOutput `pulumi:"organizationalUnitId"`
	// Key-value map of input parameters to override from the StackSet for this Instance.
	ParameterOverrides pulumi.StringMapOutput `pulumi:"parameterOverrides"`
	// Target AWS Region to create a Stack based on the StackSet. Defaults to current region.
	Region pulumi.StringOutput `pulumi:"region"`
	// During resource destroy, remove Instance from StackSet while keeping the Stack and its associated resources. Must be enabled in the state _before_ destroy operation to take effect. You cannot reassociate a retained Stack or add an existing, saved Stack to a new StackSet. Defaults to `false`.
	RetainStack pulumi.BoolPtrOutput `pulumi:"retainStack"`
	// Stack identifier
	StackId pulumi.StringOutput `pulumi:"stackId"`
	// Name of the StackSet.
	StackSetName pulumi.StringOutput `pulumi:"stackSetName"`
}

Manages a CloudFormation StackSet Instance. Instances are managed in the account and region of the StackSet after the target account permissions have been configured. Additional information about StackSets can be found in the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/what-is-cfnstacksets.html).

> **NOTE:** All target accounts must have an IAM Role created that matches the name of the execution role configured in the StackSet (the `executionRoleName` argument in the `cloudformation.StackSet` resource) in a trust relationship with the administrative account or administration IAM Role. The execution role must have appropriate permissions to manage resources defined in the template along with those required for StackSets to operate. See the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-prereqs.html) for more details.

> **NOTE:** To retain the Stack during resource destroy, ensure `retainStack` has been set to `true` in the state first. This must be completed _before_ a deployment that would destroy the resource.

## Example Usage

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudformation.NewStackSetInstance(ctx, "example", &cloudformation.StackSetInstanceArgs{
			AccountId:    pulumi.String("123456789012"),
			Region:       pulumi.String("us-east-1"),
			StackSetName: pulumi.Any(aws_cloudformation_stack_set.Example.Name),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

``` ### Example IAM Setup in Target Account

```go package main

import (

"github.com/pulumi/pulumi/sdk/v3/go/pulumi" "github.com/pulumi/pulumi-aws/sdk/v5/go/aws/iam" ) func main() { pulumi.Run(func(ctx *pulumi.Context) error { aWSCloudFormationStackSetExecutionRoleAssumeRolePolicy, err := iam.GetPolicyDocument(ctx, &iam.GetPolicyDocumentArgs{ Statements: []iam.GetPolicyDocumentStatement{ { Actions: []string{ "sts:AssumeRole", }, Effect: pulumi.StringRef("Allow"), Principals: []iam.GetPolicyDocumentStatementPrincipal{ { Identifiers: interface{}{ aws_iam_role.AWSCloudFormationStackSetAdministrationRole.Arn, }, Type: "AWS", }, }, }, }, }, nil); if err != nil { return err } aWSCloudFormationStackSetExecutionRole, err := iam.NewRole(ctx, "aWSCloudFormationStackSetExecutionRole", &iam.RoleArgs{ AssumeRolePolicy: *pulumi.String(aWSCloudFormationStackSetExecutionRoleAssumeRolePolicy.Json), }) if err != nil { return err } aWSCloudFormationStackSetExecutionRoleMinimumExecutionPolicyPolicyDocument, err := iam.GetPolicyDocument(ctx, &iam.GetPolicyDocumentArgs{ Statements: []iam.GetPolicyDocumentStatement{ { Actions: []string{ "cloudformation:*", "s3:*", "sns:*", }, Effect: pulumi.StringRef("Allow"), Resources: []string{ "*", }, }, }, }, nil); if err != nil { return err } _, err = iam.NewRolePolicy(ctx, "aWSCloudFormationStackSetExecutionRoleMinimumExecutionPolicyRolePolicy", &iam.RolePolicyArgs{ Policy: *pulumi.String(aWSCloudFormationStackSetExecutionRoleMinimumExecutionPolicyPolicyDocument.Json), Role: aWSCloudFormationStackSetExecutionRole.Name, }) if err != nil { return err } return nil }) } ``` ### Example Deployment across Organizations account

```go package main

import (

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloudformation"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudformation.NewStackSetInstance(ctx, "example", &cloudformation.StackSetInstanceArgs{
			DeploymentTargets: &cloudformation.StackSetInstanceDeploymentTargetsArgs{
				OrganizationalUnitIds: pulumi.StringArray{
					aws_organizations_organization.Example.Roots[0].Id,
				},
			},
			Region:       pulumi.String("us-east-1"),
			StackSetName: pulumi.Any(aws_cloudformation_stack_set.Example.Name),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

CloudFormation StackSet Instances that target an AWS Account ID can be imported using the StackSet name, target AWS account ID, and target AWS region separated by commas (`,`) e.g.

```sh

$ pulumi import aws:cloudformation/stackSetInstance:StackSetInstance example example,123456789012,us-east-1

```

CloudFormation StackSet Instances that target AWS Organizational Units can be imported using the StackSet name, a slash (`/`) separated list of organizational unit IDs, and target AWS region separated by commas (`,`) e.g.

```sh

$ pulumi import aws:cloudformation/stackSetInstance:StackSetInstance example example,ou-sdas-123123123/ou-sdas-789789789,us-east-1

```

func GetStackSetInstance

func GetStackSetInstance(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *StackSetInstanceState, opts ...pulumi.ResourceOption) (*StackSetInstance, error)

GetStackSetInstance gets an existing StackSetInstance resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewStackSetInstance

func NewStackSetInstance(ctx *pulumi.Context,
	name string, args *StackSetInstanceArgs, opts ...pulumi.ResourceOption) (*StackSetInstance, error)

NewStackSetInstance registers a new resource with the given unique name, arguments, and options.

func (*StackSetInstance) ElementType

func (*StackSetInstance) ElementType() reflect.Type

func (*StackSetInstance) ToStackSetInstanceOutput

func (i *StackSetInstance) ToStackSetInstanceOutput() StackSetInstanceOutput

func (*StackSetInstance) ToStackSetInstanceOutputWithContext

func (i *StackSetInstance) ToStackSetInstanceOutputWithContext(ctx context.Context) StackSetInstanceOutput

type StackSetInstanceArgs

type StackSetInstanceArgs struct {
	// Target AWS Account ID to create a Stack based on the StackSet. Defaults to current account.
	AccountId pulumi.StringPtrInput
	// Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.
	CallAs pulumi.StringPtrInput
	// The AWS Organizations accounts to which StackSets deploys. StackSets doesn't deploy stack instances to the organization management account, even if the organization management account is in your organization or in an OU in your organization. Drift detection is not possible for this argument. See deploymentTargets below.
	DeploymentTargets StackSetInstanceDeploymentTargetsPtrInput
	// Preferences for how AWS CloudFormation performs a stack set operation.
	OperationPreferences StackSetInstanceOperationPreferencesPtrInput
	// Key-value map of input parameters to override from the StackSet for this Instance.
	ParameterOverrides pulumi.StringMapInput
	// Target AWS Region to create a Stack based on the StackSet. Defaults to current region.
	Region pulumi.StringPtrInput
	// During resource destroy, remove Instance from StackSet while keeping the Stack and its associated resources. Must be enabled in the state _before_ destroy operation to take effect. You cannot reassociate a retained Stack or add an existing, saved Stack to a new StackSet. Defaults to `false`.
	RetainStack pulumi.BoolPtrInput
	// Name of the StackSet.
	StackSetName pulumi.StringInput
}

The set of arguments for constructing a StackSetInstance resource.

func (StackSetInstanceArgs) ElementType

func (StackSetInstanceArgs) ElementType() reflect.Type

type StackSetInstanceArray

type StackSetInstanceArray []StackSetInstanceInput

func (StackSetInstanceArray) ElementType

func (StackSetInstanceArray) ElementType() reflect.Type

func (StackSetInstanceArray) ToStackSetInstanceArrayOutput

func (i StackSetInstanceArray) ToStackSetInstanceArrayOutput() StackSetInstanceArrayOutput

func (StackSetInstanceArray) ToStackSetInstanceArrayOutputWithContext

func (i StackSetInstanceArray) ToStackSetInstanceArrayOutputWithContext(ctx context.Context) StackSetInstanceArrayOutput

type StackSetInstanceArrayInput

type StackSetInstanceArrayInput interface {
	pulumi.Input

	ToStackSetInstanceArrayOutput() StackSetInstanceArrayOutput
	ToStackSetInstanceArrayOutputWithContext(context.Context) StackSetInstanceArrayOutput
}

StackSetInstanceArrayInput is an input type that accepts StackSetInstanceArray and StackSetInstanceArrayOutput values. You can construct a concrete instance of `StackSetInstanceArrayInput` via:

StackSetInstanceArray{ StackSetInstanceArgs{...} }

type StackSetInstanceArrayOutput

type StackSetInstanceArrayOutput struct{ *pulumi.OutputState }

func (StackSetInstanceArrayOutput) ElementType

func (StackSetInstanceArrayOutput) Index

func (StackSetInstanceArrayOutput) ToStackSetInstanceArrayOutput

func (o StackSetInstanceArrayOutput) ToStackSetInstanceArrayOutput() StackSetInstanceArrayOutput

func (StackSetInstanceArrayOutput) ToStackSetInstanceArrayOutputWithContext

func (o StackSetInstanceArrayOutput) ToStackSetInstanceArrayOutputWithContext(ctx context.Context) StackSetInstanceArrayOutput

type StackSetInstanceDeploymentTargets

type StackSetInstanceDeploymentTargets struct {
	// The organization root ID or organizational unit (OU) IDs to which StackSets deploys.
	OrganizationalUnitIds []string `pulumi:"organizationalUnitIds"`
}

type StackSetInstanceDeploymentTargetsArgs

type StackSetInstanceDeploymentTargetsArgs struct {
	// The organization root ID or organizational unit (OU) IDs to which StackSets deploys.
	OrganizationalUnitIds pulumi.StringArrayInput `pulumi:"organizationalUnitIds"`
}

func (StackSetInstanceDeploymentTargetsArgs) ElementType

func (StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsOutput

func (i StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsOutput() StackSetInstanceDeploymentTargetsOutput

func (StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsOutputWithContext

func (i StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsOutputWithContext(ctx context.Context) StackSetInstanceDeploymentTargetsOutput

func (StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsPtrOutput

func (i StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsPtrOutput() StackSetInstanceDeploymentTargetsPtrOutput

func (StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsPtrOutputWithContext

func (i StackSetInstanceDeploymentTargetsArgs) ToStackSetInstanceDeploymentTargetsPtrOutputWithContext(ctx context.Context) StackSetInstanceDeploymentTargetsPtrOutput

type StackSetInstanceDeploymentTargetsInput

type StackSetInstanceDeploymentTargetsInput interface {
	pulumi.Input

	ToStackSetInstanceDeploymentTargetsOutput() StackSetInstanceDeploymentTargetsOutput
	ToStackSetInstanceDeploymentTargetsOutputWithContext(context.Context) StackSetInstanceDeploymentTargetsOutput
}

StackSetInstanceDeploymentTargetsInput is an input type that accepts StackSetInstanceDeploymentTargetsArgs and StackSetInstanceDeploymentTargetsOutput values. You can construct a concrete instance of `StackSetInstanceDeploymentTargetsInput` via:

StackSetInstanceDeploymentTargetsArgs{...}

type StackSetInstanceDeploymentTargetsOutput

type StackSetInstanceDeploymentTargetsOutput struct{ *pulumi.OutputState }

func (StackSetInstanceDeploymentTargetsOutput) ElementType

func (StackSetInstanceDeploymentTargetsOutput) OrganizationalUnitIds

The organization root ID or organizational unit (OU) IDs to which StackSets deploys.

func (StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsOutput

func (o StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsOutput() StackSetInstanceDeploymentTargetsOutput

func (StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsOutputWithContext

func (o StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsOutputWithContext(ctx context.Context) StackSetInstanceDeploymentTargetsOutput

func (StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsPtrOutput

func (o StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsPtrOutput() StackSetInstanceDeploymentTargetsPtrOutput

func (StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsPtrOutputWithContext

func (o StackSetInstanceDeploymentTargetsOutput) ToStackSetInstanceDeploymentTargetsPtrOutputWithContext(ctx context.Context) StackSetInstanceDeploymentTargetsPtrOutput

type StackSetInstanceDeploymentTargetsPtrInput

type StackSetInstanceDeploymentTargetsPtrInput interface {
	pulumi.Input

	ToStackSetInstanceDeploymentTargetsPtrOutput() StackSetInstanceDeploymentTargetsPtrOutput
	ToStackSetInstanceDeploymentTargetsPtrOutputWithContext(context.Context) StackSetInstanceDeploymentTargetsPtrOutput
}

StackSetInstanceDeploymentTargetsPtrInput is an input type that accepts StackSetInstanceDeploymentTargetsArgs, StackSetInstanceDeploymentTargetsPtr and StackSetInstanceDeploymentTargetsPtrOutput values. You can construct a concrete instance of `StackSetInstanceDeploymentTargetsPtrInput` via:

        StackSetInstanceDeploymentTargetsArgs{...}

or:

        nil

type StackSetInstanceDeploymentTargetsPtrOutput

type StackSetInstanceDeploymentTargetsPtrOutput struct{ *pulumi.OutputState }

func (StackSetInstanceDeploymentTargetsPtrOutput) Elem

func (StackSetInstanceDeploymentTargetsPtrOutput) ElementType

func (StackSetInstanceDeploymentTargetsPtrOutput) OrganizationalUnitIds

The organization root ID or organizational unit (OU) IDs to which StackSets deploys.

func (StackSetInstanceDeploymentTargetsPtrOutput) ToStackSetInstanceDeploymentTargetsPtrOutput

func (o StackSetInstanceDeploymentTargetsPtrOutput) ToStackSetInstanceDeploymentTargetsPtrOutput() StackSetInstanceDeploymentTargetsPtrOutput

func (StackSetInstanceDeploymentTargetsPtrOutput) ToStackSetInstanceDeploymentTargetsPtrOutputWithContext

func (o StackSetInstanceDeploymentTargetsPtrOutput) ToStackSetInstanceDeploymentTargetsPtrOutputWithContext(ctx context.Context) StackSetInstanceDeploymentTargetsPtrOutput

type StackSetInstanceInput

type StackSetInstanceInput interface {
	pulumi.Input

	ToStackSetInstanceOutput() StackSetInstanceOutput
	ToStackSetInstanceOutputWithContext(ctx context.Context) StackSetInstanceOutput
}

type StackSetInstanceMap

type StackSetInstanceMap map[string]StackSetInstanceInput

func (StackSetInstanceMap) ElementType

func (StackSetInstanceMap) ElementType() reflect.Type

func (StackSetInstanceMap) ToStackSetInstanceMapOutput

func (i StackSetInstanceMap) ToStackSetInstanceMapOutput() StackSetInstanceMapOutput

func (StackSetInstanceMap) ToStackSetInstanceMapOutputWithContext

func (i StackSetInstanceMap) ToStackSetInstanceMapOutputWithContext(ctx context.Context) StackSetInstanceMapOutput

type StackSetInstanceMapInput

type StackSetInstanceMapInput interface {
	pulumi.Input

	ToStackSetInstanceMapOutput() StackSetInstanceMapOutput
	ToStackSetInstanceMapOutputWithContext(context.Context) StackSetInstanceMapOutput
}

StackSetInstanceMapInput is an input type that accepts StackSetInstanceMap and StackSetInstanceMapOutput values. You can construct a concrete instance of `StackSetInstanceMapInput` via:

StackSetInstanceMap{ "key": StackSetInstanceArgs{...} }

type StackSetInstanceMapOutput

type StackSetInstanceMapOutput struct{ *pulumi.OutputState }

func (StackSetInstanceMapOutput) ElementType

func (StackSetInstanceMapOutput) ElementType() reflect.Type

func (StackSetInstanceMapOutput) MapIndex

func (StackSetInstanceMapOutput) ToStackSetInstanceMapOutput

func (o StackSetInstanceMapOutput) ToStackSetInstanceMapOutput() StackSetInstanceMapOutput

func (StackSetInstanceMapOutput) ToStackSetInstanceMapOutputWithContext

func (o StackSetInstanceMapOutput) ToStackSetInstanceMapOutputWithContext(ctx context.Context) StackSetInstanceMapOutput

type StackSetInstanceOperationPreferences added in v5.2.0

type StackSetInstanceOperationPreferences struct {
	// The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureToleranceCount *int `pulumi:"failureToleranceCount"`
	// The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureTolerancePercentage *int `pulumi:"failureTolerancePercentage"`
	// The maximum number of accounts in which to perform this operation at one time.
	MaxConcurrentCount *int `pulumi:"maxConcurrentCount"`
	// The maximum percentage of accounts in which to perform this operation at one time.
	MaxConcurrentPercentage *int `pulumi:"maxConcurrentPercentage"`
	// The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time. Valid values are `SEQUENTIAL` and `PARALLEL`.
	RegionConcurrencyType *string `pulumi:"regionConcurrencyType"`
	// The order of the Regions in where you want to perform the stack operation.
	RegionOrders []string `pulumi:"regionOrders"`
}

type StackSetInstanceOperationPreferencesArgs added in v5.2.0

type StackSetInstanceOperationPreferencesArgs struct {
	// The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureToleranceCount pulumi.IntPtrInput `pulumi:"failureToleranceCount"`
	// The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureTolerancePercentage pulumi.IntPtrInput `pulumi:"failureTolerancePercentage"`
	// The maximum number of accounts in which to perform this operation at one time.
	MaxConcurrentCount pulumi.IntPtrInput `pulumi:"maxConcurrentCount"`
	// The maximum percentage of accounts in which to perform this operation at one time.
	MaxConcurrentPercentage pulumi.IntPtrInput `pulumi:"maxConcurrentPercentage"`
	// The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time. Valid values are `SEQUENTIAL` and `PARALLEL`.
	RegionConcurrencyType pulumi.StringPtrInput `pulumi:"regionConcurrencyType"`
	// The order of the Regions in where you want to perform the stack operation.
	RegionOrders pulumi.StringArrayInput `pulumi:"regionOrders"`
}

func (StackSetInstanceOperationPreferencesArgs) ElementType added in v5.2.0

func (StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesOutput added in v5.2.0

func (i StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesOutput() StackSetInstanceOperationPreferencesOutput

func (StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesOutputWithContext added in v5.2.0

func (i StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesOutputWithContext(ctx context.Context) StackSetInstanceOperationPreferencesOutput

func (StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesPtrOutput added in v5.2.0

func (i StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesPtrOutput() StackSetInstanceOperationPreferencesPtrOutput

func (StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesPtrOutputWithContext added in v5.2.0

func (i StackSetInstanceOperationPreferencesArgs) ToStackSetInstanceOperationPreferencesPtrOutputWithContext(ctx context.Context) StackSetInstanceOperationPreferencesPtrOutput

type StackSetInstanceOperationPreferencesInput added in v5.2.0

type StackSetInstanceOperationPreferencesInput interface {
	pulumi.Input

	ToStackSetInstanceOperationPreferencesOutput() StackSetInstanceOperationPreferencesOutput
	ToStackSetInstanceOperationPreferencesOutputWithContext(context.Context) StackSetInstanceOperationPreferencesOutput
}

StackSetInstanceOperationPreferencesInput is an input type that accepts StackSetInstanceOperationPreferencesArgs and StackSetInstanceOperationPreferencesOutput values. You can construct a concrete instance of `StackSetInstanceOperationPreferencesInput` via:

StackSetInstanceOperationPreferencesArgs{...}

type StackSetInstanceOperationPreferencesOutput added in v5.2.0

type StackSetInstanceOperationPreferencesOutput struct{ *pulumi.OutputState }

func (StackSetInstanceOperationPreferencesOutput) ElementType added in v5.2.0

func (StackSetInstanceOperationPreferencesOutput) FailureToleranceCount added in v5.2.0

The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetInstanceOperationPreferencesOutput) FailureTolerancePercentage added in v5.2.0

func (o StackSetInstanceOperationPreferencesOutput) FailureTolerancePercentage() pulumi.IntPtrOutput

The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetInstanceOperationPreferencesOutput) MaxConcurrentCount added in v5.2.0

The maximum number of accounts in which to perform this operation at one time.

func (StackSetInstanceOperationPreferencesOutput) MaxConcurrentPercentage added in v5.2.0

The maximum percentage of accounts in which to perform this operation at one time.

func (StackSetInstanceOperationPreferencesOutput) RegionConcurrencyType added in v5.2.0

The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time. Valid values are `SEQUENTIAL` and `PARALLEL`.

func (StackSetInstanceOperationPreferencesOutput) RegionOrders added in v5.2.0

The order of the Regions in where you want to perform the stack operation.

func (StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesOutput added in v5.2.0

func (o StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesOutput() StackSetInstanceOperationPreferencesOutput

func (StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesOutputWithContext added in v5.2.0

func (o StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesOutputWithContext(ctx context.Context) StackSetInstanceOperationPreferencesOutput

func (StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesPtrOutput added in v5.2.0

func (o StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesPtrOutput() StackSetInstanceOperationPreferencesPtrOutput

func (StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesPtrOutputWithContext added in v5.2.0

func (o StackSetInstanceOperationPreferencesOutput) ToStackSetInstanceOperationPreferencesPtrOutputWithContext(ctx context.Context) StackSetInstanceOperationPreferencesPtrOutput

type StackSetInstanceOperationPreferencesPtrInput added in v5.2.0

type StackSetInstanceOperationPreferencesPtrInput interface {
	pulumi.Input

	ToStackSetInstanceOperationPreferencesPtrOutput() StackSetInstanceOperationPreferencesPtrOutput
	ToStackSetInstanceOperationPreferencesPtrOutputWithContext(context.Context) StackSetInstanceOperationPreferencesPtrOutput
}

StackSetInstanceOperationPreferencesPtrInput is an input type that accepts StackSetInstanceOperationPreferencesArgs, StackSetInstanceOperationPreferencesPtr and StackSetInstanceOperationPreferencesPtrOutput values. You can construct a concrete instance of `StackSetInstanceOperationPreferencesPtrInput` via:

        StackSetInstanceOperationPreferencesArgs{...}

or:

        nil

type StackSetInstanceOperationPreferencesPtrOutput added in v5.2.0

type StackSetInstanceOperationPreferencesPtrOutput struct{ *pulumi.OutputState }

func (StackSetInstanceOperationPreferencesPtrOutput) Elem added in v5.2.0

func (StackSetInstanceOperationPreferencesPtrOutput) ElementType added in v5.2.0

func (StackSetInstanceOperationPreferencesPtrOutput) FailureToleranceCount added in v5.2.0

The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetInstanceOperationPreferencesPtrOutput) FailureTolerancePercentage added in v5.2.0

func (o StackSetInstanceOperationPreferencesPtrOutput) FailureTolerancePercentage() pulumi.IntPtrOutput

The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetInstanceOperationPreferencesPtrOutput) MaxConcurrentCount added in v5.2.0

The maximum number of accounts in which to perform this operation at one time.

func (StackSetInstanceOperationPreferencesPtrOutput) MaxConcurrentPercentage added in v5.2.0

The maximum percentage of accounts in which to perform this operation at one time.

func (StackSetInstanceOperationPreferencesPtrOutput) RegionConcurrencyType added in v5.2.0

The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time. Valid values are `SEQUENTIAL` and `PARALLEL`.

func (StackSetInstanceOperationPreferencesPtrOutput) RegionOrders added in v5.2.0

The order of the Regions in where you want to perform the stack operation.

func (StackSetInstanceOperationPreferencesPtrOutput) ToStackSetInstanceOperationPreferencesPtrOutput added in v5.2.0

func (o StackSetInstanceOperationPreferencesPtrOutput) ToStackSetInstanceOperationPreferencesPtrOutput() StackSetInstanceOperationPreferencesPtrOutput

func (StackSetInstanceOperationPreferencesPtrOutput) ToStackSetInstanceOperationPreferencesPtrOutputWithContext added in v5.2.0

func (o StackSetInstanceOperationPreferencesPtrOutput) ToStackSetInstanceOperationPreferencesPtrOutputWithContext(ctx context.Context) StackSetInstanceOperationPreferencesPtrOutput

type StackSetInstanceOutput

type StackSetInstanceOutput struct{ *pulumi.OutputState }

func (StackSetInstanceOutput) AccountId added in v5.4.0

Target AWS Account ID to create a Stack based on the StackSet. Defaults to current account.

func (StackSetInstanceOutput) CallAs added in v5.4.0

Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.

func (StackSetInstanceOutput) DeploymentTargets added in v5.4.0

The AWS Organizations accounts to which StackSets deploys. StackSets doesn't deploy stack instances to the organization management account, even if the organization management account is in your organization or in an OU in your organization. Drift detection is not possible for this argument. See deploymentTargets below.

func (StackSetInstanceOutput) ElementType

func (StackSetInstanceOutput) ElementType() reflect.Type

func (StackSetInstanceOutput) OperationPreferences added in v5.4.0

Preferences for how AWS CloudFormation performs a stack set operation.

func (StackSetInstanceOutput) OrganizationalUnitId added in v5.4.0

func (o StackSetInstanceOutput) OrganizationalUnitId() pulumi.StringOutput

The organization root ID or organizational unit (OU) IDs specified for `deploymentTargets`.

func (StackSetInstanceOutput) ParameterOverrides added in v5.4.0

func (o StackSetInstanceOutput) ParameterOverrides() pulumi.StringMapOutput

Key-value map of input parameters to override from the StackSet for this Instance.

func (StackSetInstanceOutput) Region added in v5.4.0

Target AWS Region to create a Stack based on the StackSet. Defaults to current region.

func (StackSetInstanceOutput) RetainStack added in v5.4.0

During resource destroy, remove Instance from StackSet while keeping the Stack and its associated resources. Must be enabled in the state _before_ destroy operation to take effect. You cannot reassociate a retained Stack or add an existing, saved Stack to a new StackSet. Defaults to `false`.

func (StackSetInstanceOutput) StackId added in v5.4.0

Stack identifier

func (StackSetInstanceOutput) StackSetName added in v5.4.0

func (o StackSetInstanceOutput) StackSetName() pulumi.StringOutput

Name of the StackSet.

func (StackSetInstanceOutput) ToStackSetInstanceOutput

func (o StackSetInstanceOutput) ToStackSetInstanceOutput() StackSetInstanceOutput

func (StackSetInstanceOutput) ToStackSetInstanceOutputWithContext

func (o StackSetInstanceOutput) ToStackSetInstanceOutputWithContext(ctx context.Context) StackSetInstanceOutput

type StackSetInstanceState

type StackSetInstanceState struct {
	// Target AWS Account ID to create a Stack based on the StackSet. Defaults to current account.
	AccountId pulumi.StringPtrInput
	// Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.
	CallAs pulumi.StringPtrInput
	// The AWS Organizations accounts to which StackSets deploys. StackSets doesn't deploy stack instances to the organization management account, even if the organization management account is in your organization or in an OU in your organization. Drift detection is not possible for this argument. See deploymentTargets below.
	DeploymentTargets StackSetInstanceDeploymentTargetsPtrInput
	// Preferences for how AWS CloudFormation performs a stack set operation.
	OperationPreferences StackSetInstanceOperationPreferencesPtrInput
	// The organization root ID or organizational unit (OU) IDs specified for `deploymentTargets`.
	OrganizationalUnitId pulumi.StringPtrInput
	// Key-value map of input parameters to override from the StackSet for this Instance.
	ParameterOverrides pulumi.StringMapInput
	// Target AWS Region to create a Stack based on the StackSet. Defaults to current region.
	Region pulumi.StringPtrInput
	// During resource destroy, remove Instance from StackSet while keeping the Stack and its associated resources. Must be enabled in the state _before_ destroy operation to take effect. You cannot reassociate a retained Stack or add an existing, saved Stack to a new StackSet. Defaults to `false`.
	RetainStack pulumi.BoolPtrInput
	// Stack identifier
	StackId pulumi.StringPtrInput
	// Name of the StackSet.
	StackSetName pulumi.StringPtrInput
}

func (StackSetInstanceState) ElementType

func (StackSetInstanceState) ElementType() reflect.Type

type StackSetMap

type StackSetMap map[string]StackSetInput

func (StackSetMap) ElementType

func (StackSetMap) ElementType() reflect.Type

func (StackSetMap) ToStackSetMapOutput

func (i StackSetMap) ToStackSetMapOutput() StackSetMapOutput

func (StackSetMap) ToStackSetMapOutputWithContext

func (i StackSetMap) ToStackSetMapOutputWithContext(ctx context.Context) StackSetMapOutput

type StackSetMapInput

type StackSetMapInput interface {
	pulumi.Input

	ToStackSetMapOutput() StackSetMapOutput
	ToStackSetMapOutputWithContext(context.Context) StackSetMapOutput
}

StackSetMapInput is an input type that accepts StackSetMap and StackSetMapOutput values. You can construct a concrete instance of `StackSetMapInput` via:

StackSetMap{ "key": StackSetArgs{...} }

type StackSetMapOutput

type StackSetMapOutput struct{ *pulumi.OutputState }

func (StackSetMapOutput) ElementType

func (StackSetMapOutput) ElementType() reflect.Type

func (StackSetMapOutput) MapIndex

func (StackSetMapOutput) ToStackSetMapOutput

func (o StackSetMapOutput) ToStackSetMapOutput() StackSetMapOutput

func (StackSetMapOutput) ToStackSetMapOutputWithContext

func (o StackSetMapOutput) ToStackSetMapOutputWithContext(ctx context.Context) StackSetMapOutput

type StackSetOperationPreferences added in v5.2.0

type StackSetOperationPreferences struct {
	// The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureToleranceCount *int `pulumi:"failureToleranceCount"`
	// The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureTolerancePercentage *int `pulumi:"failureTolerancePercentage"`
	// The maximum number of accounts in which to perform this operation at one time.
	MaxConcurrentCount *int `pulumi:"maxConcurrentCount"`
	// The maximum percentage of accounts in which to perform this operation at one time.
	MaxConcurrentPercentage *int `pulumi:"maxConcurrentPercentage"`
	// The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time.
	RegionConcurrencyType *string `pulumi:"regionConcurrencyType"`
	// The order of the Regions in where you want to perform the stack operation.
	RegionOrders []string `pulumi:"regionOrders"`
}

type StackSetOperationPreferencesArgs added in v5.2.0

type StackSetOperationPreferencesArgs struct {
	// The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureToleranceCount pulumi.IntPtrInput `pulumi:"failureToleranceCount"`
	// The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.
	FailureTolerancePercentage pulumi.IntPtrInput `pulumi:"failureTolerancePercentage"`
	// The maximum number of accounts in which to perform this operation at one time.
	MaxConcurrentCount pulumi.IntPtrInput `pulumi:"maxConcurrentCount"`
	// The maximum percentage of accounts in which to perform this operation at one time.
	MaxConcurrentPercentage pulumi.IntPtrInput `pulumi:"maxConcurrentPercentage"`
	// The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time.
	RegionConcurrencyType pulumi.StringPtrInput `pulumi:"regionConcurrencyType"`
	// The order of the Regions in where you want to perform the stack operation.
	RegionOrders pulumi.StringArrayInput `pulumi:"regionOrders"`
}

func (StackSetOperationPreferencesArgs) ElementType added in v5.2.0

func (StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesOutput added in v5.2.0

func (i StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesOutput() StackSetOperationPreferencesOutput

func (StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesOutputWithContext added in v5.2.0

func (i StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesOutputWithContext(ctx context.Context) StackSetOperationPreferencesOutput

func (StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesPtrOutput added in v5.2.0

func (i StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesPtrOutput() StackSetOperationPreferencesPtrOutput

func (StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesPtrOutputWithContext added in v5.2.0

func (i StackSetOperationPreferencesArgs) ToStackSetOperationPreferencesPtrOutputWithContext(ctx context.Context) StackSetOperationPreferencesPtrOutput

type StackSetOperationPreferencesInput added in v5.2.0

type StackSetOperationPreferencesInput interface {
	pulumi.Input

	ToStackSetOperationPreferencesOutput() StackSetOperationPreferencesOutput
	ToStackSetOperationPreferencesOutputWithContext(context.Context) StackSetOperationPreferencesOutput
}

StackSetOperationPreferencesInput is an input type that accepts StackSetOperationPreferencesArgs and StackSetOperationPreferencesOutput values. You can construct a concrete instance of `StackSetOperationPreferencesInput` via:

StackSetOperationPreferencesArgs{...}

type StackSetOperationPreferencesOutput added in v5.2.0

type StackSetOperationPreferencesOutput struct{ *pulumi.OutputState }

func (StackSetOperationPreferencesOutput) ElementType added in v5.2.0

func (StackSetOperationPreferencesOutput) FailureToleranceCount added in v5.2.0

func (o StackSetOperationPreferencesOutput) FailureToleranceCount() pulumi.IntPtrOutput

The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetOperationPreferencesOutput) FailureTolerancePercentage added in v5.2.0

func (o StackSetOperationPreferencesOutput) FailureTolerancePercentage() pulumi.IntPtrOutput

The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetOperationPreferencesOutput) MaxConcurrentCount added in v5.2.0

The maximum number of accounts in which to perform this operation at one time.

func (StackSetOperationPreferencesOutput) MaxConcurrentPercentage added in v5.2.0

func (o StackSetOperationPreferencesOutput) MaxConcurrentPercentage() pulumi.IntPtrOutput

The maximum percentage of accounts in which to perform this operation at one time.

func (StackSetOperationPreferencesOutput) RegionConcurrencyType added in v5.2.0

func (o StackSetOperationPreferencesOutput) RegionConcurrencyType() pulumi.StringPtrOutput

The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time.

func (StackSetOperationPreferencesOutput) RegionOrders added in v5.2.0

The order of the Regions in where you want to perform the stack operation.

func (StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesOutput added in v5.2.0

func (o StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesOutput() StackSetOperationPreferencesOutput

func (StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesOutputWithContext added in v5.2.0

func (o StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesOutputWithContext(ctx context.Context) StackSetOperationPreferencesOutput

func (StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesPtrOutput added in v5.2.0

func (o StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesPtrOutput() StackSetOperationPreferencesPtrOutput

func (StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesPtrOutputWithContext added in v5.2.0

func (o StackSetOperationPreferencesOutput) ToStackSetOperationPreferencesPtrOutputWithContext(ctx context.Context) StackSetOperationPreferencesPtrOutput

type StackSetOperationPreferencesPtrInput added in v5.2.0

type StackSetOperationPreferencesPtrInput interface {
	pulumi.Input

	ToStackSetOperationPreferencesPtrOutput() StackSetOperationPreferencesPtrOutput
	ToStackSetOperationPreferencesPtrOutputWithContext(context.Context) StackSetOperationPreferencesPtrOutput
}

StackSetOperationPreferencesPtrInput is an input type that accepts StackSetOperationPreferencesArgs, StackSetOperationPreferencesPtr and StackSetOperationPreferencesPtrOutput values. You can construct a concrete instance of `StackSetOperationPreferencesPtrInput` via:

        StackSetOperationPreferencesArgs{...}

or:

        nil

type StackSetOperationPreferencesPtrOutput added in v5.2.0

type StackSetOperationPreferencesPtrOutput struct{ *pulumi.OutputState }

func (StackSetOperationPreferencesPtrOutput) Elem added in v5.2.0

func (StackSetOperationPreferencesPtrOutput) ElementType added in v5.2.0

func (StackSetOperationPreferencesPtrOutput) FailureToleranceCount added in v5.2.0

func (o StackSetOperationPreferencesPtrOutput) FailureToleranceCount() pulumi.IntPtrOutput

The number of accounts, per Region, for which this operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetOperationPreferencesPtrOutput) FailureTolerancePercentage added in v5.2.0

func (o StackSetOperationPreferencesPtrOutput) FailureTolerancePercentage() pulumi.IntPtrOutput

The percentage of accounts, per Region, for which this stack operation can fail before AWS CloudFormation stops the operation in that Region.

func (StackSetOperationPreferencesPtrOutput) MaxConcurrentCount added in v5.2.0

The maximum number of accounts in which to perform this operation at one time.

func (StackSetOperationPreferencesPtrOutput) MaxConcurrentPercentage added in v5.2.0

func (o StackSetOperationPreferencesPtrOutput) MaxConcurrentPercentage() pulumi.IntPtrOutput

The maximum percentage of accounts in which to perform this operation at one time.

func (StackSetOperationPreferencesPtrOutput) RegionConcurrencyType added in v5.2.0

The concurrency type of deploying StackSets operations in Regions, could be in parallel or one Region at a time.

func (StackSetOperationPreferencesPtrOutput) RegionOrders added in v5.2.0

The order of the Regions in where you want to perform the stack operation.

func (StackSetOperationPreferencesPtrOutput) ToStackSetOperationPreferencesPtrOutput added in v5.2.0

func (o StackSetOperationPreferencesPtrOutput) ToStackSetOperationPreferencesPtrOutput() StackSetOperationPreferencesPtrOutput

func (StackSetOperationPreferencesPtrOutput) ToStackSetOperationPreferencesPtrOutputWithContext added in v5.2.0

func (o StackSetOperationPreferencesPtrOutput) ToStackSetOperationPreferencesPtrOutputWithContext(ctx context.Context) StackSetOperationPreferencesPtrOutput

type StackSetOutput

type StackSetOutput struct{ *pulumi.OutputState }

func (StackSetOutput) AdministrationRoleArn added in v5.4.0

func (o StackSetOutput) AdministrationRoleArn() pulumi.StringPtrOutput

Amazon Resource Number (ARN) of the IAM Role in the administrator account. This must be defined when using the `SELF_MANAGED` permission model.

func (StackSetOutput) Arn added in v5.4.0

Amazon Resource Name (ARN) of the StackSet.

func (StackSetOutput) AutoDeployment added in v5.4.0

Configuration block containing the auto-deployment model for your StackSet. This can only be defined when using the `SERVICE_MANAGED` permission model.

func (StackSetOutput) CallAs added in v5.4.0

Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.

func (StackSetOutput) Capabilities added in v5.4.0

func (o StackSetOutput) Capabilities() pulumi.StringArrayOutput

A list of capabilities. Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, `CAPABILITY_AUTO_EXPAND`.

func (StackSetOutput) Description added in v5.4.0

func (o StackSetOutput) Description() pulumi.StringPtrOutput

Description of the StackSet.

func (StackSetOutput) ElementType

func (StackSetOutput) ElementType() reflect.Type

func (StackSetOutput) ExecutionRoleName added in v5.4.0

func (o StackSetOutput) ExecutionRoleName() pulumi.StringOutput

Name of the IAM Role in all target accounts for StackSet operations. Defaults to `AWSCloudFormationStackSetExecutionRole` when using the `SELF_MANAGED` permission model. This should not be defined when using the `SERVICE_MANAGED` permission model.

func (StackSetOutput) Name added in v5.4.0

Name of the StackSet. The name must be unique in the region where you create your StackSet. The name can contain only alphanumeric characters (case-sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 128 characters.

func (StackSetOutput) OperationPreferences added in v5.4.0

func (o StackSetOutput) OperationPreferences() StackSetOperationPreferencesPtrOutput

Preferences for how AWS CloudFormation performs a stack set update.

func (StackSetOutput) Parameters added in v5.4.0

func (o StackSetOutput) Parameters() pulumi.StringMapOutput

Key-value map of input parameters for the StackSet template. All template parameters, including those with a `Default`, must be configured or ignored with `lifecycle` configuration block `ignoreChanges` argument. All `NoEcho` template parameters must be ignored with the `lifecycle` configuration block `ignoreChanges` argument.

func (StackSetOutput) PermissionModel added in v5.4.0

func (o StackSetOutput) PermissionModel() pulumi.StringPtrOutput

Describes how the IAM roles required for your StackSet are created. Valid values: `SELF_MANAGED` (default), `SERVICE_MANAGED`.

func (StackSetOutput) StackSetId added in v5.4.0

func (o StackSetOutput) StackSetId() pulumi.StringOutput

Unique identifier of the StackSet.

func (StackSetOutput) Tags added in v5.4.0

Key-value map of tags to associate with this StackSet and the Stacks created from it. AWS CloudFormation also propagates these tags to supported resources that are created in the Stacks. A maximum number of 50 tags can be specified. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.

func (StackSetOutput) TagsAll added in v5.4.0

A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.

func (StackSetOutput) TemplateBody added in v5.4.0

func (o StackSetOutput) TemplateBody() pulumi.StringOutput

String containing the CloudFormation template body. Maximum size: 51,200 bytes. Conflicts with `templateUrl`.

func (StackSetOutput) TemplateUrl added in v5.4.0

func (o StackSetOutput) TemplateUrl() pulumi.StringPtrOutput

String containing the location of a file containing the CloudFormation template body. The URL must point to a template that is located in an Amazon S3 bucket. Maximum location file size: 460,800 bytes. Conflicts with `templateBody`.

func (StackSetOutput) ToStackSetOutput

func (o StackSetOutput) ToStackSetOutput() StackSetOutput

func (StackSetOutput) ToStackSetOutputWithContext

func (o StackSetOutput) ToStackSetOutputWithContext(ctx context.Context) StackSetOutput

type StackSetState

type StackSetState struct {
	// Amazon Resource Number (ARN) of the IAM Role in the administrator account. This must be defined when using the `SELF_MANAGED` permission model.
	AdministrationRoleArn pulumi.StringPtrInput
	// Amazon Resource Name (ARN) of the StackSet.
	Arn pulumi.StringPtrInput
	// Configuration block containing the auto-deployment model for your StackSet. This can only be defined when using the `SERVICE_MANAGED` permission model.
	AutoDeployment StackSetAutoDeploymentPtrInput
	// Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account. Valid values: `SELF` (default), `DELEGATED_ADMIN`.
	CallAs pulumi.StringPtrInput
	// A list of capabilities. Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, `CAPABILITY_AUTO_EXPAND`.
	Capabilities pulumi.StringArrayInput
	// Description of the StackSet.
	Description pulumi.StringPtrInput
	// Name of the IAM Role in all target accounts for StackSet operations. Defaults to `AWSCloudFormationStackSetExecutionRole` when using the `SELF_MANAGED` permission model. This should not be defined when using the `SERVICE_MANAGED` permission model.
	ExecutionRoleName pulumi.StringPtrInput
	// Name of the StackSet. The name must be unique in the region where you create your StackSet. The name can contain only alphanumeric characters (case-sensitive) and hyphens. It must start with an alphabetic character and cannot be longer than 128 characters.
	Name pulumi.StringPtrInput
	// Preferences for how AWS CloudFormation performs a stack set update.
	OperationPreferences StackSetOperationPreferencesPtrInput
	// Key-value map of input parameters for the StackSet template. All template parameters, including those with a `Default`, must be configured or ignored with `lifecycle` configuration block `ignoreChanges` argument. All `NoEcho` template parameters must be ignored with the `lifecycle` configuration block `ignoreChanges` argument.
	Parameters pulumi.StringMapInput
	// Describes how the IAM roles required for your StackSet are created. Valid values: `SELF_MANAGED` (default), `SERVICE_MANAGED`.
	PermissionModel pulumi.StringPtrInput
	// Unique identifier of the StackSet.
	StackSetId pulumi.StringPtrInput
	// Key-value map of tags to associate with this StackSet and the Stacks created from it. AWS CloudFormation also propagates these tags to supported resources that are created in the Stacks. A maximum number of 50 tags can be specified. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapInput
	// String containing the CloudFormation template body. Maximum size: 51,200 bytes. Conflicts with `templateUrl`.
	TemplateBody pulumi.StringPtrInput
	// String containing the location of a file containing the CloudFormation template body. The URL must point to a template that is located in an Amazon S3 bucket. Maximum location file size: 460,800 bytes. Conflicts with `templateBody`.
	TemplateUrl pulumi.StringPtrInput
}

func (StackSetState) ElementType

func (StackSetState) ElementType() reflect.Type

type StackState

type StackState struct {
	// A list of capabilities.
	// Valid values: `CAPABILITY_IAM`, `CAPABILITY_NAMED_IAM`, or `CAPABILITY_AUTO_EXPAND`
	Capabilities pulumi.StringArrayInput
	// Set to true to disable rollback of the stack if stack creation failed.
	// Conflicts with `onFailure`.
	DisableRollback pulumi.BoolPtrInput
	// The ARN of an IAM role that AWS CloudFormation assumes to create the stack. If you don't specify a value, AWS CloudFormation uses the role that was previously associated with the stack. If no role is available, AWS CloudFormation uses a temporary session that is generated from your user credentials.
	IamRoleArn pulumi.StringPtrInput
	// Stack name.
	Name pulumi.StringPtrInput
	// A list of SNS topic ARNs to publish stack related events.
	NotificationArns pulumi.StringArrayInput
	// Action to be taken if stack creation fails. This must be
	// one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. Conflicts with `disableRollback`.
	OnFailure pulumi.StringPtrInput
	// A map of outputs from the stack.
	Outputs pulumi.StringMapInput
	// A map of Parameter structures that specify input parameters for the stack.
	Parameters pulumi.StringMapInput
	// Structure containing the stack policy body.
	// Conflicts w/ `policyUrl`.
	PolicyBody pulumi.StringPtrInput
	// Location of a file containing the stack policy.
	// Conflicts w/ `policyBody`.
	PolicyUrl pulumi.StringPtrInput
	// Map of resource tags to associate with this stack. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapInput
	// Structure containing the template body (max size: 51,200 bytes).
	TemplateBody pulumi.StringPtrInput
	// Location of a file containing the template body (max size: 460,800 bytes).
	TemplateUrl pulumi.StringPtrInput
	// The amount of time that can pass before the stack status becomes `CREATE_FAILED`.
	TimeoutInMinutes pulumi.IntPtrInput
}

func (StackState) ElementType

func (StackState) ElementType() reflect.Type

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL