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://.

• dns_hostname_status - (Optional, Computed, Available since v1.240.0) The status of VPC DNS Hostname

• dry_run - (Optional, Available since v1.119.0) Whether to PreCheck only this request. Value:

  • true: The check request is sent without creating a VPC. Check items include whether required parameters, request format, and business restrictions are filled in. If the check does not pass, the corresponding error is returned. If the check passes, the error code 'DryRunOperation' is returned '.
  • false (default): Sends a normal request, returns an HTTP 2xx status code and directly creates a VPC.

• enable_ipv6 - (Optional, Available since v1.119.0) Whether to enable the IPv6 network segment. Value:

  • false (default): Not enabled.
  • true: enabled.

• force_delete - (Optional, Available since v1.248.0) Force delete vpc or not.

• ipv4_cidr_mask - (Optional, Int, Available since v1.240.0) Allocate VPC from The IPAM address pool by entering a mask.

-> NOTE: when you specify the IPAM address pool to create a VPC, enter at least one of the CidrBlock or Ipv4CidrMask parameters.

• 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, Available since v1.115) 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 - (Optional, ForceNew, Computed) The ID of the system route table.
• secondary_cidr_blocks - (Optional, Computed, List, 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://.
• system_route_table_route_propagation_enable - (Optional, Available since v1.248.0) Whether the system route table receives propagation routes.
• tags - (Optional, Map, Available since v1.55.3) The tags of Vpc.
• user_cidrs - (Optional, ForceNew, Computed, List, Available since v1.119.0) A list of user CIDRs.
• vpc_name - (Optional, Computed, Available since v1.119.0) 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.
• secondary_cidr_mask - (Deprecated since v1.248.0) Field 'router_table_id' has been deprecated from provider version 1.248.0. New resource 'alicloud_vpc_ipv4_cidr_block' 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.
• region_id - The ID of the region where the VPC is located.
• router_id - The region ID of the VPC to which the route table belongs.
• 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 10 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>