amazonka-ec2-2.0: Amazon Elastic Compute Cloud SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.EC2.AssignIpv6Addresses

Description

Assigns one or more IPv6 addresses to the specified network interface. You can specify one or more specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from within 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 per instance type. For information, see IP Addresses Per Network Interface Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

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 Amazon EC2 network interfaces in the Amazon Elastic Compute Cloud User Guide.

Synopsis

Creating a Request

data AssignIpv6Addresses Source #

See: newAssignIpv6Addresses smart constructor.

Constructors

AssignIpv6Addresses' 

Fields

  • ipv6AddressCount :: Maybe Int

    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.

  • ipv6Addresses :: Maybe [Text]

    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.

  • ipv6PrefixCount :: Maybe Int

    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.

  • ipv6Prefixes :: Maybe [Text]

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

  • networkInterfaceId :: Text

    The ID of the network interface.

Instances

Instances details
ToHeaders AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

ToPath AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

ToQuery AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

AWSRequest AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Associated Types

type AWSResponse AssignIpv6Addresses #

Generic AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Associated Types

type Rep AssignIpv6Addresses :: Type -> Type #

Read AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Show AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

NFData AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Methods

rnf :: AssignIpv6Addresses -> () #

Eq AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Hashable AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

type AWSResponse AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

type Rep AssignIpv6Addresses Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

type Rep AssignIpv6Addresses = D1 ('MetaData "AssignIpv6Addresses" "Amazonka.EC2.AssignIpv6Addresses" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "AssignIpv6Addresses'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "ipv6AddressCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "ipv6Addresses") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text]))) :*: (S1 ('MetaSel ('Just "ipv6PrefixCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: (S1 ('MetaSel ('Just "ipv6Prefixes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 ('MetaSel ('Just "networkInterfaceId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newAssignIpv6Addresses Source #

Create a value of AssignIpv6Addresses with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

AssignIpv6Addresses, assignIpv6Addresses_ipv6AddressCount - 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.

AssignIpv6Addresses, assignIpv6Addresses_ipv6Addresses - 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.

AssignIpv6Addresses, assignIpv6Addresses_ipv6PrefixCount - 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.

AssignIpv6Addresses, assignIpv6Addresses_ipv6Prefixes - One or more IPv6 prefixes assigned to the network interface. You cannot use this option if you use the Ipv6PrefixCount option.

AssignIpv6Addresses, assignIpv6Addresses_networkInterfaceId - The ID of the network interface.

Request Lenses

assignIpv6Addresses_ipv6AddressCount :: Lens' AssignIpv6Addresses (Maybe Int) Source #

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.

assignIpv6Addresses_ipv6Addresses :: Lens' AssignIpv6Addresses (Maybe [Text]) Source #

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.

assignIpv6Addresses_ipv6PrefixCount :: Lens' AssignIpv6Addresses (Maybe Int) Source #

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.

assignIpv6Addresses_ipv6Prefixes :: Lens' AssignIpv6Addresses (Maybe [Text]) Source #

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

Destructuring the Response

data AssignIpv6AddressesResponse Source #

See: newAssignIpv6AddressesResponse smart constructor.

Constructors

AssignIpv6AddressesResponse' 

Fields

Instances

Instances details
Generic AssignIpv6AddressesResponse Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Associated Types

type Rep AssignIpv6AddressesResponse :: Type -> Type #

Read AssignIpv6AddressesResponse Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Show AssignIpv6AddressesResponse Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

NFData AssignIpv6AddressesResponse Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

Eq AssignIpv6AddressesResponse Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

type Rep AssignIpv6AddressesResponse Source # 
Instance details

Defined in Amazonka.EC2.AssignIpv6Addresses

type Rep AssignIpv6AddressesResponse = D1 ('MetaData "AssignIpv6AddressesResponse" "Amazonka.EC2.AssignIpv6Addresses" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "AssignIpv6AddressesResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "assignedIpv6Addresses") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 ('MetaSel ('Just "assignedIpv6Prefixes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text]))) :*: (S1 ('MetaSel ('Just "networkInterfaceId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newAssignIpv6AddressesResponse Source #

Create a value of AssignIpv6AddressesResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:assignedIpv6Addresses:AssignIpv6AddressesResponse', assignIpv6AddressesResponse_assignedIpv6Addresses - 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.

$sel:assignedIpv6Prefixes:AssignIpv6AddressesResponse', assignIpv6AddressesResponse_assignedIpv6Prefixes - The IPv6 prefixes that are assigned to the network interface.

AssignIpv6Addresses, assignIpv6AddressesResponse_networkInterfaceId - The ID of the network interface.

$sel:httpStatus:AssignIpv6AddressesResponse', assignIpv6AddressesResponse_httpStatus - The response's http status code.

Response Lenses

assignIpv6AddressesResponse_assignedIpv6Addresses :: Lens' AssignIpv6AddressesResponse (Maybe [Text]) Source #

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.

assignIpv6AddressesResponse_assignedIpv6Prefixes :: Lens' AssignIpv6AddressesResponse (Maybe [Text]) Source #

The IPv6 prefixes that are assigned to the network interface.