在企业版转发路由器中,您可以调用CreateCenChildInstanceRouteEntryToAttachment接口为网络实例添加路由条目,目标网段的下一跳指向当前地域的转发路由器。
接口说明
- 仅支持为企业版转发路由器连接的专有网络 VPC(Virtual Private Cloud)实例和边界路由器 VBR(Virtual Border Router)实例添加路由条目。
- 路由条目的下一跳默认为转发路由器连接(即网络实例连接)且不支持修改。
- CreateCenChildInstanceRouteEntryToAttachment 接口属于异步接口,即系统会先返回一个 RequestId,但该路由条目并未创建完成,系统后台的创建任务仍在进行。您可以调用专有网络的 DescribeRouteEntryList 接口查询路由条目的状态。
- 当路由条目处于 Pending 状态时,表示路由条目正在创建中。在该状态下,您只能对路由条目执行查询操作,不能执行其他操作。
- 当路由条目处于 Available 状态时,表示路由条目创建完成。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ClientToken | string | 否 | 客户端 Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
| 02fb3da4-130e-11e9-8e44-001**** |
DryRun | boolean | 否 | 是否对此次请求执行预检,包括权限、实例状态校验等。取值:
说明
当前参数暂不生效。
| false |
CenId | string | 是 | 云企业网实例 ID。 | cen-bp1n6cbxcszp55vxo**** |
TransitRouterAttachmentId | string | 是 | 网络实例连接 ID。 | tr-attach-r1qhupkc19iadz**** |
RouteTableId | string | 是 | 网络实例的路由表 ID。 | vrt-bp1msipdczo9lejup**** |
DestinationCidrBlock | string | 是 | 路由条目的目标网段。 | 10.0.0.0/24 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "A95A100B-3F3A-56F4-A5DE-19DB7E994807"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Forbidden.VpcAsInternetGateway | It’s forbidden that using Vpc as internet gateway for your private IDC. | - |
400 | InvalidCIDRBlock.Duplicate | Specified CIDR block is already exists. | 指定的Cidr已经存在。 |
400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | 参数中指定的cidrBlock不合法。 |
400 | OperationFailed.RouteConflict | Route conflict exists in routing table. | 路由表中存在路由冲突。 |
400 | InvalidOperation.UnsupportnexthopType | The specified next hop type is not supported by this operation. | 操作不支持该nexthopType。 |
400 | IncorrectStatus.VpcRouteEntry | The resource is not in a valid state for the attachment operation. | 当前VpcRouteEntry的状态不支持该操作,请稍后重试。 |
400 | OperationDenied.RouteTableTypeNotPermitted | The operation is not allowed because of RouteTableTypeNotPermitted. | 路由表类型不支持该操作。 |
400 | InvalidParameter | Invalid parameter. | 参数不合法。 |
400 | Unauthorized | The AccessKeyId is unauthorized. | 账号无权限操作。 |
404 | InvalidAttachmentId.NotFound | The specified AttachmentId is not found. | AttachmentId不存在。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2022-12-22 | OpenAPI 错误码发生变更 | 查看变更详情 |
2021-10-23 | 新增 OpenAPI | 查看变更详情 |