Creates a set of DHCP options for your VPC. After creating the set, you must
associate it with the VPC, causing all existing and new instances that you launch in
the VPC to use this set of DHCP options. The following are the individual DHCP
options you can specify. For more information about the options, see RFC 2132.
domain-name-servers - The IP addresses of up to four domain name
servers, or AmazonProvidedDNS. The default DHCP option set specifies
AmazonProvidedDNS. If specifying more than one domain name server, specify the
IP addresses in a single parameter, separated by commas. To have your instance
receive a custom DNS hostname as specified in domain-name, you must
set domain-name-servers to a custom DNS server.
domain-name - If you're using AmazonProvidedDNS in
us-east-1, specify ec2.internal. If you're using
AmazonProvidedDNS in another Region, specify
region.compute.internal (for example,
ap-northeast-1.compute.internal). Otherwise, specify a domain
name (for example, ExampleCompany.com). This value is used to complete
unqualified DNS hostnames. Important: Some
Linux operating systems accept multiple domain names separated by spaces.
However, Windows and other Linux operating systems treat the value as a single
domain, which results in unexpected behavior. If your DHCP options set is
associated with a VPC that has instances with multiple operating systems,
specify only one domain name.
ntp-servers - The IP addresses of up to four Network Time Protocol (NTP)
servers.
netbios-name-servers - The IP addresses of up to four NetBIOS name
servers.
netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that
you specify 2 (broadcast and multicast are not currently supported). For more information
about these node types, see RFC 2132.
Your VPC automatically starts out with a set of DHCP options that includes only a DNS
server that we provide (AmazonProvidedDNS). If you create a set of options, and if your
VPC has an internet gateway, make sure to set the domain-name-servers
option either to AmazonProvidedDNS or to a domain name server of your
choice. For more information, see DHCP options sets in the
Amazon Virtual Private Cloud User Guide.
example
Use a bare-bones client and the command you need to make an API call.
Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.
domain-name-servers
- The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. To have your instance receive a custom DNS hostname as specified indomain-name
, you must setdomain-name-servers
to a custom DNS server.domain-name
- If you're using AmazonProvidedDNS inus-east-1
, specifyec2.internal
. If you're using AmazonProvidedDNS in another Region, specifyregion.compute.internal
(for example,ap-northeast-1.compute.internal
). Otherwise, specify a domain name (for example,ExampleCompany.com
). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.ntp-servers
- The IP addresses of up to four Network Time Protocol (NTP) servers.netbios-name-servers
- The IP addresses of up to four NetBIOS name servers.netbios-node-type
- The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an internet gateway, make sure to set the
domain-name-servers
option either toAmazonProvidedDNS
or to a domain name server of your choice. For more information, see DHCP options sets in the Amazon Virtual Private Cloud User Guide.Use a bare-bones client and the command you need to make an API call.
import { EC2Client, CreateDhcpOptionsCommand } from "@aws-sdk/client-ec2"; // ES Modules import // const { EC2Client, CreateDhcpOptionsCommand } = require("@aws-sdk/client-ec2"); // CommonJS import const client = new EC2Client(config); const command = new CreateDhcpOptionsCommand(input); const response = await client.send(command);
CreateDhcpOptionsCommandInput for command's
input
shape.CreateDhcpOptionsCommandOutput for command's
response
shape.config for EC2Client's
config
shape.