IBM Cloud Docs
中継ゲートウェイの削除

中継ゲートウェイの削除

UIでトランジットゲートウェイを削除する

IBM Cloud® Transit Gateway を削除するには、以下の手順を実行します。

  1. ブラウザから IBM Cloud コンソールを開き、アカウントにログインします。

  2. 左上のナビゲーションメニュー( Navigation Menu)アイコンを選択し、 インフラストラクチャー(Infrastructure) > ネットワーク(Network) > Transit Gateway )をクリックします。

  3. 削除する中継ゲートウェイの名前をクリックします。

  4. 中継ゲートウェイに接続が関連付けられていないことを確認します。関連付けられている場合は、すべての接続を削除します。 削除する接続ごとに、その横の「アクション」メニューをクリックしてから、**「削除」**を選択します。

  5. 接続が削除されたら、中継ゲートウェイを次の 2 つの方法で削除できます。

    • Transit Gateway の詳細ページから、削除するゲートウェイの横にある「アクション」メニュー「アクション」メニューをクリックし、**「削除」**を選択します。
    • 個々の中継ゲートウェイ・ページから、**「アクション」>「削除」**を選択します。

CLIからトランジットゲートウェイを削除する

CLI から既存のゲートウェイを削除するには、以下のコマンドを入力します:

ibmcloud tg gateway-delete|gwd GATEWAY_ID [-f, --force] [-h, --help]

ここで、

  • GATEWAY_ID: 削除するゲートウェイの ID。

  • --force | -f: オプション: 確認を求めずに削除を強制します。

  • --help | -h: オプション: このコマンドのヘルプを表示します。

この例は、確認なしでゲートウェイを削除する方法を示しています。

ibmcloud tg gwd $gateway -f

APIを使用してトランジットゲートウェイを削除する

APIを使用してトランジットゲートウェイを削除するには、以下の手順に従ってください:

  1. 中継ゲートウェイからすべての接続を削除します。
  2. APIでゲートウェイの削除を要求する。

要求の例

この例は、中継ゲートウェイの削除要求を示しています。

curl -X DELETE "https://transit.cloud.ibm.com/v1/transit_gateways/$TRANSIT_GATEWAY_ID?version=2022-02-10" -H "accept: */*"

応答例

この例は、中継ゲートウェイが見つからなかったため、状況コード 404 の応答が返ってきたことを示しています。

{
  "errors": [
    {
      "code": "not_found",
      "message": "Cannot find Gateway",
      "more_info": "https://cloud.ibm.com/apidocs/transit-gateway#error-handling"
    }
  ],
  "trace": "request_id"
}

詳しくは、 Transit Gateway API リファレンスの 指定された Transit Gateway を参照してください。

Terraform を使用した中継ゲートウェイの削除

中継ゲートウェイを削除するには、次のコマンドを入力します。

terraform destroy -target=resource_type.resource_name

ここで、

  • resource_type: ibm_tg_gateway

  • resource_name: 中継ゲートウェイの名前

この例は、「new_tg_gw」という名前の中継ゲートウェイの削除を示しています。

terraform destroy -target=ibm_tg_gateway.new_tg_gw