All Products
Search
Document Center

ENS:CreateEnsRouteEntry

Last Updated:Mar 12, 2024

Creates a custom route entry.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RouteTableIdstringYes

The ID of the route table to which you want to add a custom route entry.

vtb-bp1cifr72dioje82lse2j
DestinationCidrBlockstringYes

The destination CIDR block of the custom route entry. Make sure that the destination CIDR block meets the following requirements:

  • The destination CIDR block is not 100.64.0.0/10 or a subset of 100.64.0.0/10.
  • The destination CIDR block of the custom route entry is different from the destination CIDR blocks of other route entries in the same route table.
  • 0.0.0.0/0 indicates the default CIDR block.
0.0.0.0/0
NextHopTypestringNo

The type of next hop of the custom route entry. Valid values:

  • Instance (default): an ENS instance.
Instance
NextHopIdstringYes

The ID of the next hop of the custom route entry.

i-5vb7leks9z4mxy1ay258
RouteEntryNamestringNo

The name of the custom route entry that you want to add. The name must be 1 to 128 characters in length. It cannot start with http:// or https://.

test
DescriptionstringNo

The description of the custom route entry.

example

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The request ID.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
RouteEntryIdstring

The ID of the route.

rte-5vb5q8sk0lyoscx8539ds

Examples

Sample success responses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "RouteEntryId": "rte-5vb5q8sk0lyoscx8539ds"
}

Error codes

HTTP status codeError codeError message
400Invalid%sThe specified parameter %s is invalid.
400Missing%sYou must specify the parameter %s.
400InvalidRouteTableId.NotFoundSpecified route table does not exist.
400IncorrectNetworkStatusCurrent Network status does not support this operation.
400IncorrectNetworkTypeCurrent Network type does not support this operation.
400QuotaExceededRoute entry quota exceeded in this route table.
400InvalidRouteEntry.DuplicateThe route entry already exist.
400InvalidInstanId.NotFoundSpecified instance does not exist.
400ens.interface.error An error occurred while call the API.
400InvalidCidrBlock.MalformedSpecified CIDR block is not valid.
400NoPermissionPermission denied.
400InvalidParameter.%sThe specified field %s invalid. Please check it again.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history