associate_dhcp_options¶
Operation¶
associate_dhcp_options
¶
associate_dhcp_options(request: AssociateDhcpOptionsInput | AssociateDhcpOptionsInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssociateDhcpOptionsInputDict]) -> AssociateDhcpOptionsOutput
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 option sets in the Amazon VPC User Guide.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
request
|
AssociateDhcpOptionsInput | AssociateDhcpOptionsInputDict | None
|
The input as a model or dictionary. Pass this or keyword arguments, not both. |
None
|
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
**kwargs
|
Unpack[AssociateDhcpOptionsInputDict]
|
The input fields as keyword arguments. |
{}
|
Returns:
| Type | Description |
|---|---|
AssociateDhcpOptionsOutput
|
An instance of |
associate_dhcp_options
async
¶
associate_dhcp_options(request: AssociateDhcpOptionsInput | AssociateDhcpOptionsInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssociateDhcpOptionsInputDict]) -> AssociateDhcpOptionsOutput
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 option sets in the Amazon VPC User Guide.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
request
|
AssociateDhcpOptionsInput | AssociateDhcpOptionsInputDict | None
|
The input as a model or dictionary. Pass this or keyword arguments, not both. |
None
|
plugins
|
list[Plugin] | None
|
A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations. |
None
|
**kwargs
|
Unpack[AssociateDhcpOptionsInputDict]
|
The input fields as keyword arguments. |
{}
|
Returns:
| Type | Description |
|---|---|
AssociateDhcpOptionsOutput
|
An instance of |
Input¶
Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.
AssociateDhcpOptionsInputDict
¶
Bases: TypedDict
Dictionary form of AssociateDhcpOptionsInput.
Attributes¶
dhcp_options_id
instance-attribute
¶
The ID of the DHCP options set, or default to associate no DHCP
options with the VPC.
dry_run
instance-attribute
¶
dry_run: bool | None
Checks whether you have the required permissions for the action, without
actually making the request, and provides an error response. If you have
the required permissions, the error response is DryRunOperation.
Otherwise, it is UnauthorizedOperation.
AssociateDhcpOptionsInput
dataclass
¶
Bases: _SerdeShape
Dataclass for AssociateDhcpOptionsInput structure.
Attributes¶
dhcp_options_id
class-attribute
instance-attribute
¶
dhcp_options_id: str | None = ...
The ID of the DHCP options set, or default to associate no DHCP
options with the VPC.
dry_run
class-attribute
instance-attribute
¶
dry_run: bool | None = ...
Checks whether you have the required permissions for the action, without
actually making the request, and provides an error response. If you have
the required permissions, the error response is DryRunOperation.
Otherwise, it is UnauthorizedOperation.
Output¶
AssociateDhcpOptionsOutput
dataclass
¶
Bases: _SerdeShape
Dataclass for AssociateDhcpOptionsOutput structure.