AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Container for the parameters to the CreateRoute operation. Creates a route in a route table within a VPC.

You must specify one of the following targets: Internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, network interface, or egress-only Internet gateway.

When determining how to route traffic, we use the route with the most specific match. For example, traffic is destined for the IPv4 address 192.0.2.3, and the route table includes the following two IPv4 routes:

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.EC2.AmazonEC2Request
      Amazon.EC2.Model.CreateRouteRequest

Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

C#
public class CreateRouteRequest : AmazonEC2Request
         IAmazonWebServiceRequest

The CreateRouteRequest type exposes the following members

Constructors

NameDescription
Public Method CreateRouteRequest()

Properties

NameTypeDescription
Public Property DestinationCidrBlock System.String

Gets and sets the property DestinationCidrBlock.

The IPv4 CIDR address block used for the destination match. Routing decisions are based on the most specific match.

Public Property DestinationIpv6CidrBlock System.String

Gets and sets the property DestinationIpv6CidrBlock.

The IPv6 CIDR block used for the destination match. Routing decisions are based on the most specific match.

Public Property EgressOnlyInternetGatewayId System.String

Gets and sets the property EgressOnlyInternetGatewayId.

[IPv6 traffic only] The ID of an egress-only Internet gateway.

Public Property GatewayId System.String

Gets and sets the property GatewayId.

The ID of an Internet gateway or virtual private gateway attached to your VPC.

Public Property InstanceId System.String

Gets and sets the property InstanceId.

The ID of a NAT instance in your VPC. The operation fails if you specify an instance ID unless exactly one network interface is attached.

Public Property NatGatewayId System.String

Gets and sets the property NatGatewayId.

[IPv4 traffic only] The ID of a NAT gateway.

Public Property NetworkInterfaceId System.String

Gets and sets the property NetworkInterfaceId.

The ID of a network interface.

Public Property RouteTableId System.String

Gets and sets the property RouteTableId.

The ID of the route table for the route.

Public Property VpcPeeringConnectionId System.String

Gets and sets the property VpcPeeringConnectionId.

The ID of a VPC peering connection.

Examples

This example creates a route for the specified route table. The route matches all traffic (0.0.0.0/0) and routes it to the specified Internet gateway.

To create a route


var response = client.CreateRoute(new CreateRouteRequest 
{
    DestinationCidrBlock = "0.0.0.0/0",
    GatewayId = "igw-c0a643a9",
    RouteTableId = "rtb-22574640"
});


            

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms