Skip to content

EC2  >  Operations  >  create_client_vpn_route

create_client_vpn_route

Operation

create_client_vpn_route async

create_client_vpn_route(input: CreateClientVpnRouteInput, plugins: list[Plugin] | None = None) -> CreateClientVpnRouteOutput

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.

Parameters:

Name Type Description Default
input CreateClientVpnRouteInput

An instance of CreateClientVpnRouteInput.

required
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

Returns:

Type Description
CreateClientVpnRouteOutput

An instance of CreateClientVpnRouteOutput.

Input

CreateClientVpnRouteInput dataclass

Bases: _SerdeShape

Dataclass for CreateClientVpnRouteInput structure.

Attributes

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

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

This field is autopopulated if not provided.

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

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

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

A brief description of the route.

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

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

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

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.

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

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.

This parameter is required for VPC-based Client VPN endpoints. For Transit Gateway-based endpoints, this parameter is not required.

Output

CreateClientVpnRouteOutput dataclass

Bases: _SerdeShape

Dataclass for CreateClientVpnRouteOutput structure.

Attributes

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.

status class-attribute instance-attribute
status: ClientVpnRouteStatus | None = ...

The current state of the route.