すべてのプロダクト
Search

このプロダクト

    Virtual Private Cloud:DeleteRouteEntries

    ドキュメントセンター

    Virtual Private Cloud:DeleteRouteEntries

    最終更新日:Apr 27, 2026

    複数のカスタムルートエントリを一度に削除します。

    操作説明

    本 API を呼び出してルートエントリを削除する際は、以下の点にご注意ください。

    • Available 状態のルートエントリのみ削除可能です。

    • ルートテーブルが属する VPC でスイッチまたはルートエントリの作成・削除が進行中の場合、ルートエントリを削除できません。

    • DeleteRouteEntries API は非同期インターフェースです。システムはリクエスト ID を返しますが、その時点でルートエントリの削除は完了しておらず、バックグラウンドで削除タスクが実行中です。DescribeRouteEntryList を呼び出して、ルートエントリの削除状態を確認できます。

      • ルートエントリが Deleting 状態の場合、削除処理中であることを示します。

      • 指定したルートエントリが検索結果に含まれない場合、削除が成功したことを示します。

    • DeleteRouteEntries API は、同一 VPC 内のルートテーブルに対して並列で一括削除を行うことはサポートしていません。

    今すぐお試しください

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

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    ルートテーブルが存在するリージョン ID です。

    最新のリージョンリストは、DescribeRegions 操作を呼び出して確認できます。

    cn-hangzhou
    RegionId

    string

    必須

    ルートテーブルが存在するリージョン ID です。

    最新のリージョンリストは、DescribeRegions 操作を呼び出して確認できます。

    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

    任意

    削除対象のルートの宛先 CIDR ブロックです。IPv4 および IPv6 CIDR ブロックがサポートされています。最大 50 個の宛先 CIDR ブロックを指定できます。

    説明

    RouteEntryId を指定しない場合、DstCidrBlock および NextHop は必須です。

    47.100.XX.XX/24
    NextHop

    string

    任意

    削除対象のネクストホップの ID です。最大 50 個のネクストホップ ID を指定できます。

    説明

    RouteEntryId を指定しない場合、DstCidrBlock および NextHop は必須です。

    i-j6c2fp57q8rr4jlu****
    DryRun

    boolean

    任意

    ドライラン（実際の操作を行わず検証のみ実施）を行うかどうかを指定します。有効値は次のとおりです。

    • true：ドライランのみを実行します。システムは、パラメーター値の欠落、リクエスト構文の誤り、サービス制限など、潜在的な問題をチェックします。ドライランに失敗した場合はエラーメッセージが返されます。ドライランに成功した場合は、DryRunOperation エラーコードが返されます。

    • false（デフォルト）：ドライランを実行し、その後実際にリクエストを実行します。ドライランに成功した場合、HTTP ステータスコード 2xx が返され、操作が実行されます。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    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

    削除に失敗したルートエントリの宛先 CIDR ブロックです。IPv4 および IPv6 CIDR ブロックがサポートされています。

    47.100.XX.XX/24
    NextHop

    string

    削除に失敗したネクストホップの ID です。

    i-j6c2fp57q8rr4jlu****
    FailedCode

    string

    エラーコードです。

    VPC_ROUTER_ENTRY_NOT_EXIST
    FailedMessage

    string

    エラーメッセージです。

    vRouterEntry not exists

    例

    成功レスポンス

    JSONJSON

    {
  "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 ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 DryRunOperation Request validation has been passed with DryRun flag set.
    400 TaskConflict The operation is too frequent. Please wait a moment and try again.

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

    変更履歴

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