» Resource: aws_vpc_dhcp_options
Provides a VPC DHCP Options resource.
» Example Usage
Basic usage:
resource "aws_vpc_dhcp_options" "dns_resolver" {
domain_name_servers = ["8.8.8.8", "8.8.4.4"]
}
Full usage:
resource "aws_vpc_dhcp_options" "foo" {
domain_name = "service.consul"
domain_name_servers = ["127.0.0.1", "10.0.0.2"]
ntp_servers = ["127.0.0.1"]
netbios_name_servers = ["127.0.0.1"]
netbios_node_type = 2
tags = {
Name = "foo-name"
}
}
» Argument Reference
The following arguments are supported:
-
domain_name
- (Optional) the suffix domain name to use by default when resolving non Fully Qualified Domain Names. In other words, this is what ends up being thesearch
value in the/etc/resolv.conf
file. -
domain_name_servers
- (Optional) List of name servers to configure in/etc/resolv.conf
. If you want to use the default AWS nameservers you should set this toAmazonProvidedDNS
. -
ntp_servers
- (Optional) List of NTP servers to configure. -
netbios_name_servers
- (Optional) List of NETBIOS name servers. -
netbios_node_type
- (Optional) The NetBIOS node type (1, 2, 4, or 8). AWS recommends to specify 2 since broadcast and multicast are not supported in their network. For more information about these node types, see RFC 2132. -
tags
- (Optional) A mapping of tags to assign to the resource.
» Remarks
- Notice that all arguments are optional but you have to specify at least one argument.
-
domain_name_servers
,netbios_name_servers
,ntp_servers
are limited by AWS to maximum four servers only. - To actually use the DHCP Options Set you need to associate it to a VPC using
aws_vpc_dhcp_options_association
. - If you delete a DHCP Options Set, all VPCs using it will be associated to AWS's
default
DHCP Option Set. - In most cases unless you're configuring your own DNS you'll want to set
domain_name_servers
toAmazonProvidedDNS
.
» Attributes Reference
In addition to all arguments above, the following attributes are exported:
-
id
- The ID of the DHCP Options Set. -
owner_id
- The ID of the AWS account that owns the DHCP options set.
You can find more technical documentation about DHCP Options Set in the official AWS User Guide.
» Import
VPC DHCP Options can be imported using the dhcp options id
, e.g.
$ terraform import aws_vpc_dhcp_options.my_options dopt-d9070ebb