Skip to content

Commit

Permalink
provider/aws: Add docs for aws_cloudformation_stack
Browse files Browse the repository at this point in the history
  • Loading branch information
radeksimko authored and Radek Simko committed Oct 4, 2015
1 parent 53f1edc commit a2a3ba5
Show file tree
Hide file tree
Showing 2 changed files with 72 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
layout: "aws"
page_title: "AWS: aws_cloudformation_stack"
sidebar_current: "docs-aws-resource-cloudformation-stack"
description: |-
Provides a CloudFormation Stack resource.
---

# aws\_cloudformation\_stack

Provides a CloudFormation Stack resource.

## Example Usage

```
resource "aws_cloudformation_stack" "network" {
name = "networking-stack"
template_body = <<STACK
{
"Resources" : {
"my-vpc": {
"Type" : "AWS::EC2::VPC",
"Properties" : {
"CidrBlock" : "10.0.0.0/16",
"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.
Currently, the only valid value is `CAPABILITY_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.
* `timeout_in_minutes` - (Optional) The amount of time that can pass before the stack status becomes `CREATE_FAILED`.

## Attributes Reference

The following attributes are exported:

* `arn` - A unique identifier of the stack.
* `outputs` - A list of output structures.
9 changes: 9 additions & 0 deletions website/source/layouts/aws.erb
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,15 @@
</ul>
</li>

<li<%= sidebar_current(/^docs-aws-resource-cloudformation/) %>>
<a href="#">CloudFormation Resources</a>
<ul class="nav nav-visible">
<li<%= sidebar_current("docs-aws-resource-cloudformation-stack") %>>
<a href="/docs/providers/aws/r/cloudformation_stack.html">aws_cloudformation_stack</a>
</li>
</ul>
</li>


<li<%= sidebar_current(/^docs-aws-resource-dynamodb/) %>>
<a href="#">DynamoDB Resources</a>
Expand Down

0 comments on commit a2a3ba5

Please sign in to comment.