Creates a custom route table for an Enterprise Edition transit router.

Usage notes

  • Only Enterprise Edition transit routers support custom route tables. For more information about the regions and zones that support Enterprise Edition transit routers, see What is CEN?
  • CreateTransitRouterRouteTable is an asynchronous operation. After you send a request, the route table ID is returned but the operation is still being performed in the system background. You can call ListTransitRouterRouteTables to query the status of a route table.
    • If a route table is in the Creating state, the route table is being created. In this case, you can query the route table but cannot perform other operations.
    • If a route table is in the Active state, the route table is created.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateTransitRouterRouteTable

The operation that you want to perform. Set the value to CreateTransitRouterRouteTable.

ClientToken String No 02fb3da4-130e-11e9-8e44-001****

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among different requests. ClientToken can contain only ASCII characters.

Note If you do not set this parameter, ClientToken is set to the value of RequestId. The value of RequestId may be different for each API request.
TransitRouterRouteTableName String No testname

The name of the custom route table.

The name must be 1 to 128 characters in length, and can contain letters, digits, and the following special characters: , . ; / @ _ -. You can also leave the name empty.

TransitRouterRouteTableDescription String No testdesc

The description of the custom route table.

The description must be 2 to 256 characters in length, and can contain letters, digits, and the following special characters: , . ; / @ _ -. You can also leave the description empty.

TransitRouterId String Yes tr-bp1su1ytdxtataupl****

The ID of the Enterprise Edition transit router.

DryRun Boolean No false

Specifies whether to precheck the request. Check items include permissions and the status of the specified cloud resources. Valid values:

  • false (default): sends the request. If the request passes the precheck, the custom route table is created.
  • true: prechecks the request but does not create the custom route table. If you use this value, the system checks the required parameters and the request syntax. If the request fails to pass the precheck, an error message is returned. If the request passes the check, the system returns the ID of the request.

Response parameters

Parameter Type Example Description
TransitRouterRouteTableId String vtb-bp1xbcgpgcz9axl9m****

The ID of the custom route table.

RequestId String 599904C8-A3DA-4E5F-83B6-D5364E664247

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=CreateTransitRouterRouteTable
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&TransitRouterRouteTableName=testname
&TransitRouterRouteTableDescription=testdesc
&TransitRouterId=tr-bp1su1ytdxtataupl****
&DryRun=false
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTransitRouterRouteTableResponse>
    <TransitRouterRouteTableId>vtb-bp1xbcgpgcz9axl9m****</TransitRouterRouteTableId>
    <RequestId>599904C8-A3DA-4E5F-83B6-D5364E664247</RequestId>
</CreateTransitRouterRouteTableResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TransitRouterRouteTableId" : "vtb-bp1xbcgpgcz9axl9m****",
  "RequestId" : "599904C8-A3DA-4E5F-83B6-D5364E664247"
}

Error codes

HttpCode Error code Error message Description
400 DryRunOperation Request validation has been passed with DryRun flag set. The error message returned because the dry run request passed the precheck.

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