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.CreateClientVpnRoute

Description

Adds a route to a network to a Client VPN endpoint. Each Client VPN endpoint has a route table that describes the available destination network routes. Each route in the route table specifies the path for traffic to specific resources or networks.

Synopsis

Creating a Request

data CreateClientVpnRoute Source #

See: newCreateClientVpnRoute smart constructor.

Constructors

CreateClientVpnRoute' 

Fields

  • clientToken :: Maybe Text

    Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to ensure idempotency.

  • description :: Maybe Text

    A brief description of the route.

  • dryRun :: 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.

  • clientVpnEndpointId :: Text

    The ID of the Client VPN endpoint to which to add the route.

  • destinationCidrBlock :: Text

    The IPv4 address range, in CIDR notation, of the route destination. For example:

    • To add a route for Internet access, enter 0.0.0.0/0
    • To add a route for a peered VPC, enter the peered VPC's IPv4 CIDR range
    • To add a route for an on-premises network, enter the Amazon Web Services Site-to-Site VPN connection's IPv4 CIDR range
    • To add a route for the local network, enter the client CIDR range
  • targetVpcSubnetId :: Text

    The ID of the subnet through which you want to route traffic. The specified subnet must be an existing target network of the Client VPN endpoint.

    Alternatively, if you're adding a route for the local network, specify local.

Instances

Instances details
ToHeaders CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

ToPath CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

ToQuery CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

AWSRequest CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Associated Types

type AWSResponse CreateClientVpnRoute #

Generic CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Associated Types

type Rep CreateClientVpnRoute :: Type -> Type #

Read CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Show CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

NFData CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Methods

rnf :: CreateClientVpnRoute -> () #

Eq CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Hashable CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

type AWSResponse CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

type Rep CreateClientVpnRoute Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

type Rep CreateClientVpnRoute = D1 ('MetaData "CreateClientVpnRoute" "Amazonka.EC2.CreateClientVpnRoute" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "CreateClientVpnRoute'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "clientToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)))) :*: (S1 ('MetaSel ('Just "clientVpnEndpointId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: (S1 ('MetaSel ('Just "destinationCidrBlock") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "targetVpcSubnetId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newCreateClientVpnRoute Source #

Create a value of CreateClientVpnRoute 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:

CreateClientVpnRoute, createClientVpnRoute_clientToken - Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to ensure idempotency.

CreateClientVpnRoute, createClientVpnRoute_description - A brief description of the route.

$sel:dryRun:CreateClientVpnRoute', createClientVpnRoute_dryRun - 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.

CreateClientVpnRoute, createClientVpnRoute_clientVpnEndpointId - The ID of the Client VPN endpoint to which to add the route.

CreateClientVpnRoute, createClientVpnRoute_destinationCidrBlock - The IPv4 address range, in CIDR notation, of the route destination. For example:

  • To add a route for Internet access, enter 0.0.0.0/0
  • To add a route for a peered VPC, enter the peered VPC's IPv4 CIDR range
  • To add a route for an on-premises network, enter the Amazon Web Services Site-to-Site VPN connection's IPv4 CIDR range
  • To add a route for the local network, enter the client CIDR range

$sel:targetVpcSubnetId:CreateClientVpnRoute', createClientVpnRoute_targetVpcSubnetId - The ID of the subnet through which you want to route traffic. The specified subnet must be an existing target network of the Client VPN endpoint.

Alternatively, if you're adding a route for the local network, specify local.

Request Lenses

createClientVpnRoute_clientToken :: Lens' CreateClientVpnRoute (Maybe Text) Source #

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to ensure idempotency.

createClientVpnRoute_dryRun :: Lens' CreateClientVpnRoute (Maybe Bool) Source #

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.

createClientVpnRoute_clientVpnEndpointId :: Lens' CreateClientVpnRoute Text Source #

The ID of the Client VPN endpoint to which to add the route.

createClientVpnRoute_destinationCidrBlock :: Lens' CreateClientVpnRoute Text Source #

The IPv4 address range, in CIDR notation, of the route destination. For example:

  • To add a route for Internet access, enter 0.0.0.0/0
  • To add a route for a peered VPC, enter the peered VPC's IPv4 CIDR range
  • To add a route for an on-premises network, enter the Amazon Web Services Site-to-Site VPN connection's IPv4 CIDR range
  • To add a route for the local network, enter the client CIDR range

createClientVpnRoute_targetVpcSubnetId :: Lens' CreateClientVpnRoute Text Source #

The ID of the subnet through which you want to route traffic. The specified subnet must be an existing target network of the Client VPN endpoint.

Alternatively, if you're adding a route for the local network, specify local.

Destructuring the Response

data CreateClientVpnRouteResponse Source #

See: newCreateClientVpnRouteResponse smart constructor.

Constructors

CreateClientVpnRouteResponse' 

Fields

Instances

Instances details
Generic CreateClientVpnRouteResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Associated Types

type Rep CreateClientVpnRouteResponse :: Type -> Type #

Read CreateClientVpnRouteResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Show CreateClientVpnRouteResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

NFData CreateClientVpnRouteResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

Eq CreateClientVpnRouteResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

type Rep CreateClientVpnRouteResponse Source # 
Instance details

Defined in Amazonka.EC2.CreateClientVpnRoute

type Rep CreateClientVpnRouteResponse = D1 ('MetaData "CreateClientVpnRouteResponse" "Amazonka.EC2.CreateClientVpnRoute" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "CreateClientVpnRouteResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ClientVpnRouteStatus)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateClientVpnRouteResponse Source #

Create a value of CreateClientVpnRouteResponse 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:

CreateClientVpnRouteResponse, createClientVpnRouteResponse_status - The current state of the route.

$sel:httpStatus:CreateClientVpnRouteResponse', createClientVpnRouteResponse_httpStatus - The response's http status code.

Response Lenses