Network.AWS.EC2.CreateCustomerGateway

Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and may be behind a device performing network address translation (NAT).

For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

For more information about VPN customer gateways, see AWS Managed VPN Connections in the Amazon Virtual Private Cloud User Guide .

Important: You cannot create more than one customer gateway with the same VPN type, IP address, and BGP ASN parameter values. If you run an identical request more than one time, the first request creates the customer gateway, and subsequent requests return information about the existing customer gateway. The subsequent requests do not create new customer gateway resources.

Creating a Request

createCustomerGateway

Arguments

:: Int

ccgBGPASN

-> Text

ccgPublicIP

-> GatewayType

ccgType

-> CreateCustomerGateway

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

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

• ccgDryRun - 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 .
• ccgBGPASN - For devices that support BGP, the customer gateway's BGP ASN. Default: 65000
• ccgPublicIP - The Internet-routable IP address for the customer gateway's outside interface. The address must be static.
• ccgType - The type of VPN connection that this customer gateway supports (ipsec.1 ).

data CreateCustomerGateway

Contains the parameters for CreateCustomerGateway.

See: createCustomerGateway smart constructor.

Instances

Eq CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

(==) :: CreateCustomerGateway -> CreateCustomerGateway -> Bool

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

Data CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

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

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

toConstr :: CreateCustomerGateway -> Constr

dataTypeOf :: CreateCustomerGateway -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

readsPrec :: Int -> ReadS CreateCustomerGateway

readList :: ReadS [CreateCustomerGateway]

readPrec :: ReadPrec CreateCustomerGateway

readListPrec :: ReadPrec [CreateCustomerGateway]

Show CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

showsPrec :: Int -> CreateCustomerGateway -> ShowS

show :: CreateCustomerGateway -> String

showList :: [CreateCustomerGateway] -> ShowS

Generic CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Associated Types

type Rep CreateCustomerGateway :: Type -> Type

Methods

from :: CreateCustomerGateway -> Rep CreateCustomerGateway x

to :: Rep CreateCustomerGateway x -> CreateCustomerGateway

Hashable CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

hashWithSalt :: Int -> CreateCustomerGateway -> Int

hash :: CreateCustomerGateway -> Int

AWSRequest CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Associated Types

type Rs CreateCustomerGateway :: Type

Methods

request :: CreateCustomerGateway -> Request CreateCustomerGateway

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

ToHeaders CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

toHeaders :: CreateCustomerGateway -> [Header]

ToPath CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

toPath :: CreateCustomerGateway -> ByteString

ToQuery CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

toQuery :: CreateCustomerGateway -> QueryString

NFData CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

rnf :: CreateCustomerGateway -> ()

type Rep CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

type Rep CreateCustomerGateway = D1 (MetaData "CreateCustomerGateway" "Network.AWS.EC2.CreateCustomerGateway" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "CreateCustomerGateway'" PrefixI True) ((S1 (MetaSel (Just "_ccgDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 (MetaSel (Just "_ccgBGPASN") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)) :*: (S1 (MetaSel (Just "_ccgPublicIP") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_ccgType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 GatewayType))))

type Rs CreateCustomerGateway

Defined in Network.AWS.EC2.CreateCustomerGateway

type Rs CreateCustomerGateway = CreateCustomerGatewayResponse

Request Lenses

ccgDryRun :: Lens' CreateCustomerGateway (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 .

ccgBGPASN :: Lens' CreateCustomerGateway Int

For devices that support BGP, the customer gateway's BGP ASN. Default: 65000

ccgPublicIP :: Lens' CreateCustomerGateway Text

The Internet-routable IP address for the customer gateway's outside interface. The address must be static.

ccgType :: Lens' CreateCustomerGateway GatewayType

The type of VPN connection that this customer gateway supports (ipsec.1 ).

Destructuring the Response

createCustomerGatewayResponse

Arguments

:: Int

ccgrsResponseStatus

-> CreateCustomerGatewayResponse

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

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

• ccgrsCustomerGateway - Information about the customer gateway.
• ccgrsResponseStatus - -- | The response status code.

data CreateCustomerGatewayResponse

Contains the output of CreateCustomerGateway.

See: createCustomerGatewayResponse smart constructor.

Instances

Eq CreateCustomerGatewayResponse

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

(==) :: CreateCustomerGatewayResponse -> CreateCustomerGatewayResponse -> Bool

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

Data CreateCustomerGatewayResponse

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

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

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

toConstr :: CreateCustomerGatewayResponse -> Constr

dataTypeOf :: CreateCustomerGatewayResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateCustomerGatewayResponse

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

readsPrec :: Int -> ReadS CreateCustomerGatewayResponse

readList :: ReadS [CreateCustomerGatewayResponse]

readPrec :: ReadPrec CreateCustomerGatewayResponse

readListPrec :: ReadPrec [CreateCustomerGatewayResponse]

Show CreateCustomerGatewayResponse

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

showsPrec :: Int -> CreateCustomerGatewayResponse -> ShowS

show :: CreateCustomerGatewayResponse -> String

showList :: [CreateCustomerGatewayResponse] -> ShowS

Generic CreateCustomerGatewayResponse

Defined in Network.AWS.EC2.CreateCustomerGateway

Associated Types

type Rep CreateCustomerGatewayResponse :: Type -> Type

Methods

from :: CreateCustomerGatewayResponse -> Rep CreateCustomerGatewayResponse x

to :: Rep CreateCustomerGatewayResponse x -> CreateCustomerGatewayResponse

NFData CreateCustomerGatewayResponse

Defined in Network.AWS.EC2.CreateCustomerGateway

Methods

rnf :: CreateCustomerGatewayResponse -> ()

type Rep CreateCustomerGatewayResponse

Defined in Network.AWS.EC2.CreateCustomerGateway

type Rep CreateCustomerGatewayResponse = D1 (MetaData "CreateCustomerGatewayResponse" "Network.AWS.EC2.CreateCustomerGateway" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "CreateCustomerGatewayResponse'" PrefixI True) (S1 (MetaSel (Just "_ccgrsCustomerGateway") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe CustomerGateway)) :*: S1 (MetaSel (Just "_ccgrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

ccgrsCustomerGateway :: Lens' CreateCustomerGatewayResponse (Maybe CustomerGateway)

Information about the customer gateway.

ccgrsResponseStatus :: Lens' CreateCustomerGatewayResponse Int

• - | The response status code.