Network.AWS.EC2.CreateNetworkInterface

Creates a network interface in the specified subnet.

For more information about network interfaces, see Elastic Network Interfaces in the Amazon Virtual Private Cloud User Guide .

Creating a Request

createNetworkInterface

Arguments

:: Text

cniSubnetId

-> CreateNetworkInterface

Creates a value of CreateNetworkInterface with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cniGroups - The IDs of one or more security groups.
• cniPrivateIPAddresses - One or more private IPv4 addresses.
• cniIPv6AddressCount - The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true , you can specify 0 to override this setting.
• cniPrivateIPAddress - The primary private IPv4 address of the network interface. If you don't specify an IPv4 address, Amazon EC2 selects one for you from the subnet's IPv4 CIDR range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).
• cniSecondaryPrivateIPAddressCount - The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses . The number of IP addresses you can assign to a network interface varies by instance type. For more information, see IP Addresses Per ENI Per Instance Type in the Amazon Virtual Private Cloud User Guide .
• cniDescription - A description for the network interface.
• cniDryRun - 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 .
• cniIPv6Addresses - One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. You can't use this option if you're specifying a number of IPv6 addresses.
• cniSubnetId - The ID of the subnet to associate with the network interface.

data CreateNetworkInterface

Contains the parameters for CreateNetworkInterface.

See: createNetworkInterface smart constructor.

Instances

Eq CreateNetworkInterface

Methods

(==) :: CreateNetworkInterface -> CreateNetworkInterface -> Bool

(/=) :: CreateNetworkInterface -> CreateNetworkInterface -> Bool

Data CreateNetworkInterface

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateNetworkInterface -> c CreateNetworkInterface

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateNetworkInterface

toConstr :: CreateNetworkInterface -> Constr

dataTypeOf :: CreateNetworkInterface -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateNetworkInterface)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateNetworkInterface)

gmapT :: (forall b. Data b => b -> b) -> CreateNetworkInterface -> CreateNetworkInterface

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateNetworkInterface -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateNetworkInterface -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateNetworkInterface -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateNetworkInterface -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateNetworkInterface -> m CreateNetworkInterface

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateNetworkInterface -> m CreateNetworkInterface

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateNetworkInterface -> m CreateNetworkInterface

Read CreateNetworkInterface

Methods

readsPrec :: Int -> ReadS CreateNetworkInterface

readList :: ReadS [CreateNetworkInterface]

readPrec :: ReadPrec CreateNetworkInterface

readListPrec :: ReadPrec [CreateNetworkInterface]

Show CreateNetworkInterface

Methods

showsPrec :: Int -> CreateNetworkInterface -> ShowS

show :: CreateNetworkInterface -> String

showList :: [CreateNetworkInterface] -> ShowS

Generic CreateNetworkInterface

Associated Types

type Rep CreateNetworkInterface :: * -> *

Methods

from :: CreateNetworkInterface -> Rep CreateNetworkInterface x

to :: Rep CreateNetworkInterface x -> CreateNetworkInterface

Hashable CreateNetworkInterface

Methods

hashWithSalt :: Int -> CreateNetworkInterface -> Int

hash :: CreateNetworkInterface -> Int

NFData CreateNetworkInterface

Methods

rnf :: CreateNetworkInterface -> ()

AWSRequest CreateNetworkInterface

Associated Types

type Rs CreateNetworkInterface :: *

Methods

request :: CreateNetworkInterface -> Request CreateNetworkInterface

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * CreateNetworkInterface -> ClientResponse -> m (Response CreateNetworkInterface)

ToHeaders CreateNetworkInterface

Methods

toHeaders :: CreateNetworkInterface -> [Header]

ToPath CreateNetworkInterface

Methods

toPath :: CreateNetworkInterface -> ByteString

ToQuery CreateNetworkInterface

Methods

toQuery :: CreateNetworkInterface -> QueryString

type Rep CreateNetworkInterface

type Rep CreateNetworkInterface = D1 * (MetaData "CreateNetworkInterface" "Network.AWS.EC2.CreateNetworkInterface" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "CreateNetworkInterface'" PrefixI True) ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_cniGroups") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [Text]))) (S1 * (MetaSel (Just Symbol "_cniPrivateIPAddresses") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [PrivateIPAddressSpecification])))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cniIPv6AddressCount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Int))) (S1 * (MetaSel (Just Symbol "_cniPrivateIPAddress") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_cniSecondaryPrivateIPAddressCount") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Int))) (S1 * (MetaSel (Just Symbol "_cniDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text)))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cniDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) ((:*:) * (S1 * (MetaSel (Just Symbol "_cniIPv6Addresses") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [InstanceIPv6Address]))) (S1 * (MetaSel (Just Symbol "_cniSubnetId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))))))

type Rs CreateNetworkInterface

type Rs CreateNetworkInterface = CreateNetworkInterfaceResponse

Request Lenses

cniGroups :: Lens' CreateNetworkInterface [Text]

The IDs of one or more security groups.

cniPrivateIPAddresses :: Lens' CreateNetworkInterface [PrivateIPAddressSpecification]

One or more private IPv4 addresses.

cniIPv6AddressCount :: Lens' CreateNetworkInterface (Maybe Int)

The number of IPv6 addresses to assign to a network interface. Amazon EC2 automatically selects the IPv6 addresses from the subnet range. You can't use this option if specifying specific IPv6 addresses. If your subnet has the AssignIpv6AddressOnCreation attribute set to true , you can specify 0 to override this setting.

cniPrivateIPAddress :: Lens' CreateNetworkInterface (Maybe Text)

The primary private IPv4 address of the network interface. If you don't specify an IPv4 address, Amazon EC2 selects one for you from the subnet's IPv4 CIDR range. If you specify an IP address, you cannot indicate any IP addresses specified in privateIpAddresses as primary (only one IP address can be designated as primary).

cniSecondaryPrivateIPAddressCount :: Lens' CreateNetworkInterface (Maybe Int)

The number of secondary private IPv4 addresses to assign to a network interface. When you specify a number of secondary IPv4 addresses, Amazon EC2 selects these IP addresses within the subnet's IPv4 CIDR range. You can't specify this option and specify more than one private IP address using privateIpAddresses . The number of IP addresses you can assign to a network interface varies by instance type. For more information, see IP Addresses Per ENI Per Instance Type in the Amazon Virtual Private Cloud User Guide .

cniDescription :: Lens' CreateNetworkInterface (Maybe Text)

A description for the network interface.

cniDryRun :: Lens' CreateNetworkInterface (Maybe Bool)

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 .

cniIPv6Addresses :: Lens' CreateNetworkInterface [InstanceIPv6Address]

One or more specific IPv6 addresses from the IPv6 CIDR block range of your subnet. You can't use this option if you're specifying a number of IPv6 addresses.

cniSubnetId :: Lens' CreateNetworkInterface Text

The ID of the subnet to associate with the network interface.

Destructuring the Response

createNetworkInterfaceResponse

Arguments

:: Int

cnirsResponseStatus

-> CreateNetworkInterfaceResponse

Creates a value of CreateNetworkInterfaceResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• cnirsNetworkInterface - Information about the network interface.
• cnirsResponseStatus - -- | The response status code.

data CreateNetworkInterfaceResponse

Contains the output of CreateNetworkInterface.

See: createNetworkInterfaceResponse smart constructor.

Instances

Eq CreateNetworkInterfaceResponse

Methods

(==) :: CreateNetworkInterfaceResponse -> CreateNetworkInterfaceResponse -> Bool

(/=) :: CreateNetworkInterfaceResponse -> CreateNetworkInterfaceResponse -> Bool

Data CreateNetworkInterfaceResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> CreateNetworkInterfaceResponse -> c CreateNetworkInterfaceResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c CreateNetworkInterfaceResponse

toConstr :: CreateNetworkInterfaceResponse -> Constr

dataTypeOf :: CreateNetworkInterfaceResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c CreateNetworkInterfaceResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c CreateNetworkInterfaceResponse)

gmapT :: (forall b. Data b => b -> b) -> CreateNetworkInterfaceResponse -> CreateNetworkInterfaceResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> CreateNetworkInterfaceResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> CreateNetworkInterfaceResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> CreateNetworkInterfaceResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> CreateNetworkInterfaceResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> CreateNetworkInterfaceResponse -> m CreateNetworkInterfaceResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateNetworkInterfaceResponse -> m CreateNetworkInterfaceResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> CreateNetworkInterfaceResponse -> m CreateNetworkInterfaceResponse

Read CreateNetworkInterfaceResponse

Methods

readsPrec :: Int -> ReadS CreateNetworkInterfaceResponse

readList :: ReadS [CreateNetworkInterfaceResponse]

readPrec :: ReadPrec CreateNetworkInterfaceResponse

readListPrec :: ReadPrec [CreateNetworkInterfaceResponse]

Show CreateNetworkInterfaceResponse

Methods

showsPrec :: Int -> CreateNetworkInterfaceResponse -> ShowS

show :: CreateNetworkInterfaceResponse -> String

showList :: [CreateNetworkInterfaceResponse] -> ShowS

Generic CreateNetworkInterfaceResponse

Associated Types

type Rep CreateNetworkInterfaceResponse :: * -> *

Methods

from :: CreateNetworkInterfaceResponse -> Rep CreateNetworkInterfaceResponse x

to :: Rep CreateNetworkInterfaceResponse x -> CreateNetworkInterfaceResponse

NFData CreateNetworkInterfaceResponse

Methods

rnf :: CreateNetworkInterfaceResponse -> ()

type Rep CreateNetworkInterfaceResponse

type Rep CreateNetworkInterfaceResponse = D1 * (MetaData "CreateNetworkInterfaceResponse" "Network.AWS.EC2.CreateNetworkInterface" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "CreateNetworkInterfaceResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_cnirsNetworkInterface") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe NetworkInterface))) (S1 * (MetaSel (Just Symbol "_cnirsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int))))

Response Lenses

cnirsNetworkInterface :: Lens' CreateNetworkInterfaceResponse (Maybe NetworkInterface)

Information about the network interface.

cnirsResponseStatus :: Lens' CreateNetworkInterfaceResponse Int

• - | The response status code.