github.com/koding/terraform@v0.6.4-0.20170608090606-5d7e0339779d/website/source/docs/providers/aws/r/default_subnet.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_default_subnet"
     4  sidebar_current: "docs-aws-resource-default-subnet"
     5  description: |-
     6    Manage a default VPC subnet resource.
     7  ---
     8  
     9  # aws\_default\_subnet
    10  
    11  Provides a resource to manage a [default AWS VPC subnet](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/default-vpc.html#default-vpc-basics)
    12  in the current region.
    13  
    14  The `aws_default_subnet` behaves differently from normal resources, in that
    15  Terraform does not _create_ this resource, but instead "adopts" it
    16  into management. 
    17  
    18  ## Example Usage
    19  
    20  Basic usage with tags:
    21  
    22  ```
    23  resource "aws_default_subnet" "default_az1" {
    24    availability_zone = "us-west-2a"
    25  
    26  	tags {
    27  		Name = "Default subnet for us-west-2a"
    28  	}
    29  }
    30  ```
    31  
    32  ## Argument Reference
    33  
    34  The arguments of an `aws_default_subnet` differ from `aws_subnet` resources.
    35  Namely, the `availability_zone` argument is required and the `vpc_id`, `cidr_block`, `ipv6_cidr_block`,
    36  `map_public_ip_on_launch` and `assign_ipv6_address_on_creation` arguments are computed.
    37  The following arguments are still supported: 
    38  
    39  * `tags` - (Optional) A mapping of tags to assign to the resource.
    40  
    41  ### Removing `aws_default_subnet` from your configuration
    42  
    43  The `aws_default_subnet` resource allows you to manage a region's default VPC subnet,
    44  but Terraform cannot destroy it. Removing this resource from your configuration
    45  will remove it from your statefile and management, but will not destroy the subnet.
    46  You can resume managing the subnet via the AWS Console.
    47  
    48  ## Attributes Reference
    49  
    50  The following attributes are exported:
    51  
    52  * `id` - The ID of the subnet
    53  * `availability_zone`- The AZ for the subnet.
    54  * `cidr_block` - The CIDR block for the subnet.
    55  * `vpc_id` - The VPC ID.
    56  * `ipv6_association_id` - The association ID for the IPv6 CIDR block.
    57  * `ipv6_cidr_block` - The IPv6 CIDR block.