调用CreateTransitRouterRouteEntry接口在企业版转发路由器的路由表中添加路由条目。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | CreateTransitRouterRouteEntry |
要执行的操作。取值:CreateTransitRouterRouteEntry。 |
TransitRouterRouteEntryDestinationCidrBlock | String | 是 | 192.168.0.0/24 |
路由条目的目标网段。 |
TransitRouterRouteEntryNextHopType | String | 是 | BlackHole |
下一跳类型。取值:
|
TransitRouterRouteTableId | String | 是 | vtb-bp1dudbh2d5na6b50**** |
企业版转发路由器的路由表ID。 |
ClientToken | String | 否 | 02fb3da4-130e-11e9-8e44-001**** |
客户端Token,用于保证请求的幂等性。 由客户端生成该参数值,需保证该参数在不同请求间唯一,最大值不超过64个ASCII字符。 |
TransitRouterRouteEntryName | String | 否 | testname |
路由条目的名称。 名称长度为0~128个字符,可包含英文字母、数字、中文、半角逗号(,)、半角句号(.)、半角分号(;)、正斜线(/)、at(@)、下划线(_)和短划线(-)。 |
TransitRouterRouteEntryDescription | String | 否 | testdesc |
路由条目的描述。 描述可以为空或描述长度为2~256个字符,可包含英文字母、数字、中文、半角逗号(,)、半角句号(.)、半角分号(;)、正斜线(/)、at(@)、下划线(_)和短划线(-)。 |
TransitRouterRouteEntryNextHopId | String | 否 | tr-attach-nls9fzkfat8934**** |
路由条目的下一跳所关联的网络实例连接ID。 |
DryRun | Boolean | 否 | false |
是否对此次请求执行预检,包括权限、实例状态校验等。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 835E7F4B-B380-4E0F-96A5-6EA572388047 |
请求ID。 |
TransitRouterRouteEntryId | String | rte-75eg4jprkvk0pw**** |
路由条目ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateTransitRouterRouteEntry
&TransitRouterRouteEntryDestinationCidrBlock=192.168.0.0/24
&TransitRouterRouteEntryNextHopType=BlackHole
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&<公共请求参数>
正常返回示例
XML
格式
<CreateTransitRouterRouteEntryResponse>
<RequestId>835E7F4B-B380-4E0F-96A5-6EA572388047</RequestId>
<TransitRouterRouteEntryId>rte-75eg4jprkvk0pw****</TransitRouterRouteEntryId>
</CreateTransitRouterRouteEntryResponse>
JSON
格式
{
"RequestId": "835E7F4B-B380-4E0F-96A5-6EA572388047",
"TransitRouterRouteEntryId": "rte-75eg4jprkvk0pw****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | DryRunOperation | Request validation has been passed with DryRun flag set. | DryRun请求验证通过。 |
400 | InvalidTransitRouterRouteTableId.NotFound | TransitRouterRouteTableId is not found. | 转发路由器路由表实例ID未找到。 |
400 | TransitRouterRouteEntryNextHopId.NotFound | TransitRouterRouteEntryNextHopId is not found. | 转发路由器路由条目下一跳实例ID不存在。 |
400 | InstanceExist.TransitRouterRouteEntry | The instance TransitRouterRouteEntry already exists. | 转发路由器路由条目实例已存在。 |
400 | IncorrectStatus.TransitRouterRouteTable | TransitRouterRouteTable status is invalid. | 转发路由器路由表状态非法。 |
访问错误中心查看更多错误码。