github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/aws/d/cloudformation_stack.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_cloudformation_stack"
     4  sidebar_current: "docs-aws-datasource-cloudformation-stack"
     5  description: |-
     6      Provides metadata of a CloudFormation stack (e.g. outputs)
     7  ---
     8  
     9  # aws\_cloudformation\_stack
    10  
    11  The CloudFormation Stack data source allows access to stack
    12  outputs and other useful data including the template body.
    13  
    14  ## Example Usage
    15  
    16  ```hcl
    17  data "aws_cloudformation_stack" "network" {
    18    name = "my-network-stack"
    19  }
    20  
    21  resource "aws_instance" "web" {
    22    ami           = "ami-abb07bcb"
    23    instance_type = "t1.micro"
    24    subnet_id     = "${data.aws_cloudformation_stack.network.outputs["SubnetId"]}"
    25  
    26    tags {
    27      Name = "HelloWorld"
    28    }
    29  }
    30  ```
    31  
    32  ## Argument Reference
    33  
    34  The following arguments are supported:
    35  
    36  * `name` - (Required) The name of the stack
    37  
    38  ## Attributes Reference
    39  
    40  The following attributes are exported:
    41  
    42  * `capabilities` - A list of capabilities
    43  * `description` - Description of the stack
    44  * `disable_rollback` - Whether the rollback of the stack is disabled when stack creation fails
    45  * `notification_arns` - A list of SNS topic ARNs to publish stack related events
    46  * `outputs` - A map of outputs from the stack.
    47  * `parameters` - A map of parameters that specify input parameters for the stack.
    48  * `tags` - A map of tags associated with this stack.
    49  * `template_body` - Structure containing the template body.
    50  * `iam_role_arn` - The ARN of the IAM role used to create the stack.
    51  * `timeout_in_minutes` - The amount of time that can pass before the stack status becomes `CREATE_FAILED`