调用DeleteRouteEntry删除VPC路由器或边界路由器的路由表中的路由条目。
接口说明
调用本接口删除路由条目时,请注意:
-
只有处于 Available 状态的路由条目可以被删除。
-
路由表所在的 VPC 正在进行创建或删除交换机或路由条目时,无法删除路由条目。
-
如果需要删除边界路由器的路由表中的路由条目,请通过 DescribeRouteEntryList 接口查询要删除的路由条目的 NextHopId 后,再通过本接口删除路由条目。
-
DeleteRouteEntry 接口属于异步接口,即系统会返回一个请求 ID,但该路由条目尚未删除成功,系统后台的删除任务仍在进行。您可以调用 DescribeRouteEntryList 查询路由条目的删除状态:
- 当路由条目处于 Deleting 状态时,表示路由条目正在删除中。
- 当查询不到指定的路由条目时,表示路由条目删除成功。
-
DeleteRouteEntry 接口不支持在同一个 VPC 或者同一个 VBR 中并发删除路由表中的路由条目。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
vpc:DeleteRouteEntry | delete |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 否 | 路由表所属地域的 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 | cn-hangzhou |
RouteTableId | string | 否 | 路由条目所在的路由表的 ID。 说明
当 RouteEntryId 参数未输入时,DestinationCidrBlock 和 RouteTableId 参数必填,并根据需求配置 NextHopId 或 NextHopList 参数。
| vtb-2ze3jgygk9bmsj23s**** |
RouteEntryId | string | 否 | 要删除的路由条目 ID,和 DestinationCidrBlock 参数互斥。 说明
当 DestinationCidrBlock 参数未输入时,RouteEntryId 参数必填。
| rte-bp1mnnr2al0naomnpv**** |
DestinationCidrBlock | string | 否 | 路由条目的目标网段,支持 IPv4 网段、IPv6 网段、前缀列表网段和前缀列表的实例 ID,和 RouteEntryId 参数互斥。 说明
当 RouteEntryId 参数未输入时,DestinationCidrBlock 和 RouteTableId 参数必填,并根据需求配置 NextHopId 或 NextHopList 参数。
| 47.100.XX.XX/16 |
NextHopId | string | 否 | 下一跳实例的 ID。
| ri-2zeo3xzyf38r4urzd**** |
NextHopList | array<object> | 否 | ECMP 路由的下一跳实例信息。最多支持 16 个下一跳实例信息。 | |
object | 否 | ECMP 路由条目的下一跳实例信息。最多支持 16 个下一跳实例信息。 | ||
NextHopId | string | 否 | ECMP 路由条目的下一跳实例的 ID。最多支持 16 个下一跳实例信息。 | ri-2zeo3xzyf38r43cd**** |
NextHopType | string | 否 | ECMP 路由的下一跳的类型,目前只能取值 RouterInterface(路由器接口)。最多支持 16 个下一跳实例信息。 | RouterInterface |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter | Miss mandatory parameter. | 缺少必要参数,请您检查必填参数是否都已填后再进行操作。 |
400 | IncorrcetRouteEntryStatus | Some route entry status blocked this operation. | 无法执行该操作,因为有些路由条目的状态是pending或modifying。 |
400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | 该CIDR格式不正确。 |
400 | OperationDenied | Specified operation is denied as route entry type is system. | 无法执行该操作,因为路由条目是系统路由。 |
400 | InvalidRouteEntry.NotFound | Route entry not exists. | 该路由条目不存在,请您检查路由条目是否正确。 |
400 | InvalidVRouter.NotFound | vRouter not exists. | 路由器不存在,请您检查输入的路由器是否正确。 |
400 | IncorrectRouteEntryStatus | Some route entry status blocked this operation. | 无法执行该操作,当前路由表中有路由条目的状态为pending或modifying。 |
400 | IncorrectRouteEntryStatus | VBR has NotStable route entry. | 无法执行该操作,边界路由表中有路由条目的状态为pending或modifying。 |
400 | IncorrectRouteEntryStatus | Specified routeEntry status error. | 无法执行该操作,当前路由表中有路由条目的状态为pending或modifying。 |
400 | Forbbiden | Specified RouteEntry cannot allowed delete by openApi. | 不允许使用API删除该路由条目。 |
400 | InvalidNextHop | Specified nexthop and nexthop list cannot both null. | 下一跳和下一跳列表不能同时为空。 |
400 | InvalidRouteEntry | Specified routeEntry not exist. | 该路由条目不存在。 |
400 | Forbidden.VRouterNotFound | pecified virtual switch is not found during access authentication. | - |
400 | TaskConflict | The operation is too frequent, TaskConflict. | 操作太频繁,请稍后重试 |
400 | InvalidRouteEntryId.NotFound | Specified RouteEntryId does not exist. | 指定的路由条目未找到 |
400 | IncorrectVpcStatus | Current VPC status does not support this operation. | 当前VPC的状态无法支持这个操作。 |
400 | InvalidVpnInstanceId.NotFound | %s | - |
400 | ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock | %s | - |
400 | InvalidNextHopList.Size | Nexthop list size should be between 2 and 16 | - |
400 | ParamExclusive.NextHopIdAndList | NextHopId and NextHopList cannot both be not null. | - |
400 | OperationFailed.DeleteMultiScopeEntry | Multi or ecmp scope must delete with force. | - |
400 | OperationFailed.DistibuteLock | Distibute lock fail. | 操作被其他请求加锁; |
400 | OperationDenied.DeleteManagedRouteEntry | The operation is not allowed because of route entry is managed. | 无法删除被云服务托管的路由。 |
400 | OperationDenied.RouteTableTypeNotPermitted | The operation is not allowed because the type of route table is not permitted. | 指定路由表类型不允许创建路由条目 |
400 | IncorrectStatus.VpcRouteEntry | The status of the specified routeEntry is invalid. | VPC路由条目状态不正确。 |
400 | OperationDenied.NextHopNotChanged | The operation is not allowed because of NextHopNotChanged. | 制定操作被禁止,因为下一跳未发生改变 |
400 | OperationDenied.DeleteGatewayEndpointRoute | The operation is not allowed to delete route entry pointing gateway endpoint.. | 无法手动删除指向GatewayEndpoint的路由。 |
400 | IncorrectStatus.PrefixList | The status of prefixList is incorrect. | PrefixList处于中间态,无法操作 |
400 | InvalidNextHopList.Size | Has more than one nexthop. | 路由存在多个下一跳。 |
400 | InvalidCidrBlock | Specified CIDR block is not valid. | 可能的报错原因: 1. 您不在10.0.0.0/8的路由网段的白名单中,不能使用该网段。 2. 添加的自定义路由目标网段不能从属于同一个VPC下面所有交换机的网段。 3. 由于100.64.0.0/10是云服务地址,您不能再添加该网段指向云下IDC。 4. 除100.64.0.0/10以外,100.64.0.0/11、100.96.0.0/11等明细路由网段均不能使用在云下IDC。 |
400 | OperationDenied.VbrAttachEcrInMiddleStatus | The operation is not allowed because of VBR attach or detach ECR in middle status. | 由于边界路由器正处于加载或者卸载专线网关过程中,当前操作无法执行,请您稍等后重试。 |
404 | InvalidRouteTableId.NotFound | Specified route table does not exist. | 该路由表不存在。 |
404 | InvalidVpcId.NotFound | Specified value of VpcId is not found in our record. | 该VPC不存在,请您检查输入的VPC是否正确。 |
500 | Vpc.Error | error code 500,Internal server error. | - |
500 | Internal.Error | The request processing has failed due to some unknown error, exception or failure. | - |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2024-06-19 | OpenAPI 错误码发生变更 | 查看变更详情 |
2024-06-05 | OpenAPI 错误码发生变更 | 查看变更详情 |
2024-06-03 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-09-06 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-08-15 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-08-03 | OpenAPI 错误码发生变更 | 查看变更详情 |
2023-07-20 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |
2023-05-08 | OpenAPI 错误码发生变更 | 查看变更详情 |