DeleteRouteEntry - Virtual Private Cloud

呼叫 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。刪除 ECMP 外的其他路由項目時，請設定 NextHopId，無需設定 NextHopList。刪除 ECMP 路由項目時，請設定 NextHopList，無需設定 NextHopId。	ri-2zeo3xzyf38r4urzd****
NextHopList	array<object>	否	ECMP 路由的下一跳執行個體資訊。最多支援 16 個下一跳執行個體資訊。
	object	否	ECMP 路由項目的下一跳執行個體資訊。最多支援 16 個下一跳執行個體資訊。
NextHopId	string	否	ECMP 路由項目的下一跳執行個體的 ID。最多支援 16 個下一跳執行個體資訊。	ri-2zeo3xzyf38r43cd****
NextHopType	string	否	ECMP 路由的下一跳的類型，目前只能取值 RouterInterface（路由器介面）。最多支援 16 個下一跳執行個體資訊。	RouterInterface
DryRun	boolean	否	是否只預檢此次請求，取值： true：傳送請求，不會刪除路由項目。檢查項目包括 AccessKey 是否有效、RAM 使用者的授權情況和是否填寫了必需參數。如果檢查未通過，則傳回對應錯誤。如果檢查通過，會傳回錯誤碼 `DryRunOperation`。 false（預設值）：傳送正常請求，通過檢查後傳回 2xx HTTP 狀態碼並直接刪除路由項目。

返回參數

名稱	類型	描述	樣本值
	object	傳回資訊。
RequestId	string	請求 ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

樣本

正常返回樣本

JSON格式

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	MissingParameter	Miss mandatory parameter.
400	IncorrcetRouteEntryStatus	Some route entry status blocked this operation.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
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.
400	Forbbiden	Specified RouteEntry cannot allowed delete by openApi.
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.	EIP 操作太頻繁。
400	InvalidRouteEntryId.NotFound	Specified RouteEntryId does not exist.	指定的路由條目不存在。
400	IncorrectVpcStatus	Current VPC status does not support this operation.
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	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.	目前路由項目不支援修改下一跳資訊。
400	ResourceNotFound.PrefixList	The specified resource of prefixList is not found.	輸入的 prefixList 不存在。
400	IncorrectStatus.PrefixListRelation	The related prefix list relation is in an intermediate state and cannot perform the current operation.
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.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	請求處理由於某些未知錯誤失敗。
404	InvalidRouteTableId.NotFound	Specified route table does not exist.
404	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.	該 VPC 不存在，請您檢查輸入的 VPC 是否正確。
404	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance not found.	未找到 GatewayLoadBalancerEndpoint 執行個體。

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

變更歷史

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