aws_cloudformation_stack

Provides a CloudFormation Stack resource.

Example Usage

resource "aws_cloudformation_stack" "network" {
  name = "networking-stack"

  parameters {
    VPCCidr = "10.0.0.0/16"
  }

  template_body = <<STACK
{
  "Parameters" : {
    "VPCCidr" : {
      "Type" : "String",
      "Default" : "10.0.0.0/16",
      "Description" : "Enter the CIDR block for the VPC. Default is 10.0.0.0/16."
    }
  },
  "Resources" : {
    "my-vpc": {
      "Type" : "AWS::EC2::VPC",
      "Properties" : {
        "CidrBlock" : { "Ref" : "VPCCidr" },
        "Tags" : [
          {"Key": "Name", "Value": "Primary_CF_VPC"}
        ]
      }
    }
  }
}
STACK
}

Argument Reference

The following arguments are supported:

• name - (Required) Stack name.
• template_body - (Optional) Structure containing the template body (max size: 51,200 bytes).
• template_url - (Optional) Location of a file containing the template body (max size: 460,800 bytes).
• capabilities - (Optional) A list of capabilities. Valid values: CAPABILITY_IAM or CAPABILITY_NAMED_IAM
• disable_rollback - (Optional) Set to true to disable rollback of the stack if stack creation failed. Conflicts with on_failure.
• notification_arns - (Optional) A list of SNS topic ARNs to publish stack related events.
• on_failure - (Optional) Action to be taken if stack creation fails. This must be one of: DO_NOTHING, ROLLBACK, or DELETE. Conflicts with disable_rollback.
• parameters - (Optional) A list of Parameter structures that specify input parameters for the stack.
• policy_body - (Optional) Structure containing the stack policy body. Conflicts w/ policy_url.
• policy_url - (Optional) Location of a file containing the stack policy. Conflicts w/ policy_body.
• tags - (Optional) A list of tags to associate with this stack.
• iam_role_arn - (Optional) 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.
• timeout_in_minutes - (Optional) The amount of time that can pass before the stack status becomes CREATE_FAILED.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

• id - A unique identifier of the stack.
• outputs - A map of outputs from the stack.

Import

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

$ terraform import aws_cloudformation_stack.stack networking-stack

Timeouts

aws_cloudformation_stack provides the following Timeouts configuration options:

• create - (Default 30 minutes) Used for Creating Stacks
• update - (Default 30 minutes) Used for Stack modifications
• delete - (Default 30 minutes) Used for destroying stacks.