DeleteRouteEntry - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

DeleteRouteEntry 操作を呼び出して、vRouter または仮想ボーダールーター (VBR) のルートテーブルからルートを削除します。

操作説明

この操作を呼び出してルートを削除する際は、以下の項目に注意してください:

Available 状態のルートのみ削除できます。
ルートテーブルを含む VPC が vSwitch またはルートの作成・削除中である場合、ルートは削除できません。
VBR のルートテーブルからルートを削除するには、 DescribeRouteEntryList 操作を呼び出して削除するルートの NextHopId をクエリし、その後この操作を呼び出してルートを削除します。
DeleteRouteEntry 操作は非同期です。リクエストを送信すると、システムはリクエスト ID を返しますが、ルートはまだ削除されていません。削除タスクはバックグラウンドで実行されます。 DescribeRouteEntryList を呼び出してルートの削除ステータスをクエリできます:
- ルートが Deleting 状態の場合、ルートは削除中です。
- 指定されたルートが見つからない場合、ルートは削除されています。
DeleteRouteEntry 操作は、同一の VPC または VBR 内のルートテーブルからのルートの同時削除をサポートしていません。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

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	任意	ルートの送信先 CIDR ブロック。IPv4 CIDR ブロック、IPv6 CIDR ブロック、プレフィックスリスト CIDR ブロック、およびプレフィックスリストインスタンス 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 ペア、Resource Access Management (RAM) ユーザーの権限付与、および必須パラメーターを確認します。確認に失敗した場合、対応するエラーが返されます。確認に成功した場合、エラーコード `DryRunOperation` が返されます。 false (デフォルト): 通常のリクエストを送信します。確認に成功すると、2xx HTTP 状態コードが返され、ルートが削除されます。

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
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.	考えられるエラー原因: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.960.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.
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。