| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ec2-associate-dhcp-options
Description
Associates a set of DHCP options (that you've previously created) with the specified VPC, or associates no DHCP options with the VPC.
After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don't need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.
For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.
The short version of this command is ec2assocdopt.
Syntax
ec2-associate-dhcp-options {
dhcp_options_id | default } -c
vpc_id
Options
| Name | Description |
|---|---|
|
|
The ID of the DHCP options set, or Type: String Default: None Required: Yes Example: dopt-7a8b9c2d |
|
|
The ID of the VPC. Type: String Default: None Required: Yes Example: -c vpc-1a2b3c4d |
Common Options
| Option | Description |
|---|---|
|
|
Overrides the region specified by the Default: The value of the Example: |
|
|
The uniform resource locator (URL) of the Amazon EC2 web service entry point. Default: The value of the Example: |
|
|
The private key that identifies you to Amazon EC2. For more information, see Tell the Tools Who You Are. Default: The value of the Example: |
|
|
The X.509 certificate that identifies you to Amazon EC2. Default: The value of the Example: |
|
|
The access key ID associated with your AWS account. For more information, see Tell the Tools Who You Are. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The secret access key associated with your AWS account. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The AWS delegation token. Default: The value of the environment variable (if set). |
|
|
The connection timeout, in seconds. Example: |
|
|
The request timeout, in seconds. Example: |
|
|
Displays verbose output, including the API request and response on the command line. This is useful if you are building tools to talk directly to our Query API. |
|
|
Includes column headers in the command output. |
|
|
Shows empty columns as |
|
|
Omits tags for tagged resources. |
|
|
Displays internal debugging information. This can assist us when helping you troubleshooting problems. |
|
|
Displays usage information for the command. |
|
|
Reads arguments from standard input. This is useful when piping the output from one command to the input of another. Example: |
Deprecated Options
For a limited time, you can still use the private key and X.509 certificate instead of your access key ID and secret access key. However, we recommend that you start using your access key ID (-O, --aws-access-key) and secret access key (-W, --aws-secret-key) now, as the private key (-K, --private-key) and X.509 certificate (-C, --cert) won't be supported after the transition period elapses. For more information, see Tell the Tools Who You Are.
| Option | Description |
|---|---|
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
Output
This command returns a table that contains the following information:
The DHCPOPTIONS identifier
The ID of the DHCP options (or
defaultif no DHCP options are associated with the VPC)The ID of the VPC
Amazon EC2 command line tools display errors on stderr.
Examples
Example Request
This example associates the DHCP options with ID dopt-7a8b9c2d with the VPC with ID vpc-1a2b3c4d.
PROMPT>ec2-associate-dhcp-options dopt-7a8b9c2d -c vpc-1a2b3c4dDHCPOPTIONS dopt-7a8b9c2d vpc-1a2b3c4d
Example Request
This example changes the VPC with ID vpc-1a2b3c4d to have no associated DHCP options set.
PROMPT>ec2-associate-dhcp-options default -c vpc-1a2b3c4dDHCPOPTIONS default vpc-1a2b3c4d
