alicloud_vpc_dhcp_options_set

Provides a VPC Dhcp Options Set resource.

DHCP option set.

For information about VPC Dhcp Options Set and how to use it, see What is Dhcp Options Set.

-> NOTE: Available since v1.134.0.

Example Usage

Basic Usage

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

variable "domain" {
  default = "terraform-example.com"
}

resource "alicloud_vpc_dhcp_options_set" "example" {
  dhcp_options_set_name        = var.name
  dhcp_options_set_description = var.name
  domain_name                  = var.domain
  domain_name_servers          = "100.100.2.136"
}

Argument Reference

The following arguments are supported:

• associate_vpcs - (Optional, Computed, Set, Deprecated since v1.153.0) Field 'associate_vpcs' has been deprecated from provider version 1.153.0 and it will be removed in the future version. Please use the new resource 'alicloud_vpc_dhcp_options_set_attachment' to attach DhcpOptionsSet and Vpc. See associate_vpcs below.
• dhcp_options_set_description - (Optional) The description can be blank or contain 1 to 256 characters. It must start with a letter or Chinese character but cannot start with http:// or https://.
• dhcp_options_set_name - (Optional) The name of the DHCP options set. The name must be 1 to 128 characters in length and can contain letters, digits, underscores (_), and hyphens (-). It must start with a letter.
• domain_name - (Optional) The root domain. For example, you can set the value to example.com. After a DHCP options set is associated with a virtual private cloud (VPC), the root domain in the DHCP options set is automatically synchronized with the ECS instances in the VPC.
• domain_name_servers - (Optional) The IP address of the DNS server. You can enter at most four DNS server IP addresses. Separate IP addresses with commas (,). If no IP address is specified, the Elastic Compute Service (ECS) instance uses the IP addresses 100.100.2.136 and 100.100.2.138, which are provided by Alibaba Cloud by default.
• dry_run - (Optional) Whether to PreCheck only this request, value:
  • true: sends a check request and does not delete the DHCP option set. Check items include whether required parameters are filled in, request format, and restrictions. If the check fails, the corresponding error is returned. If the check passes, the error code 'DryRunOperation' is returned '.
  • false (default): Sends a normal request and directly deletes the DHCP option set after checking.
• ipv6_lease_time - (Optional, Computed, Available since v1.207.0) The lease time of the IPv6 DHCP option set. When the lease time is set to hours: Unit: h. Value range: 24h ~ 1176h,87600h ~ 175200h. Default value: 87600h. When the lease time is set to day: Unit: d. Value range: 1d ~ 49d,3650d ~ 7300d. Default value: 1d.
• lease_time - (Optional, Computed, Available since v1.207.0) The lease time of the IPv4 addresses for the DHCP options set. If you use hours as the unit, valid values are 24h to 1176h and 87600h to 175200h. Default value: 87600h. If you use days as the unit, valid values are 1d to 49d and 3650d to 7300d. Default value: 3650d.
• resource_group_id - (Optional, Computed, Available since v1.207.0) The ID of the resource group to which the DHCP options set belongs.
• tags - (Optional, Map) Tags of the current resource.

associate_vpcs

The associate_vpcs supports the following:

• vpc_id - (Required) The ID of the VPC network that is associated with the DHCP options set.

Attributes Reference

The following attributes are exported:

• id - The ID of the resource supplied above.
• associate_vpcs - Field 'associate_vpcs' has been deprecated from provider version 1.153.0 and it will be removed in the future version. Please use the new resource 'alicloud_vpc_dhcp_options_set_attachment' to attach DhcpOptionsSet and Vpc.
  • associate_status - The status of the VPC associated with the DHCP option set.
• owner_id - The ID of the account to which the DHCP options set belongs.
• status - The status of the resource.

Timeouts

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

• create - (Defaults to 5 mins) Used when create the Dhcp Options Set.
• delete - (Defaults to 5 mins) Used when delete the Dhcp Options Set.
• update - (Defaults to 6 mins) Used when update the Dhcp Options Set.

Import

VPC Dhcp Options Set can be imported using the id, e.g.

$ terraform import alicloud_vpc_dhcp_options_set.example <id>