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

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_default_vpc"
     4  sidebar_current: "docs-aws-resource-default-vpc"
     5  description: |-
     6    Manage the default VPC resource.
     7  ---
     8  
     9  # aws\_default\_vpc
    10  
    11  Provides a resource to manage the [default AWS VPC](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/default-vpc.html)
    12  in the current region.
    13  
    14  For AWS accounts created after 2013-12-04, each region comes with a Default VPC.
    15  **This is an advanced resource**, and has special caveats to be aware of when
    16  using it. Please read this document in its entirety before using this resource.
    17  
    18  The `aws_default_vpc` behaves differently from normal resources, in that
    19  Terraform does not _create_ this resource, but instead "adopts" it
    20  into management. 
    21  
    22  ## Example Usage
    23  
    24  Basic usage with tags:
    25  
    26  ```
    27  resource "aws_default_vpc" "default" {
    28  	tags {
    29  		Name = "Default VPC"
    30  	}
    31  }
    32  ```
    33  
    34  ## Argument Reference
    35  
    36  The arguments of an `aws_default_vpc` differ slightly from `aws_vpc` 
    37  resources. Namely, the `cidr_block`, `instance_tenancy` and `assign_generated_ipv6_cidr_block`
    38  arguments are computed. The following arguments are still supported: 
    39  
    40  * `enable_dns_support` - (Optional) A boolean flag to enable/disable DNS support in the VPC. Defaults true.
    41  * `enable_dns_hostnames` - (Optional) A boolean flag to enable/disable DNS hostnames in the VPC. Defaults false.
    42  * `enable_classiclink` - (Optional) A boolean flag to enable/disable ClassicLink 
    43    for the VPC. Only valid in regions and accounts that support EC2 Classic.
    44    See the [ClassicLink documentation][1] for more information. Defaults false.
    45  * `tags` - (Optional) A mapping of tags to assign to the resource.
    46  
    47  ### Removing `aws_default_vpc` from your configuration
    48  
    49  The `aws_default_vpc` resource allows you to manage a region's default VPC,
    50  but Terraform cannot destroy it. Removing this resource from your configuration
    51  will remove it from your statefile and management, but will not destroy the VPC.
    52  You can resume managing the VPC via the AWS Console.
    53  
    54  ## Attributes Reference
    55  
    56  The following attributes are exported:
    57  
    58  * `id` - The ID of the VPC
    59  * `cidr_block` - The CIDR block of the VPC
    60  * `instance_tenancy` - Tenancy of instances spin up within VPC.
    61  * `enable_dns_support` - Whether or not the VPC has DNS support
    62  * `enable_dns_hostnames` - Whether or not the VPC has DNS hostname support
    63  * `enable_classiclink` - Whether or not the VPC has Classiclink enabled
    64  * `assign_generated_ipv6_cidr_block` - Whether or not an Amazon-provided IPv6 CIDR 
    65  block with a /56 prefix length for the VPC was assigned
    66  * `main_route_table_id` - The ID of the main route table associated with
    67       this VPC. Note that you can change a VPC's main route table by using an
    68       [`aws_main_route_table_association`](/docs/providers/aws/r/main_route_table_assoc.html)
    69  * `default_network_acl_id` - The ID of the network ACL created by default on VPC creation
    70  * `default_security_group_id` - The ID of the security group created by default on VPC creation
    71  * `default_route_table_id` - The ID of the route table created by default on VPC creation
    72  * `ipv6_association_id` - The association ID for the IPv6 CIDR block of the VPC
    73  * `ipv6_cidr_block` - The IPv6 CIDR block of the VPC
    74  
    75  
    76  [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/vpc-classiclink.html