外部 IPv4 アドレスを別のプロジェクトに移動する

静的外部 IPv4 アドレスは Google Cloud プロジェクトに関連付けられ、そのプロジェクト内でのみ使用できます。ただし、プロジェクト間で静的外部 IPv4 アドレスを移動することはできます。

IAM のロールと権限

リージョン IP アドレスを移動するには、次の権限が必要です。

  • ソース プロジェクトの compute.addresses.delete
  • 宛先プロジェクトの compute.addresses.create

グローバル IP アドレスを移動するには、次の権限が必要です。

  • ソース プロジェクトの compute.globalAddresses.delete
  • 宛先プロジェクトの compute.globalAddresses.create

これらの権限を含むロールの例:

始める前に

制限事項

  • IP アドレスの割り当てを解除した場合は、しばらく待ってから移動する必要があります。

    • グローバル IP アドレスの場合は 10 分待ちます。
    • リージョン IP アドレスの場合は 20 分待ちます。

  • リージョン IP アドレスのリージョンは変更できません。

  • グローバル IP アドレスをリージョン IP アドレスに変換することはできません。また、その逆の変換もできません。

割り当て

1 分間に移動できるアドレスの数には上限があります。詳細については、次に示す、VPC ドキュメントのプロジェクトごとの割り当てをご覧ください。

外部 IPv4 アドレスを別のプロジェクトに移動する

リージョンまたはグローバルの外部 IPv4 アドレスをプロジェクト間で移動できます。IP アドレスを移動すると、デフォルトでは IP アドレス リソースに同じ名前と説明が割り当てられます。ただし、新しい名前または説明を自分で割り当てることができます。外部 IPv4 アドレスを新しいプロジェクトに移動した後、そのプロジェクトの適格リソースに割り当てることができます。

コンソール

  1. Google Cloud コンソールで、[IP アドレス] に移動します。

    [IP アドレス] に移動

  2. 移動する IP アドレスの [その他の操作] メニュー（）で、[別のプロジェクトに移動] を選択します。

  3. [プロジェクトの選択] をクリックし、IP アドレスの移動先となるプロジェクトを選択します。

  4. 省略可: IP アドレスの新しい名前を入力します。

  5. 省略可: IP アドレスの新しい説明を入力します。

  6. [移動] をクリックします。

gcloud

コマンド オプションは、リージョン IP アドレスとグローバル IP アドレスのどちらを使用するか、またアドレス名や説明をそのまま保持するかどうかによって異なります。次の例では、これらの組み合わせの一部について説明します。

  • リージョン外部 IPv4 アドレスを別のプロジェクトに移動します。

    gcloud compute addresses move ADDRESS_NAME \
    --target-project=TARGET_PROJECT \
    --region=REGION

  • リージョン外部 IPv4 アドレスを別のプロジェクトに移動し、新しいプロジェクトに新しい名前と説明を割り当てます。

    gcloud compute addresses move ADDRESS_NAME \
    --target-project=TARGET_PROJECT \
    --new-name=NEW_NAME \
    --description=NEW_DESCRIPTION \
    --region=REGION

  • グローバル外部 IPv4 アドレスを別のプロジェクトに移動します。

    gcloud compute addresses move ADDRESS_NAME \
    --target-project=TARGET_PROJECT \
    --global

次のように置き換えます。

  • ADDRESS_NAME: 移動する IP アドレス リソースの名前。
  • TARGET_PROJECT: IP アドレスの移動先となるプロジェクトの名前または ID。
  • REGION: IP アドレスのリージョン。
  • NEW_NAME: 新しいプロジェクトの IP アドレス リソースの新しい名前。
  • NEW_DESCRIPTION: 新しいプロジェクトの IP アドレス リソースの新しい名前。省略した場合は、既存の説明（存在する場合）がリソースに使用されます。

詳細については、gcloud compute addresses move リファレンス ドキュメントをご覧ください。

API

リクエストの詳細は、リージョン IP アドレスとグローバル IP アドレスのどちらを移動するのかと、アドレス名や説明を保持するかどうかによって異なります。次の例では、これらの組み合わせの一部について説明します。

  • リージョン外部 IPv4 アドレスを別のプロジェクトに移動します。

    POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move
{
  "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME",
}

  • リージョン外部 IPv4 アドレスを別のプロジェクトに移動し、新しいプロジェクトに新しい名前と説明を割り当てます。

    POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/regions/REGION/addresses/ADDRESS_NAME/move
{
  "destination_address": "projects/TARGET_PROJECT/global/addresses/NEW_NAME",
  "description": "NEW_DESCRIPTION",
}

  • グローバル外部 IPv4 アドレスを別のプロジェクトに移動します。

    POST https://www.googleapis.com/compute/v1/projects/SOURCE_PROJECT/global/addresses/ADDRESS_NAME/move
{
  "destination_address": "projects/TARGET_PROJECT/global/addresses/ADDRESS_NAME",
}

次のように置き換えます。

  • ADDRESS_NAME: 移動する IP アドレス リソースの名前。
  • SOURCE_PROJECT: IP アドレスの移動先となるプロジェクトの名前または ID。
  • TARGET_PROJECT: IP アドレスの移動先となるプロジェクトの名前または ID。
  • REGION: IP アドレスのリージョン。
  • NEW_NAME: 新しいプロジェクトの IP アドレス リソースの新しい名前。
  • NEW_DESCRIPTION: 新しいプロジェクトの IP アドレス リソースの新しい名前。省略した場合は、既存の説明（存在する場合）がリソースに使用されます。

トラブルシューティング

外部 IPv4 アドレスの移動に失敗する

外部 IPv4 アドレスを移動しようとすると、次のエラー メッセージが表示されることがあります。

Invalid resource usage: 'Cannot move address that belongs to a reserved address range. Address range must be disassembled first.'

このメッセージが表示された場合は、IP アドレスが連続する IP アドレス範囲の一部として Cloud サポートによって予約されていることを意味します。このタイプの IP アドレスを移動するには、Cloud サポートにお問い合わせください。Cloud サポートは IP アドレス範囲全体を別のプロジェクトに移動できます。範囲の一部のみを移動することはできません。

IP アドレスが Cloud サポートによって予約された範囲の一部かどうかを確認するには、次の操作を行います。

  1. 静的外部 IP アドレスを一覧表示して、確認する IP アドレスを見つけます。
  2. IP アドレスの名前を確認します。IP アドレスが Cloud サポートによって予約されている場合、その名前は文字列と IP アドレスの 4 バイトをハイフンで区切ったもので構成されます。たとえば、IP アドレスが 198.51.100.2 で、Cloud サポートによって予約されている場合、名前の形式は STRING-198-51-100-2 のようになります。同じ範囲の一部として予約された他の IP アドレスは、同じ文字列の後に IP アドレスが続きます。