Resource: aws_default_vpc

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.

Example Usage

Basic usage with tags:

resource "aws_default_vpc" "default" {
  tags = {
    Name = "Default VPC"
  }
}

Argument Reference

The arguments of an aws_default_vpc differ slightly from those of aws_vpc:

This resource supports the following additional arguments:

Attribute Reference

This resource exports the following attributes in addition to the arguments above:

Import

In 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