AWS::CloudFormation::Stack

CloudFormation Stack

The AWS::CloudFormation::Stack resource nests a stack as a resource in a top-level template.

Properties

15 configurable properties. 1 required. Click a row to see details.

Filter:

Property	Type	Flags
`StackName`	`string`	RequiredCreate-only
`Capabilities`	`Array<string>`
`Description`	`string`
`DisableRollback`	`boolean`
`EnableTerminationProtection`	`boolean`
`NotificationARNs`	`Array<string>`
`Parameters`	`object`
`RoleARN`	`string`
`StackPolicyBody`	`object`
`StackPolicyURL`	`string`	Write-only
`StackStatusReason`	`string`
`Tags`	`Array<Tag>`
`TemplateBody`	`objectstring`
`TemplateURL`	`string`	Write-only
`TimeoutInMinutes`	`integer`

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

Attribute	Type	Description
`ChangeSetId`	`string`	-
`CreationTime`	`string`	-
`LastUpdateTime`	`string`	-
`Outputs`	`Array<Output>`	-
`ParentId`	`string`	-
`RootId`	`string`	-
`StackId`	`string`	-
`StackStatus`	`string`	-

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml

AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::CloudFormation::Stack

Resources:
  MyResource:
    Type: AWS::CloudFormation::Stack
    Properties:
      StackName: "my-stackname"
      Tags:
        - Key: Environment
          Value: Production
      Description: !Ref "AWS::StackName"

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

cloudformation:DescribeStackscloudformation:CreateStackiam:PassRole

update

cloudformation:DescribeStackscloudformation:UpdateStackcloudformation:UpdateTerminationProtectioncloudformation:SetStackPolicyiam:PassRole

delete

cloudformation:DescribeStackscloudformation:DeleteStack

read

cloudformation:DescribeStackscloudformation:GetStackPolicycloudformation:GetTemplate

list

cloudformation:ListStacks

Get the CloudFormation Cheat Sheet

Everything you need to know about CloudFormation on one page. HD quality, print-friendly.

Download Free Infographic

Quick Facts

ServiceCloudFormation

Properties23

Required1

TaggingSupported

Primary IDStackId

Supported Operations

CreateUpdateDeleteReadList

Immutable After Creation

These properties cannot be changed after the resource is created. Updating them triggers a replacement.

StackName

Related Resources

External Links

AWS Documentation