github.com/jmbataller/terraform@v0.6.8-0.20151125192640-b7a12e3a580c/website/source/docs/providers/aws/r/cloudformation_stack.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_cloudformation_stack"
     4  sidebar_current: "docs-aws-resource-cloudformation-stack"
     5  description: |-
     6    Provides a CloudFormation Stack resource.
     7  ---
     8  
     9  # aws\_cloudformation\_stack
    10  
    11  Provides a CloudFormation Stack resource.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "aws_cloudformation_stack" "network" {
    17    name = "networking-stack"
    18    template_body = <<STACK
    19  {
    20    "Resources" : {
    21      "my-vpc": {
    22        "Type" : "AWS::EC2::VPC",
    23        "Properties" : {
    24          "CidrBlock" : "10.0.0.0/16",
    25          "Tags" : [
    26            {"Key": "Name", "Value": "Primary_CF_VPC"}
    27          ]
    28        }
    29      }
    30    }
    31  }
    32  STACK
    33  }
    34  ```
    35  
    36  ## Argument Reference
    37  
    38  The following arguments are supported:
    39  
    40  * `name` - (Required) Stack name.
    41  * `template_body` - (Optional) Structure containing the template body (max size: 51,200 bytes).
    42  * `template_url` - (Optional) Location of a file containing the template body (max size: 460,800 bytes).
    43  * `capabilities` - (Optional) A list of capabilities.
    44    Currently, the only valid value is `CAPABILITY_IAM`
    45  * `disable_rollback` - (Optional) Set to true to disable rollback of the stack if stack creation failed.
    46    Conflicts with `on_failure`.
    47  * `notification_arns` - (Optional) A list of SNS topic ARNs to publish stack related events.
    48  * `on_failure` - (Optional) Action to be taken if stack creation fails. This must be
    49    one of: `DO_NOTHING`, `ROLLBACK`, or `DELETE`. Conflicts with `disable_rollback`.
    50  * `parameters` - (Optional) A list of Parameter structures that specify input parameters for the stack.
    51  * `policy_body` - (Optional) Structure containing the stack policy body.
    52    Conflicts w/ `policy_url`.
    53  * `policy_url` - (Optional) Location of a file containing the stack policy.
    54    Conflicts w/ `policy_body`.
    55  * `tags` - (Optional) A list of tags to associate with this stack.
    56  * `timeout_in_minutes` - (Optional) The amount of time that can pass before the stack status becomes `CREATE_FAILED`.
    57  
    58  ## Attributes Reference
    59  
    60  The following attributes are exported:
    61  
    62  * `arn` - A unique identifier of the stack.
    63  * `outputs` - A list of output structures.