DeleteRouteEntries - 大量刪除自訂路由條目 - Virtual Private Cloud

調用DeleteRouteEntries大量刪除自訂路由條目。

介面說明

調用本介面刪除路由條目時，請注意：

只有處於 Available 狀態的路由條目可以被刪除。
路由表所在的 VPC 進行中建立或刪除交換器或路由條目時，無法刪除路由條目。
DeleteRouteEntries 介面屬於非同步介面，即系統會返回一個請求 ID，但該路由條目尚未刪除成功，系統背景刪除任務仍在進行。您可以調用 DescribeRouteEntryList 查詢路由條目的刪除狀態：
- 當路由條目處於 Deleting 狀態時，表示路由條目正在刪除中。
- 當查詢不到指定的路由條目時，表示路由條目刪除成功。
DeleteRouteEntries 介面不支援在同一個 VPC 中並發大量刪除路由表中的路由條目。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	路由表所屬地區的 ID。您可以通過調用 DescribeRegions 介面擷取地區 ID。	cn-hangzhou
RegionId	string	是	路由表所屬地區的 ID。您可以通過調用 DescribeRegions 介面擷取地區 ID。	cn-hangzhou
RouteEntries	array<object>	否	要刪除的路由條目資訊。
	object	否	要刪除的路由條目資訊。
RouteTableId	string	是	要刪除的路由條目所在的路由表的 ID。最多支援輸入 50 個路由表 ID。	vtb-2ze3jgygk9bmsj23s****
RouteEntryId	string	否	要刪除的路由條目 ID。最多支援輸入 50 個路由條目 ID。說明當 RouteEntryId 參數未輸入時，DstCidrBlock 和 NextHop 參數必填。	rte-bp1mnnr2al0naomnpv****
DstCidrBlock	string	否	要刪除的路由條目的目標網段，支援 IPv4 網段、IPv6 網段和首碼列表網段。最多支援輸入 50 個目標網段。說明當 RouteEntryId 參數未輸入時，DstCidrBlock 和 NextHop 參數必填。	47.100.XX.XX/24
NextHop	string	否	要刪除的下一跳執行個體的 ID。最多支援輸入 50 個執行個體 ID。說明當 RouteEntryId 參數未輸入時，DstCidrBlock 和 NextHop 參數必填。	i-j6c2fp57q8rr4jlu****
DryRun	boolean	否	是否只預檢此次請求，取值： true：發送請求，不會刪除路由條目。檢查項包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查不通過，則返回對應錯誤。如果檢查通過，會返回錯誤碼`DryRunOperation`。 false（預設值）：發送正常請求，通過檢查後返回 2xx HTTP 狀態代碼並直接刪除路由條目。

返回參數

名稱	類型	描述	樣本值
	object	返回資訊。
RequestId	string	請求 ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
SuccessCount	integer	刪除成功的路由條目數。	2
FailedCount	integer	刪除失敗的路由條目數。	2
FailedRouteEntries	array<object>	刪除失敗的路由條目資訊。
	object	刪除失敗的路由條目資訊。
RouteEntryId	string	刪除失敗的路由條目 ID。	rte-bp1mnnr2al0naomnpv****
DstCidrBlock	string	刪除失敗的路由條目的目標網段，支援 IPv4 網段、IPv6 網段和首碼列表網段。	47.100.XX.XX/24
NextHop	string	刪除失敗的下一跳執行個體 ID。	i-j6c2fp57q8rr4jlu****
FailedCode	string	失敗的錯誤碼。	VPC_ROUTER_ENTRY_NOT_EXIST
FailedMessage	string	失敗的具體報錯資訊。	vRouterEntry not exists

樣本

正常返回樣本

JSON格式

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "SuccessCount": 2,
  "FailedCount": 2,
  "FailedRouteEntries": [
    {
      "RouteEntryId": "rte-bp1mnnr2al0naomnpv****",
      "DstCidrBlock": "47.100.XX.XX/24",
      "NextHop": "i-j6c2fp57q8rr4jlu****",
      "FailedCode": "VPC_ROUTER_ENTRY_NOT_EXIST",
      "FailedMessage": "vRouterEntry not exists"
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	DryRunOperation	Request validation has been passed with DryRun flag set.	DryRun校正通過。
400	TaskConflict	The operation is too frequent. Please wait a moment and try again.	當前操作太頻繁，請稍後重試。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。