调用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 | Write |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 否 | 路由表所属地域的ID。 您可以通过调用DescribeRegions接口获取地域ID。 | cn-hangzhou |
| RouteTableId | string | 否 | 路由条目所在的路由表的ID。 | vtb-2ze3jgygk9bmsj23s**** |
| RouteEntryId | string | 是 | 要删除的路由条目ID。 | rte-bp1mnnr2al0naomnpv**** |
| DestinationCidrBlock | string | 否 | 路由条目的目标网段，支持IPv4和IPv6网段。 | 47.100.XX.XX/16 |
| NextHopId | string | 否 | 下一跳实例的ID。
| ri-2zeo3xzyf38r4urzd**** |
| NextHopList | 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处于中间态，无法操作 |
| 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. | - |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2023-09-06 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
| 2023-08-15 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
| 2023-08-03 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
| 2023-07-20 | OpenAPI 描述信息更新，OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
| ||||||||||||
| 2023-05-08 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||||
|