Provides a resource to manage the default AWS VPC in the current AWS Region.
If you created your AWS account after 2013-12-04 you have a default VPC in each AWS Region.
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
resource behaves differently from normal resources in that if a default VPC exists, Terraform does not _create_ this resource, but instead "adopts" it into management.
If no default VPC exists, Terraform creates a new default VPC, which leads to the implicit creation of other resources.
By default, terraform destroy
does not delete the default VPC but does remove the resource from Terraform state.
Set the force_destroy
argument to true
to delete the default VPC.
Basic usage with tags:
resource "aws_default_vpc" "default" {
tags = {
Name = "Default VPC"
}
}
The arguments of an aws_default_vpc
differ slightly from those of aws_vpc
:
cidr_block
and instance_tenancy
arguments become computed attributesenable_dns_hostnames
is true
This resource supports the following additional arguments:
force_destroy
- (Optional) Whether destroying the resource deletes the default VPC. Default: false
This resource exports the following attributes in addition to the arguments above:
cidr_block
- The primary IPv4 CIDR block for the VPCinstance_tenancy
- The allowed tenancy of instances launched into the VPCIn Terraform v1.5.0 and later, use an import
block to import Default VPCs using the VPC id
. For example:
import {
to = aws_default_vpc.default
id = "vpc-a01106c2"
}
Using terraform import
, import Default VPCs using the VPC id
. For example:
% terraform import aws_default_vpc.default vpc-a01106c2