Skip to content

assign_ipv6_addresses

Operation

assign_ipv6_addresses

assign_ipv6_addresses(request: AssignIpv6AddressesInput | AssignIpv6AddressesInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssignIpv6AddressesInputDict]) -> AssignIpv6AddressesOutput

Assigns the specified IPv6 addresses to the specified network interface. You can specify specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from the subnet's IPv6 CIDR block range. You can assign as many IPv6 addresses to a network interface as you can assign private IPv4 addresses, and the limit varies by instance type.

You must specify either the IPv6 addresses or the IPv6 address count in the request.

You can optionally use Prefix Delegation on the network interface. You must specify either the IPV6 Prefix Delegation prefixes, or the IPv6 Prefix Delegation count. For information, see Assigning prefixes to network interfaces in the Amazon EC2 User Guide.

Parameters:

Name Type Description Default
request AssignIpv6AddressesInput | AssignIpv6AddressesInputDict | 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[AssignIpv6AddressesInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
AssignIpv6AddressesOutput

An instance of AssignIpv6AddressesOutput.

assign_ipv6_addresses async

assign_ipv6_addresses(request: AssignIpv6AddressesInput | AssignIpv6AddressesInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[AssignIpv6AddressesInputDict]) -> AssignIpv6AddressesOutput

Assigns the specified IPv6 addresses to the specified network interface. You can specify specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from the subnet's IPv6 CIDR block range. You can assign as many IPv6 addresses to a network interface as you can assign private IPv4 addresses, and the limit varies by instance type.

You must specify either the IPv6 addresses or the IPv6 address count in the request.

You can optionally use Prefix Delegation on the network interface. You must specify either the IPV6 Prefix Delegation prefixes, or the IPv6 Prefix Delegation count. For information, see Assigning prefixes to network interfaces in the Amazon EC2 User Guide.

Parameters:

Name Type Description Default
request AssignIpv6AddressesInput | AssignIpv6AddressesInputDict | 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[AssignIpv6AddressesInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
AssignIpv6AddressesOutput

An instance of AssignIpv6AddressesOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

AssignIpv6AddressesInputDict

Bases: TypedDict

Dictionary form of AssignIpv6AddressesInput.

Attributes

ipv6_address_count instance-attribute
ipv6_address_count: int | None

The number of additional IPv6 addresses to assign to the network interface. The specified number of IPv6 addresses are assigned in addition to the existing IPv6 addresses that are already assigned to the network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses.

ipv6_addresses instance-attribute
ipv6_addresses: Sequence[str] | None

The IPv6 addresses to be assigned to the network interface. You can't use this option if you're specifying a number of IPv6 addresses.

ipv6_prefix_count instance-attribute
ipv6_prefix_count: int | None

The number of IPv6 prefixes that Amazon Web Services automatically assigns to the network interface. You cannot use this option if you use the Ipv6Prefixes option.

ipv6_prefixes instance-attribute
ipv6_prefixes: Sequence[str] | None

One or more IPv6 prefixes assigned to the network interface. You can't use this option if you use the Ipv6PrefixCount option.

network_interface_id instance-attribute
network_interface_id: Required[str]

The ID of the network interface.

AssignIpv6AddressesInput dataclass

Bases: _SerdeShape

Dataclass for AssignIpv6AddressesInput structure.

Attributes

ipv6_address_count class-attribute instance-attribute
ipv6_address_count: int | None = ...

The number of additional IPv6 addresses to assign to the network interface. The specified number of IPv6 addresses are assigned in addition to the existing IPv6 addresses that are already assigned to the network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses.

ipv6_addresses class-attribute instance-attribute
ipv6_addresses: list[str] | None = ...

The IPv6 addresses to be assigned to the network interface. You can't use this option if you're specifying a number of IPv6 addresses.

ipv6_prefix_count class-attribute instance-attribute
ipv6_prefix_count: int | None = ...

The number of IPv6 prefixes that Amazon Web Services automatically assigns to the network interface. You cannot use this option if you use the Ipv6Prefixes option.

ipv6_prefixes class-attribute instance-attribute
ipv6_prefixes: list[str] | None = ...

One or more IPv6 prefixes assigned to the network interface. You can't use this option if you use the Ipv6PrefixCount option.

network_interface_id class-attribute instance-attribute
network_interface_id: str | None = ...

The ID of the network interface.

Output

AssignIpv6AddressesOutput dataclass

Bases: _SerdeShape

Dataclass for AssignIpv6AddressesOutput structure.

Attributes

assigned_ipv6_addresses class-attribute instance-attribute
assigned_ipv6_addresses: list[str] | None = ...

The new IPv6 addresses assigned to the network interface. Existing IPv6 addresses that were assigned to the network interface before the request are not included.

assigned_ipv6_prefixes class-attribute instance-attribute
assigned_ipv6_prefixes: list[str] | None = ...

The IPv6 prefixes that are assigned to the network interface.

network_interface_id class-attribute instance-attribute
network_interface_id: str | None = ...

The ID of the network interface.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.