Déplacer une adresse IPv4 externe vers un autre projet

Les adresses IPv4 externes statiques sont associées à un projet Google Cloud et ne peuvent être utilisées que dans ce projet. Cependant, vous pouvez déplacer une adresse IPv4 externe statique d'un projet à un autre.

Rôles et autorisations IAM

Pour déplacer une adresse IP régionale, vous devez disposer des autorisations suivantes :

  • compute.addresses.delete dans le projet source
  • compute.addresses.create dans le projet de destination

Pour déplacer une adresse IP globale, vous devez disposer des autorisations suivantes :

  • compute.globalAddresses.delete dans le projet source
  • compute.globalAddresses.create dans le projet de destination

Exemples de rôles qui incluent ces autorisations :

Avant de commencer

Limites

  • Si vous annulez l'attribution d'une adresse IP, vous devez attendre un certain temps avant de la déplacer :

    • Pour les adresses IP globales, attendez 10 minutes.
    • Pour les adresses IP régionales, attendez 20 minutes.

  • Vous ne pouvez pas modifier la région d'une adresse IP régionale.

  • Vous ne pouvez pas convertir une adresse IP globale en adresse IP régionale ou une adresse IP régionale en adresse globale.

Quotas

Le nombre d'adresses que vous pouvez déplacer par minute est limité. Pour plus d'informations, vérifiez quels sont les quotas par projet dans la documentation VPC.

Déplacer une adresse IPv4 externe vers un autre projet

Vous pouvez déplacer une adresse IPv4 externe régionale ou globale d'un projet à un autre. Lorsque vous déplacez l'adresse IP, le même nom et la même description sont attribués par défaut à la ressource d'adresse IP. Vous pouvez cependant choisir d'attribuer un nouveau nom ou une nouvelle description. Une fois l'adresse IPv4 externe déplacée vers un nouveau projet, vous pouvez l'attribuer aux ressources éligibles de ce projet.

Console

  1. Dans la console Google Cloud, accédez à Adresses IP.

    Accéder à la page "Adresses IP"

  2. Dans le menu Autres actions () de l'adresse IP que vous souhaitez déplacer, sélectionnez Déplacer vers un autre projet.

  3. Cliquez sur Sélectionner un projet, puis sélectionnez le projet vers lequel vous souhaitez déplacer l'adresse IP.

  4. Facultatif : saisissez un nouveau nom pour l'adresse IP.

  5. Facultatif : saisissez une nouvelle description pour l'adresse IP.

  6. Cliquez sur Déplacer.

gcloud

Les options de commande varient selon que vous déplacez une adresse IP régionale ou globale et que vous conservez ou remplacez le nom ou la description de l'adresse. Les exemples suivants décrivent certaines de ces combinaisons.

  • Déplacez une adresse IPv4 externe régionale vers un autre projet :

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

  • Déplacez une adresse IPv4 externe régionale vers un autre projet, et attribuez-lui un nouveau nom et une nouvelle description dans le nouveau projet :

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

  • Déplacez une adresse IPv4 externe globale vers un autre projet :

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

Remplacez les éléments suivants :

  • ADDRESS_NAME : nom de la ressource d'adresse IP que vous souhaitez déplacer.
  • TARGET_PROJECT : nom ou ID du projet vers lequel vous souhaitez déplacer l'adresse IP.
  • REGION : région de l'adresse IP.
  • NEW_NAME : nouveau nom de la ressource d'adresse IP dans le nouveau projet.
  • NEW_DESCRIPTION : nouveau nom de la ressource d'adresse IP dans le nouveau projet. En cas d'omission, la description existante, le cas échéant, est utilisée pour la ressource.

Pour plus d'informations, consultez la documentation de référence gcloud compute addresses move.

API

Les détails de la requête varient selon que vous déplacez une adresse IP régionale ou globale et que vous conservez ou remplacez le nom ou la description de l'adresse. Les exemples suivants décrivent certaines de ces combinaisons.

  • Déplacez une adresse IPv4 externe régionale vers un autre projet :

    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",
}

  • Déplacez une adresse IPv4 externe régionale vers un autre projet, et attribuez-lui un nouveau nom et une nouvelle description dans le nouveau projet :

    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",
}

  • Déplacez une adresse IPv4 externe globale vers un autre projet :

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

Remplacez les éléments suivants :

  • ADDRESS_NAME : nom de la ressource d'adresse IP que vous souhaitez déplacer.
  • SOURCE_PROJECT : nom ou ID du projet vers lequel vous souhaitez déplacer l'adresse IP.
  • TARGET_PROJECT : nom ou ID du projet vers lequel vous souhaitez déplacer l'adresse IP.
  • REGION : région de l'adresse IP.
  • NEW_NAME : nouveau nom de la ressource d'adresse IP dans le nouveau projet.
  • NEW_DESCRIPTION : nouveau nom de la ressource d'adresse IP dans le nouveau projet. En cas d'omission, la description existante, le cas échéant, est utilisée pour la ressource.

Dépannage

Échec du transfert d'une adresse IPv4 externe

Le message d'erreur suivant peut s'afficher lorsque vous essayez de déplacer une adresse IPv4 externe :

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

Si ce message s'affiche, cela signifie que l'adresse IP a été réservée par l'assistance Cloud dans le cadre d'une plage d'adresses IP contiguës. Pour déplacer une adresse IP de ce type, contactez l'assistance Cloud. L'assistance Cloud peut déplacer l'ensemble de la plage d'adresses IP vers un autre projet. Il n'est pas possible de déplacer qu'une partie de la plage.

Pour vérifier si une adresse IP fait partie d'une plage réservée par l'assistance Cloud, procédez comme suit :

  1. Répertorier les adresses IP externes statiques, puis recherchez l'adresse IP que vous souhaitez vérifier.
  2. Vérifiez le nom de l'adresse IP. Si l'adresse IP a été réservée par l'assistance Cloud, son nom se compose d'une chaîne suivie des quatre octets de l'adresse IP, séparés par des traits d'union. Par exemple, si une adresse IP est 198.51.100.2 et qu'elle a été réservée par l'assistance Cloud, le nom se présente sous la forme suivante : STRING-198-51-100-2. Les autres adresses IP réservées dans la même plage partagent la même chaîne, suivie de leurs adresses IP.