alicloud_vpc

Provides a VPC Vpc resource.

A VPC instance creates a VPC. You can fully control your own VPC, such as selecting IP address ranges, configuring routing tables, and gateways. You can use Alibaba cloud resources such as cloud servers, apsaradb for RDS, and load balancer in your own VPC.

-> NOTE: This resource will auto build a router and a route table while it uses alicloud_vpc to build a vpc resource.

-> NOTE: Available since v1.0.0.

Module Support

You can use the existing vpc module to create a VPC and several VSwitches one-click.

For information about VPC Vpc and how to use it, see What is Vpc.

Example Usage

Basic Usage

variable "name" {
  default = "terraform-example"
}


resource "alicloud_vpc" "default" {
  ipv6_isp    = "BGP"
  description = "test"
  cidr_block  = "10.0.0.0/8"
  vpc_name    = var.name
  enable_ipv6 = true
}

Argument Reference

The following arguments are supported:

• is_default - (Optional) Specifies whether to create the default VPC in the specified region. Valid values:

  • true
  • false(default)

• cidr_block - (Optional, Computed) The CIDR block of the VPC.

  • You can specify one of the following CIDR blocks or their subsets as the primary IPv4 CIDR block of the VPC: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8. These CIDR blocks are standard private CIDR blocks as defined by Request for Comments (RFC) documents. The subnet mask must be 8 to 28 bits in length.
  • You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, and their subnets as the primary IPv4 CIDR block of the VPC.

• classic_link_enabled - (Optional) The status of ClassicLink function.

• description - (Optional) The new description of the VPC. The description must be 1 to 256 characters in length, and cannot start with http:// or https://.

• dry_run - (Optional) Specifies whether to perform a dry run. Valid values:

  • true: performs a dry run. The system checks the required parameters, request syntax, and limits. If the request fails the dry run, an error message is returned. If the request passes the dry run, the DryRunOperation error code is returned.
  • false (default): performs a dry run and sends the request. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.

• enable_ipv6 - (Optional) The name of the VPC. The name must be 1 to 128 characters in length and cannot start with http:// or https://.

• ipv4_ipam_pool_id - (Optional) The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.

• ipv6_cidr_block - (Optional, ForceNew, Computed) The IPv6 CIDR block of the default VPC.

-> NOTE: When EnableIpv6 is set to true, this parameter is required.

• ipv6_isp - (Optional) The IPv6 address segment type of the VPC. Value:
  • BGP (default): Alibaba Cloud BGP IPv6.
  • ChinaMobile: China Mobile (single line).
  • ChinaUnicom: China Unicom (single line).
  • ChinaTelecom: China Telecom (single line).

-> NOTE: If a single-line bandwidth whitelist is enabled, this field can be set to ChinaTelecom (China Telecom), ChinaUnicom (China Unicom), or ChinaMobile (China Mobile).

• resource_group_id - (Optional, Computed) The ID of the resource group to which you want to move the resource.

-> NOTE: You can use resource groups to facilitate resource grouping and permission management for an Alibaba Cloud. For more information, see What is resource management?

• route_table_id - (Computed) The ID of the route table that you want to query.
• secondary_cidr_blocks - (Optional, Computed, Deprecated since v1.185.0) Field 'secondary_cidr_blocks' has been deprecated from provider version 1.185.0 and it will be removed in the future version. Please use the new resource 'alicloud_vpc_ipv4_cidr_block'. secondary_cidr_blocks attributes and alicloud_vpc_ipv4_cidr_block resource cannot be used at the same time.
• system_route_table_description - (Optional) The description of the route table. The description must be 1 to 256 characters in length, and cannot start with http:// or https://.
• system_route_table_name - (Optional) The name of the route table. The name must be 1 to 128 characters in length and cannot start with http:// or https://.
• tags - (Optional, Map) The tags of Vpc.
• user_cidrs - (Optional, ForceNew, Computed) A list of user CIDRs.
• vpc_name - (Optional) The new name of the VPC. The name must be 1 to 128 characters in length and cannot start with http:// or https://.

The following arguments will be discarded. Please use new fields as soon as possible:

• name - (Deprecated since v1.119.0). Field 'name' has been deprecated from provider version 1.119.0. New field 'vpc_name' instead.
• router_table_id - (Deprecated since v1.227.1). Field 'router_table_id' has been deprecated from provider version 1.227.1. New field 'route_table_id' instead.

Attributes Reference

The following attributes are exported:

• id - The ID of the resource supplied above.
• create_time - The creation time of the VPC.
• ipv6_cidr_blocks - The IPv6 CIDR block information of the VPC.
  • ipv6_cidr_block - The IPv6 CIDR block of the VPC.
  • ipv6_isp - Valid values: BGP (default): Alibaba Cloud BGP IPv6.
  • ChinaMobile: China Mobile (single line).
  • ChinaUnicom: China Unicom (single line).
  • ChinaTelecom: China Telecom (single line).
• router_id - The region ID of the VPC to which the route table belongs. You can call the DescribeRegions operation to query the most recent region list.
• status - The status of the VPC. Pending: The VPC is being configured. Available: The VPC is available.

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

• create - (Defaults to 5 mins) Used when create the Vpc.
• delete - (Defaults to 5 mins) Used when delete the Vpc.
• update - (Defaults to 5 mins) Used when update the Vpc.

Import

VPC Vpc can be imported using the id, e.g.

$ terraform import alicloud_vpc.example <id>