Creates a custom route table for an Enterprise Edition transit router.
Operation description
-
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
Authorization information
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action
policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level,
All Resources
is used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
Operation | Access level | Resource type | Condition key | Associated operation |
---|---|---|---|---|
cen:CreateTransitRouterRouteTable | create |
|
| none |
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ClientToken | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The client token can contain only ASCII characters. Note
If you do not specify this parameter, the system automatically uses the request ID as the client token. The request ID may be different for each request.
| 02fb3da4-130e-11e9-8e44-001**** |
TransitRouterRouteTableName | string | No | The name of the custom route table. The name must be 1 to 128 characters in length, and cannot start with http:// or https://. You can also leave this parameter empty. | testname |
TransitRouterRouteTableDescription | string | No | The description of the custom route table. The description must be 1 to 256 characters in length, and cannot start with http:// or https://. You can also leave this parameter empty. | testdesc |
TransitRouterId | string | Yes | The ID of the Enterprise Edition transit router. | tr-bp1su1ytdxtataupl**** |
DryRun | boolean | No | Specifies whether to precheck the request. Check items include permissions and the status of the specified cloud resources. Valid values:
| false |
Tag | array<object> | No | The tags. You can specify at most 20 tags in each call. | |
object | No | |||
Key | string | No | The tag key. The tag key cannot be an empty string. The tag key can be up to 64 characters in length and cannot start with You can specify at most 20 tag keys. | test |
Value | string | No | The tag value. The tag value can be 0 to 128 characters in length, and cannot start with Each tag key must have a unique tag value. You can specify at most 20 tag values in each call. | tagtest |
RouteTableOptions | object | No | The features of the route table. | |
MultiRegionECMP | string | No | Specifies whether to enable multi-region equal-cost multi-path (ECMP) routing. Valid values:
| disable |
Response parameters
Examples
Sample success responses
JSON
format
{
"TransitRouterRouteTableId": "vtb-bp1xbcgpgcz9axl9m****",
"RequestId": "599904C8-A3DA-4E5F-83B6-D5364E664247"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidTransitRouterId.NotFound | TransitRouterId is not found | The error message returned because the specified transit router ID (TransitRouterId) does not exist. |
400 | OperationFailed.CCNTrNotSupport | Operation failed because the CCN transit router does not support route table. | The error message returned because transit routers deployed in CCN regions do not allow you to create route tables. |
400 | DryRunOperation | Request validation has been passed with DryRun flag set. | The error message returned because the dry run request passed the precheck. |
400 | MissingParam.TransitRouterId | The parameter TransitrouterId is mandatory. | The error message returned because the TransitRouterId parameter is not set. |
400 | OperationFailed.BasicTrNotSupport | Operation failed because the Basic TransitRouter does not support RouteTable | The error message returned because this operation is not supported by Basic Edition transit routers. |
400 | IncorrectStatus.TransitRouter | TransitRouter status is invalid. | The error message returned because the status of the transit router does not support this operation. Try again later. |
400 | QuotaExceeded.TransitRouterRoutTable | TransitRouterRoutTable quota exceeded. | The error message returned because the number of route tables has reached the upper limit. |
400 | OperationUnsupported.MultiRegionEcmp | This region does not support MultiRegionEcmp. | - |
400 | InvalidParameter | Invalid parameter. | The error message returned because the parameter is set to an invalid value. |
400 | Unauthorized | The AccessKeyId is unauthorized. | The error message returned because you do not have the permissions to perform this operation. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2023-10-18 | The Error code has changed | View Change Details |
2023-01-10 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2023-01-04 | The Error code has changed | View Change Details |