CreateRouteEntry

Descriptions

• A route table can contain up to 200 custom route entries.
• The destination CIDR block (DestinationCidrBlock) of a custom route entry and the CIDR block of a vSwitch in a virtual private cloud (VPC) cannot be the same or be a subset of each other.
• The destination CIDR block (DestinationCidrBlock) of a custom route entry cannot be 100.64.0.0/10 or a subset of it.
• The destination CIDR blocks (DestinationCidrBlock) of route entries in the same route table cannot be the same.
• If you do not include the mask length when you specify the destination CIDR block (DestinationCidrBlock), the destination CIDR block is considered a host IP address whose mask length is 32 bits.
• Multiple custom route entries can be destined for the same next hop (NextHopId).
• The next hop (NextHopId) of a custom route entry must belong to the same VPC as the route table.
• Equal-cost multi-path (ECMP) routing can be configured by specifying the NextHopList parameter.
  • When you add regular route entries, you must specify DestinationCidrBlock, NextHopType, and NextHopId, and you must not specify NextHopList.
  • When you add route entries for ECMP routing, you must specify DestinationCidrBlock and NextHopList, and you must not specify NextHopType or NextHopId.

• A route table can contain up to 200 custom route entries.
• The NextHopList parameter is not supported.
• The destination CIDR block (DestinationCidrBlock) of a custom route entry cannot be 100.64.0.0/10 or a subset of it.
• The destination CIDR blocks (DestinationCidrBlock) of route entries in the same route table cannot be the same.
• If you do not include the mask length when you specify the destination CIDR block (DestinationCidrBlock), the destination CIDR block is considered a host IP address whose mask length is 32 bits.
• Multiple custom route entries can be destined for the same next hop (NextHopId).
• The next hop (NextHopId) of a custom route entry must be a router interface associated with the VBR.
• You can add route entries only when the VBR is in the Active state, and the Express Connect circuit associated with the VBR is in the Enabled state and unlocked.
• You cannot add route entries for ECMP routing. When you add regular route entries, you must specify DestinationCidrBlock, NextHopType, and NextHopId, and you must not specify NextHopList.

Request parameters

Response parameters

Examples

Sample requests

http(s)://[Endpoint]/?Action=CreateRouteEntry
&DestinationCidrBlock=192.168.0.1/24
&RouteTableId=vtb-bp145q7glnuzd****
&<Common request parameters>

Sample success responses

XML format

<CreateRouteEntryResponse>
  <RouteEntryId>rte-sn6vjkioxte1gz83z****</RouteEntryId>
  <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</CreateRouteEntryResponse>

JSON format

{
    "CreateRouteEntryResponse": {
        "RouteEntryId": "rte-sn6vjkioxte1gz83z****",
        "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
    }
}

Error codes

For a list of error codes, visit the API Error Center.