AI 助理
备案控制台
文档
输入文档关键字查找
首页 Terraform 资源列表 VPC Resources alicloud_vpc

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, Available since v1.240.0) The status of VPC DNS Hostname. Valid values: ENABLED, DISABLED.

  • dry_run - (Optional, Available since v1.119.0) 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, Available since v1.119.0) Specifies whether to enable IPv6. Valid values:

    • false (default)
    • true

  • 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 route table that you want to query.
  • 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.
  • secondary_cidr_mask - (Optional, Int, Available since v1.240.0) Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.

-> NOTE: Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.

  • 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, 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, 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.

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).
  • region_id - (Available since v1.240.0) The region ID of the VPC to which the route table belongs.
  • router_id - The router ID of the VPC.
  • status - The status of the VPC.

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>

上一篇：alicloud_route_table_attachment下一篇：alicloud_vpc_dhcp_options_set