IBM Cloud Docs
予約 IP アドレスのバインドとアンバインド

予約 IP アドレスのバインドとアンバインド

コンソール、CLI、およびAPIを使用して、予約済みIPアドレスをエンドポイント・ゲートウェイにバインドおよびアンバインドできます。

コンソールでの予約IPアドレスのバインドとアンバインド

UI を使用してエンドポイント・ゲートウェイの予約 IP アドレスをバインド/アンバインドすることができます。

予約 IP アドレスのバインド

IBM Cloud® のコンソールを使用して IP アドレスを予約またはバインドするには、次のようにします。

  1. IBM Cloudコンソール[Navigation Menu] メニューアイコン を選択し、[インフラストラクチャ]>[ネットワーク]>[仮想プライベートエンドポイントゲートウェイ]の順にクリックします。 「VPC 用の仮想プライベート・エンドポイント・ゲートウェイ (Virtual private endpoint gateways for VPC)」ページが表示されます。

  2. テーブルでゲートウェイの行をハイライトし、[Actions]メニューの ![ Reserve]または[bind IP] をクリックします。 または、ゲートウェイ名をクリックして、エンドポイント・ゲートウェイの詳細ページからこのリンクにアクセスすることもできます。

    エンドポイント・ゲートウェイの作成時に IP を予約もバインドもしなかった場合は、テーブルの「IP アドレス」列にこのリンクが表示されます。

  3. 「予約 IP (予約済み IP)」サイド・パネルで、リストされているサブネットから IP アドレスを自動選択するか、既存の IP から選択します。

    1 つのエンドポイント・ゲートウェイにバインドできる予約 IP は、ゾーンごとに 1 つだけです。 予約 IP をエンドポイント・ゲートウェイにバインドするには、既存のサブネットが必要です。 また、VPC のサブネットが同じゾーンにバインドされていないことを確認する必要もあります。

  4. エンドポイント・ゲートウェイを削除するときに、予約済み IP を自動的に削除するかどうかを指定します。 次に、**「IP アドレスの予約 (Reserve IP address)」**をクリックして、アドレスをこのエンドポイント・ゲートウェイにバインドします。

予約 IP アドレスのアンバインド

アンバインドすると、選択した予約 IP のエンドポイント・ゲートウェイへのバインドが解除されます。 ただし、その IP アドレスはまだ予約されているので、もう一度バインドすることができます。

IBM Cloud のコンソールを使用して IP アドレスをアンバインドするには、以下の手順を実行します。

  1. VPCの仮想プライベートエンドポイントゲートウェイ]ページで、表のゲートウェイの行をハイライトし、[Actions]メニューの [ Unbind IP ]をクリックします。 または、エンドポイント・ゲートウェイの詳細ページから予約 IP をアンバインドすることもできます。
  2. **「IP のアンバインド」**をクリックして、指定したサブネットからこの IP をアンバインドすることを確認します。

CLIからの予約IPアドレスのバインドとアンバインド

CLI を使用して予約 IP アドレスをバインド/アンバインドすることができます。

開始する前に、 CLI 環境をセットアップします

予約 IP のエンドポイント・ゲートウェイへのバインド

CLIから予約IPをエンドポイント・ゲートウェイにバインドするには、以下のコマンドを実行します:

  ibmcloud is endpoint-gateway-reserved-ip-bind ENDPOINT_GATEWAY \
    --reserved-ip-id RESERVED_IP_ID [--json]

ここで、

  • ENDPOINT_GATEWAY は、エンドポイント・ゲートウェイの ID です。
  • --reserved-ip-id は、ネットワーク・インターフェースの 1 次 IP として使用する予約 IP の ID です。 指定しない場合は、サブネットの使用可能なアドレスが自動的に選択されて予約されます。
  • --json は、確認を求めずに操作を強制します。

CLI を使用したエンドポイント・ゲートウェイへの予約 IP のアンバインド

CLIからエンドポイント・ゲートウェイへの予約IPのバインドを解除するには、以下のコマンドを実行します:

  ibmcloud is endpoint-gateway-reserved-ip-unbind ENDPOINT_GATEWAY \
  (--address ADDRESS | --reserved-ip-id RESERVED_IP_ID) [-f, --force]

ここで、

  • ENDPOINT_GATEWAY は、エンドポイント・ゲートウェイの ID です。
  • --address は、アンバインドする予約 IP アドレスです。
  • --reserved-ip-id は、アンバインドする予約 IP アドレスの ID です。
  • -f, --force は、確認を求めずに操作を強制します。

APIによる予約IPアドレスのバインドとアンバインド

APIを使用して予約IPアドレスをバインドまたはアンバインドするには、以下の前提条件と手順を実行します。

前提条件

API を使用して予約済み IP アドレスをバインドまたはアンバインドするには、その前に以下の前提条件を満たす必要があります。

  1. API 環境をセットアップします。

  2. API コマンドで使用する以下の値を変数に格納します。

    export EndpointGatewayId=<endpoint_gateway_id>
    export ReservedIPId=<reserved_ip_id>
    

予約 IP のエンドポイント・ゲートウェイへのバインド

特定の VPC 用のエンドポイント・ゲートウェイをバインドするには、以下の例を参照してください。

curl -X PUT
  -sH "Authorization:${iam_token}"
  "$vpc_api_endpoint/v1/endpoint_gateways/$EndpointGatewayId/ips/$ReservedIPId?version=$api_version&generation=2"

エンドポイント・ゲートウェイからの予約 IP のアンバインド

特定の VPC 用のエンドポイント・ゲートウェイをアンバインドするには、以下の例を参照してください。

curl -X DELETE
  -sH "Authorization:${iam_token}"
  "$vpc_api_endpoint/v1/endpoint_gateways/$EndpointGatewayId/ips/$ReservedIPId?version=$api_version&generation=2"