CreateRouteEntry

Note the following before you call this action to add custom route entries for a VRouter:

• Up to 48 custom route entries can be created in a route table.
• The destination CIDR block of each custom route entry cannot be the same as the CIDR block of the VSwitch, and it cannot include or be included by the CIDR block of the VSwitch.
• The destination CIDR block of each custom route entry cannot be 100.64.0.0/10 or be included by 100.64.0.0/10.
• The destination CIDR blocks of route entries in the same route table cannot be the same.
• If the destination CIDR block is an IP address, the mask /32 is used.
• Multiple route entries can point to the same next hop.
• The next hop of each custom route entry and the route table must be in the same VPC.
• ECMP can be configured by using the NextHopList parameter.
  • When adding a normal custom route entry (non-ECMP), you must specify the DestinationCidrBlock, NextHopType and NextHopId parameters, and you cannot specify the NextHopList parameter.

  • When adding an ECMP route entry, you must specify the DestinationCidrBlock and NextHopList parameters, and you cannot specify the NextHopType and NextHopId parameters.

    Note the following when you call this action to add route entries for a VBR:

• Up to 48 route entries can be created in a route table.
• The NextHopList parameter is not supported.
• The destination CIDR block of each custom route entry cannot be 100.64.0.0/10 or be included in 100.64.0.0/10.
• The destination CIDR blocks of route entries in the same route table cannot be the same.
• If the destination CIDR block is an IP address, the mask /32 is used.
• Multiple route entries can point to the same next hop (NextHopId).
• The next hop (NextHopId) of each route entry must be a router interface associated with the VBR.
• The route entry can only be added when the VBR is in the Active status and the corresponding physical connection is in the Enabled status and not financially locked.
• Only common route entries (non- ECMP) can be added. You must specify the DestinationCidrBlock, NextHopType, and NextHopId parameters, and you cannot specify the HopList parameter.

Debug

Use OpenAPI Explorer to perform debug operations and generate code examples.

Request parameters

Response parameters

Examples

Request example

https://vpc.aliyuncs.com/?Action=CreateRouteEntry
&DestinationCidrBlock=192.168.0.1/24
&RouteTableId=vtb-bp145q7glnuzdxxxxxxxx
&<CommonParameters>

Response example

XML format

<CreateRouteEntryResponse>
  <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
</CreateRouteEntryResponse>

JSON format

{
	"RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"
}

Error codes

See common error codes