Réserver une adresse IP statique externe

Vous pouvez réserver les adresses IP externes statiques. Vous pouvez également répertorier et libérer vos adresses IP externes statiques réservées. Pour attribuer une adresse IP externe statique à une instance de machine virtuelle (VM), consultez la page Configurer des adresses IP externes statiques.

Les adresses IP externes peuvent être statiques ou éphémères. Si une VM nécessite une adresse IP externe fixe qui ne change pas, vous pouvez l'obtenir de l'une des façons suivantes : Vous pouvez réserver de nouvelles adresses IP externes ou convertir des adresses IP externes éphémères existantes.

Si vous avez besoin d'une adresse IP interne statique, consultez la page Réserver une adresse IP interne statique.

Avant de commencer

  • En savoir plus sur les adresses IP.
  • En savoir plus sur les quotas et limites pour les adresses IP externes statiques.
  • Consultez la section sur la tarification des adresses IP externes.
  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier comme suit :

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    Install the Google Cloud CLI, then initialize it by running the following command:

    gcloud init

    Terraform

    Pour utiliser les exemples Terraform de cette page dans un environnement de développement local, installez et initialisez gcloud CLI, puis configurez le service Identifiants par défaut de l'application à l'aide de vos identifiants utilisateur.

    1. Install the Google Cloud CLI.
    2. To initialize the gcloud CLI, run the following command:

      gcloud init
    3. If you're using a local shell, then create local authentication credentials for your user account:

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

    Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local dans la documentation sur l'authentification Google Cloud.

    REST

    Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

      Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init

    Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Rôles requis

Pour obtenir les autorisations nécessaires pour réserver et gérer des adresses IP statiques, demandez à votre administrateur de vous accorder le rôle IAM Administrateur de réseaux Compute (roles/compute.networkAdmin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient les autorisations requises pour réserver et gérer des adresses IP statiques. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour réserver et gérer des adresses IP statiques :

  • compute.addresses.create sur l'adresse IP
  • compute.addresses.createInternal sur l'adresse IP
  • compute.networks.list sur le réseau
  • compute.subnetworks.use sur le sous-réseau
  • compute.subnetworks.list sur le sous-réseau

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

À propos des adresses IP externes statiques

Une adresse IP externe statique est une adresse IP réservée pour votre ressource jusqu'à ce que vous décidiez de la libérer. Si vous disposez d'une adresse IP qui permet à vos clients ou utilisateurs d'accéder à votre service, vous pouvez réserver cette adresse IP pour qu'elle ne puisse être utilisée que par votre ressource. Vous pouvez également convertir une adresse IP externe éphémère en adresse IP externe statique.

Pour en savoir plus, consultez la section Adresses IP.

Le tableau suivant répertorie les adresses IP externes statiques compatibles avec Google Cloud.

Type d'adresse IP Ressource Plage d'adresses IP Source Associée à
Adresses IPv6 externes régionales VM et équilibreurs de charge régionaux /32 Pool d'adresses IP externes de Google Projet
Adresses IPv6 externes régionales VM et équilibreurs de charge régionaux compatibles /96 Plage d'adresses IPv6 externe du sous-réseau Sous-réseau
Adresses IPv4 externes globales Équilibreurs de charge mondiaux /32 Pool d'adresses IP externes de Google Projet
Adresses IPv6 externes globales Équilibreurs de charge mondiaux /64 Pool d'adresses IP externes de Google Projet

Pour consulter la liste des équilibreurs de charge régionaux et globaux, reportez-vous au Récapitulatif des types d'équilibreurs de charge.

Limites

  • Une adresse IP externe statique peut être utilisée par une seule ressource à la fois.

  • Il n'y a aucun moyen de vérifier si une adresse IP est statique ou éphémère après son attribution à une ressource. Vous pouvez comparer l'adresse IP à la liste des adresses IP externes statiques réservées pour ce projet. Exécutez la sous-commande gcloud compute addresses list pour afficher la liste des adresses IP externes statiques disponibles pour le projet.

  • Chaque VM peut avoir plusieurs interfaces réseau, et chaque interface peut avoir les adresses IP suivantes :

    • Une adresse IPv4 interne (obligatoire)
    • Une adresse IPv4 externe
    • Une plage d'adresses IPv6 /96, internes ou externes, mais pas les deux
  • Vous ne pouvez pas modifier le nom d'une adresse IP statique.

  • Les adresses IP externes attribuées existent sur le même hôte physique que la VM et existent dans la même région que la VM à toutes fins, y compris pour le routage, la latence et les tarifs. Cela est valable quelles que soient les informations de recherche de géolocalisation Internet.

Remarque : Les interfaces réseau peuvent recevoir du trafic provenant de plusieurs règles de transfert, qui peuvent diffuser d'autres adresses IP externes. Le nombre d'adresses IP externes pouvant faire référence à une interface réseau via ces règles de transfert est libre, en revanche, chaque interface réseau ne peut se voir attribuer qu'une seule adresse IPv4 externe et une seule plage d'adresses IPv6 externes /96.

Pour en savoir plus sur l'équilibrage de charge et les règles de transfert, consultez la documentation sur l'équilibrage de charge.

Réserver une nouvelle adresse IP externe statique

Une fois l'adresse réservée, attribuez-la à une nouvelle VM lors de sa création ou à une VM existante.

Console

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

    Accéder à la page "Adresses IP"

  2. Cliquez sur Réserver une adresse IP statique externe.
  3. Dans le champ Nom, saisissez un nom d'adresse IP.
  4. Indiquez si le niveau de service réseau est Premium ou Standard. La réservation d'adresse statique IPv6 n'est acceptée qu'avec le niveau Premium.
  5. Indiquez s'il s'agit d'une adresse IPv4 ou IPv6.
  6. Choisissez si cette adresse IP est régionale ou globale.
    • Si vous réservez une adresse IP statique pour un équilibreur de charge global, sélectionnez Global, puis cliquez sur Réserver.
    • Si vous réservez une adresse IP statique pour une VM ou pour un équilibreur de charge régional, sélectionnez Régional, puis sélectionnez la région dans laquelle créer l'adresse.
  7. Si vous réservez une adresse IPv6 externe régionale, choisissez également les éléments suivants :

    • Réseau : le réseau VPC
    • Sous-réseau : sous-réseau à partir duquel attribuer l'adresse IPv6 régionale statique
    • Type de point de terminaison : choisissez Instance de VM ou Équilibreur de charge réseau.
  8. Facultatif : Si vous réservez l'adresse IP externe statique pour une VM, sélectionnez une VM à laquelle associer l'adresse IP dans la liste Associée à.

  9. Cliquez sur Réserver pour réserver l'adresse IP.

gcloud

Pour réserver une adresse IP externe statique, utilisez la commande gcloud compute addresses create.

Suivez les instructions ci-dessous pour réserver une adresse IPv4 ou IPv6 externe statique :

Adresse IP internationale

Pour réserver une adresse IP globale, procédez comme suit :
  gcloud compute addresses create ADDRESS_NAME \
      --global \
      --ip-version [IPV4 | IPV6]
  

Adresse IPv4 externe régionale

Pour réserver une adresse IPv4 externe régionale, procédez comme suit :
   gcloud compute addresses create ADDRESS_NAME \
       --region=REGION
   

Adresse IPv6 externe régionale

Pour réserver une adresse IPv6 externe régionale, procédez comme suit :
   gcloud compute addresses create ADDRESS_NAME \
       --region=REGION \
       --subnet=SUBNET_NAME \
       --ip-version=IPV6 \
       --endpoint-type=[VM | NETLB]
   

Remplacez les éléments suivants :

  • ADDRESS_NAME : nom que vous souhaitez associer à cette adresse.
  • REGION : pour les adresses IP externes régionales, spécifiez la région dans laquelle vous souhaitez réserver cette adresse. Il doit s'agir de la même région que la ressource à laquelle vous souhaitez associer l'adresse IP.
  • SUBNET_NAME : pour les adresses IPv6 externes régionales, spécifiez le sous-réseau à partir duquel attribuer l'adresse IPv6 régionale statique. Le sous-réseau doit avoir une plage d'adresses IPv6 externe attribuée.
  • [IPV4 | IPV6] : pour les adresses IP globales, spécifiez la version IP (IPv4 ou IPv6). Pour les adresses IPv6 externes régionales, spécifiez IPv6. Une plage IPv6 /96 est attribuée à partir du sous-réseau spécifié.
  • VM | NETLB : pour les adresses IPv6 externes régionales, spécifiez le type de point de terminaison. qu'il s'agisse d'une VM ou d'un équilibreur de charge réseau.

Pour afficher le résultat, utilisez la commande gcloud compute addresses describe :

gcloud compute addresses describe ADDRESS_NAME

Terraform

Vous pouvez utiliser la ressource google_compute_address pour créer une adresse IP externe régionale.

resource "google_compute_address" "default" {
  name   = "my-test-static-ip-address"
  region = "us-central1"
}

L'exemple suivant montre comment utiliser la ressource google_compute_global_address pour créer une adresse IPv6 externe globale :

resource "google_compute_global_address" "default" {
  project      = var.project_id # Replace this with your service project ID in quotes
  name         = "ipv6-address"
  address_type = "EXTERNAL"
  ip_version   = "IPV6"
}

API

  • Pour créer une adresse IPv4 régionale, appelez la méthode addresses.insert régionale :

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
    

    Le corps de votre requête doit contenir les éléments suivants :

    {
      "name": "ADDRESS_NAME"
    }
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet pour cette requête
    • REGION : nom de la région pour cette requête
    • ADDRESS_NAME : nom que vous souhaitez associer à l'adresse
  • Pour les adresses IPv4 statiques globales, appelez la méthode globalAddresses.insert :

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
    

    Le corps de votre requête doit contenir les éléments suivants :

    {
      "name": "ADDRESS_NAME"
    }
    
  • Pour les adresses IPv6 statiques globales, appelez la méthode globalAddresses.insert :

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
    

    Le corps de votre requête doit contenir les éléments suivants :

    {
      "name": "ADDRESS_NAME",
      "ipVersion": "IPV6"
    }
    

    Pour afficher le résultat, utilisez la méthode addresses.get.

  • Pour les adresses IPv6 statiques régionales, appelez la méthode addresses.insert :

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
    

    Le corps de votre requête doit contenir les éléments suivants :

    {
      "name": "ADDRESS_NAME",
      "ipVersion": "IPV6",
      "ipv6EndpointType": "VM|LB",
      "networkTier": "PREMIUM",
      "subnetwork": "SUBNET"
    }
    

    Remplacez SUBNET par le sous-réseau de ce projet.

    Pour afficher le résultat, utilisez la méthode addresses.get.

Convertir une adresse IP externe éphémère

Si votre VM possède une adresse IP externe éphémère et que vous souhaitez l'attribuer de manière permanente à votre projet, convertissez l'adresse IP externe éphémère en adresse IP externe statique. La conversion d'une adresse IP externe éphémère en adresse IP réservée n'entraîne pas la suppression des paquets envoyés à la VM par Google Cloud. Cela inclut les paquets envoyés à la VM directement ou au moyen d'un équilibreur de charge.

Console

  1. Accédez à la page Adresses IP.

    Accéder à la page "Adresses IP"

  2. Cliquez sur Adresses IP externes.
  3. Facultatif : dans le champ Filtre, recherchez l'adresse IP éphémère que vous souhaitez convertir.
  4. Dans le menu Plus d'actions () de l'adresse IP que vous souhaitez convertir, sélectionnez Convertir en adresse IP statique.
  5. Saisissez un nom pour la nouvelle adresse IP statique, puis cliquez sur Réserver.

gcloud

Suivez les instructions ci-dessous pour convertir une adresse IPv4 ou IPv6 externe statique :

  • Pour convertir une adresse IPv4 externe éphémère en adresse IPv4 externe statique, indiquez l'adresse IP externe éphémère à l'aide de l'option --addresses avec la commande compute addresses create. Utilisez l'option region pour convertir une adresse IP régionale éphémère ou l'option global pour convertir une adresse IP globale éphémère.

    gcloud compute addresses create ADDRESS_NAME --addresses=IP_ADDRESS \
        [--region=REGION | --global]
    

    Remplacez les éléments suivants :

    • ADDRESS_NAME : nom que vous souhaitez associer à cette adresse.
    • IP_ADDRESS : adresse IP que vous souhaitez promouvoir.
    • REGION : région à laquelle appartient l'adresse IP régionale.

    • Pour convertir une adresse IPv6 externe régionale éphémère en adresse IPv6 externe régionale statique, indiquez l'adresse IP externe éphémère à l'aide de l'option --addresses avec la commande compute addresses create

    gcloud compute addresses create ADDRESS_NAME \
        --region=REGION \
        --addresses=IPV6_ADDRESS \
        --prefix-length=96
    

    Remplacez les éléments suivants :

    • ADDRESS_NAME : nom de la ressource d'adresse IP
    • REGION : région de la ressource d'adresse IPv6
    • IPV6_ADDRESS : adresse IPv6 que vous convertissez

API

Pour promouvoir une adresse IP régionale éphémère, appelez la méthode addresses.insert :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses

Pour convertir une adresse IP globale éphémère, envoyez une requête POST à l'URI suivant :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses

Spécifiez les valeurs des champs obligatoires du corps de la requête :

  • Pour les adresses IPv4, le corps de la requête doit contenir les champs suivants :

    {
      "name": "ADDRESS_NAME",
      "address": "IPV4_ADDRESS"
      "addressType": "EXTERNAL"
    }
    
  • Pour les adresses IPv6, le corps de la requête doit contenir les champs suivants :

    {
      "name": "ADDRESS_NAME",
      "address": "IPV6_ADDRESS"
      "prefixLength": 96
      "addressType": "EXTERNAL"
    }
    

    Remplacez les éléments suivants :

    • ADDRESS_NAME : nom que vous souhaitez associer à cette adresse
    • IPV4_ADDRESS|IPV6_ADDRESS : adresse IPv4 ou IPv6 que vous souhaitez convertir
    • REGION : région à laquelle appartient l'adresse IPv4 ou IPv6
    • PROJECT_ID : ID du projet pour cette requête

L'adresse IP externe reste associée à la VM même après sa conversion en adresse IP externe statique. Si vous devez attribuer l'adresse IP externe statique que vous venez de convertir à une autre ressource, annulez l'attribution de l'adresse IP externe statique à la VM existante.

Répertorier des adresses IP externes statiques

Pour répertorier les adresses IP externes statiques que vous avez réservées pour votre projet, procédez comme suit :

Console

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

    Accéder à la page "Adresses IP"

  2. Cliquez sur Adresses IP externes.

gcloud

Exécutez la commande gcloud compute addresses list :

  • Pour répertorier toutes les adresses IP, utilisez la commande suivante :

    gcloud compute addresses list
  • Pour répertorier toutes les adresses IP globales, utilisez la commande suivante :

    gcloud compute addresses list --global
  • Pour répertorier toutes les adresses IP régionales dans une région donnée, utilisez la commande suivante :

    gcloud compute addresses list \
        --regions=REGION
    

    Remplacez REGION par la région pour laquelle vous souhaitez répertorier les adresses. Vous pouvez répertorier les adresses de plusieurs régions en spécifiant des noms de région séparés par une virgule :

    gcloud compute addresses list \
        --regions=REGION1,REGION2,..REGION_n_
    

API

  • Pour répertorier les adresses IPv4 ou IPv6 régionales, appelez la méthode addresses.list :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet pour cette requête
    • REGION : nom de la région pour cette requête
  • Pour répertorier toutes les adresses dans toutes les régions, appelez la méthode addresses.aggregatedList :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/addresses
    
  • Pour répertorier les adresses IPv4 ou IPv6 globales, appelez la méthode globalAddresses.list :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses
    

    Remplacez les éléments suivants :

    PROJECT_ID : ID du projet pour cette requête

Décrire une adresse IP externe statique

Pour obtenir des informations sur une adresse IP externe statique, procédez comme suit :

Console

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

    Accéder à la page "Adresses IP"

  2. Cliquez sur Adresses IP externes.

  3. Cliquez sur l'adresse IP pour laquelle vous souhaitez obtenir plus d'informations.

gcloud

Utilisez la commande gcloud compute addresses describe et remplacez ADDRESS_NAME par le nom de l'adresse IP externe que vous souhaitez décrire.

  • Pour une adresse IPv4 ou IPv6 globale, utilisez la commande suivante :

    gcloud compute addresses describe ADDRESS_NAME --global
  • Pour une adresse IPv4 ou IPv6 régionale, utilisez la commande suivante :

    gcloud compute addresses describe ADDRESS_NAME --region=REGION

API

  • Pour décrire une adresse IPv4 ou IPv6 régionale, appelez la méthode addresses.get :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet pour la requête.
    • REGION : nom de la région pour la requête.
    • ADDRESS_NAME : nom de l'adresse IP.
  • Pour décrire une adresse IPv4 ou IPv6 globale, appelez la méthode globalAddresses.get :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/ADDRESS_NAME
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet pour la requête.
    • ADDRESS_NAME : nom de l'adresse IP.

Libérer une adresse IP externe statique

Si vous n'avez plus besoin d'une adresse IPv4 ou IPv6 externe statique, vous pouvez la libérer en supprimant la ressource d'adresse IP.

Si vous utilisez la console Google Cloud, vous ne pouvez libérer une adresse IP statique que si elle n'est pas utilisée par une autre ressource.

Si vous utilisez la gcloud CLI ou l'API, vous pouvez libérer une adresse IP, qu'elle soit utilisée ou non par une autre ressource.

  • Si l'adresse IP n'est pas utilisée par une ressource, elle est renvoyée au pool d'adresses IP externes disponibles.

  • Si l'adresse IP est utilisée par une ressource, elle reste associée à la ressource jusqu'à ce que cette dernière soit supprimée.

Console

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

    Accéder à la page "Adresses IP"

  2. Cliquez sur Adresses IP externes.

  3. Facultatif: dans le champ Filtre, saisissez static, puis sélectionnez Statique : Type dans la liste déroulante.

  4. Sélectionnez l'adresse IP externe statique que vous souhaitez libérer.

  5. Cliquez sur Libérer l'adresse statique.

    Si cette option ne s'affiche pas, cliquez sur le menu Autres actions () dans la barre de menu supérieure, puis sélectionnez Libérer l'adresse statique dans la liste.

gcloud

Exécutez la commande compute addresses delete :

gcloud compute addresses delete ADDRESS_NAME

Remplacez ADDRESS_NAME par le nom de l'adresse IPv4 ou IPv6 à libérer.

API

  • Pour libérer une adresse IPv4 ou IPv6 régionale, appelez la méthode addresses.delete :

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet pour cette requête
    • REGION : nom de la région pour cette requête
    • ADDRESS_NAME : nom de l'adresse IP.
  • Pour libérer une adresse IPv4 ou IPv6 globale, appelez la méthode globalAddresses.delete :

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/addresses/ADDRESS_NAME
    

    Remplacez les éléments suivants :

    • ADDRESS_NAME : nom de l'adresse IP.
    • PROJECT_ID : ID du projet pour cette requête

Étapes suivantes