調用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 | *RouteTable acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| 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. | 由于邊界路由器正處于加載或者卸載專線網關過程中，當前操作無法執行，請您稍等后重試。 |
| 400 | UnsupportedFeature.NextHopType | The operation is not allowed because the NextHopType of specified RouteEntry is modified from Local type. | 操作不允許，因為路由的下一跳類型修改自Local類型。 |
| 400 | TaskConflict | The operation is too frequent, please wait a moment and try again. | 操作過于頻繁，請稍等一會再重試 |
| 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-10-28 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 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 錯誤碼發生變更 | 查看變更詳情 |