Provides a resource to manage the default AWS VPC in the current region.
For AWS accounts created after 2013-12-04, each region comes with a Default VPC. This is an advanced resource, and has special caveats to be aware of when using it. Please read this document in its entirety before using this resource.
The aws_default_vpc
behaves differently from normal resources, in that Terraform does not create this resource, but instead "adopts" it into management.
Basic usage with tags:
resource "aws_default_vpc" "default" { tags { Name = "Default VPC" } }
The arguments of an aws_default_vpc
differ slightly from aws_vpc
resources. Namely, the cidr_block
, instance_tenancy
and assign_generated_ipv6_cidr_block
arguments are computed. The following arguments are still supported:
enable_dns_support
- (Optional) A boolean flag to enable/disable DNS support in the VPC. Defaults true. enable_dns_hostnames
- (Optional) A boolean flag to enable/disable DNS hostnames in the VPC. Defaults false. enable_classiclink
- (Optional) A boolean flag to enable/disable ClassicLink for the VPC. Only valid in regions and accounts that support EC2 Classic. See the ClassicLink documentation for more information. Defaults false. tags
- (Optional) A mapping of tags to assign to the resource. aws_default_vpc
from your configuration The aws_default_vpc
resource allows you to manage a region's default VPC, but Terraform cannot destroy it. Removing this resource from your configuration will remove it from your statefile and management, but will not destroy the VPC. You can resume managing the VPC via the AWS Console.
In addition to all arguments above, the following attributes are exported:
id
- The ID of the VPC cidr_block
- The CIDR block of the VPC instance_tenancy
- Tenancy of instances spin up within VPC. enable_dns_support
- Whether or not the VPC has DNS support enable_dns_hostnames
- Whether or not the VPC has DNS hostname support enable_classiclink
- Whether or not the VPC has Classiclink enabled assign_generated_ipv6_cidr_block
- Whether or not an Amazon-provided IPv6 CIDR block with a /56 prefix length for the VPC was assigned main_route_table_id
- The ID of the main route table associated with this VPC. Note that you can change a VPC's main route table by using an aws_main_route_table_association
default_network_acl_id
- The ID of the network ACL created by default on VPC creation default_security_group_id
- The ID of the security group created by default on VPC creation default_route_table_id
- The ID of the route table created by default on VPC creation ipv6_association_id
- The association ID for the IPv6 CIDR block of the VPC ipv6_cidr_block
- The IPv6 CIDR block of the VPC Default VPCs can be imported using the vpc id
, e.g.
$ terraform import aws_default_vpc.default vpc-a01106c2
© 2018 HashiCorpLicensed under the MPL 2.0 License.
https://www.terraform.io/docs/providers/aws/r/default_vpc.html