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.
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.
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..
400	IncorrectStatus.PrefixList	The status of prefixList is incorrect.
400	InvalidCidrBlock	Specified CIDR block is not valid.
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.
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.
404	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance not found.

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

變更歷史

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