为企业版转发路由器创建策略路由表。
接口说明
-
当前仅企业版转发路由器支持创建策略路由表。关于企业版转发路由器支持的地域和可用区信息,请参见什么是云企业网。
-
CreateTransitRouterPolicyTable 接口属于异步接口,即系统会先返回一个策略路由表 ID,但该策略路由表并未创建完成,系统后台的创建任务仍在进行。您可以调用 DescribeTransitRouterPolicyTables 接口查询策略路由表的状态。
当策略路由表处于 Creating 状态时,表示策略路由表正在创建中。在该状态下,您只能执行查询操作,不能执行其他操作。
当策略路由表处于 Active 状态时,表示策略路由表创建完成。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
cen:CreateTransitRouterPolicyTable |
create |
TransitRouterPolicyTable
TransitRouter
|
无 | 无 |
请求语法
POST HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClientToken |
string |
否 |
客户端 Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。 |
02fb3da4-130e-11e9-8e44-001**** |
| TransitRouterId |
string |
是 |
企业版转发路由器实例 ID。 |
tr-uf654ttymmljlvh2x**** |
| Name |
string |
否 |
策略路由表实例的名称。 |
nametest |
| Description |
string |
否 |
策略路由表实例的描述信息。 |
descriptiontest |
| DryRun |
boolean |
否 |
是否对此次创建请求执行预检,包括权限、实例状态校验等。取值:
|
false |
| Tag |
array<object> |
否 |
策略路由表实例绑定的标签列表。 |
|
|
object |
否 |
策略路由表实例绑定的标签。 |
{"Key":"tagtest","Value":"tagtest"} |
|
| Key |
string |
否 |
标签键。 |
tagtest |
| Value |
string |
否 |
标签值。 |
tagtest |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| PolicyTableId |
string |
策略路由表实例 ID。 |
ptbl-44m0p68spvlrqq**** |
| RequestId |
string |
请求 ID。 |
2BFA6822-240E-4E27-B4C8-AA400EF7474D |
示例
正常返回示例
JSON格式
{
"PolicyTableId": "ptbl-44m0p68spvlrqq****",
"RequestId": "2BFA6822-240E-4E27-B4C8-AA400EF7474D"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InstanceNotExist.TransitRouter | The transitRouter is not exist. | transitRouter不存在。 |
| 400 | OperationUnsupported.TransitRouterType | The operation is not supported because of the wrong transitRouter type. | 当前TransitRouter类型不支持该操作。 |
| 400 | IncorrectStatus.TransitRouter | TransitRouter status is invalid. | 当前TransitRouter的状态不支持该操作,请稍后重试。 |
| 400 | OperationUnsupported.PolicyBasedRouting | PolicyBasedRouting is unsupported. | 不支持策略路由功能。 |
| 400 | InvalidParameter.TagValue | The specified parameter TagValue is invalid. | 输入的参数Tag Value不合法。 |
| 400 | InvalidParameter.TransitRouterId | The specified parameter TransitRouterId is invalid. | 输入的参数TransitRouterId不合法。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。