Reserve a static internal IP address (Réserver une adresse IP statique interne)

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 interne. Vous devrez peut-être cliquer sur le menu more_vert Autres actions pour afficher ce bouton.
3. Dans le champ Nom, saisissez un nom d'adresse IP.
4. Dans la liste Version IP, sélectionnez la version d'adresse IP requise :
   • Pour réserver une adresse IPv4 interne statique, sélectionnez IPv4.
   • Pour réserver une adresse IPv6 interne statique, sélectionnez IPv6.
5. Dans les listes Réseau et Sous-réseau, sélectionnez un réseau VPC et un sous-réseau, respectivement.
6. Spécifiez la manière dont vous souhaitez réserver l'adresse IP :
   • Pour réserver des adresses IPv4, pour spécifier une adresse IPv4 interne statique à réserver, pour Adresse IP statique, sélectionnezLaissez-moi choisir, puis saisissez une adresse IP personnalisée. Sinon, le système attribue automatiquement une adresse IPv4 interne statique dans le sous-réseau.
   • Pour les adresses IPv6, le système attribue automatiquement une adresse IPv6 interne statique à partir de la plage d'adresses IPv6 internes du sous-réseau.

7. Facultatif : si vous souhaitez partager l'adresse IPv4 interne statique dans différentes interfaces, sélectionnez Partagée dans la liste Objectif. La sélection par défaut est Non partagée.

8. Cliquez sur Réserver.

gcloud

• Pour réserver une adresse IPv4 interne, utilisez la commande compute addresses create :

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --addresses IP_ADDRESS
  

  Remplacez les éléments suivants :

  • ADDRESS_NAMES : nom d'une ou de plusieurs adresses [--purpose=SHARED_LOADBALANCER_VIP] que vous souhaitez créer. Dans le cas de plusieurs adresses, spécifiez toutes les adresses sous forme de liste, séparées par des espaces, par exemple example-address-1 example-address-2 example-address-3.
  • REGION : région de la requête.
  • SUBNETWORK : sous-réseau de l'adresse IP interne.
  • IP_ADDRESS : adresse IP à réserver, qui doit être comprise dans la plage d'adresses IP principales du sous-réseau. Si elle n'est pas spécifiée, une adresse IP est automatiquement attribuée à partir du sous-réseau.

• Pour réserver une adresse IPv6 interne, utilisez la commande compute addresses create. Spécifiez IPV6 comme valeur pour --ip-version :

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --ip-version IPV6
  

  Remplacez les éléments suivants :

  • ADDRESS_NAMES : nom d'une ou de plusieurs adresses que vous souhaitez réserver. Dans le cas de plusieurs adresses, spécifiez toutes les adresses sous forme de liste, séparées par des espaces, par exemple example-address-1 example-address-2 example-address-3.
  • REGION : région de la requête.
  • SUBNETWORK : sous-réseau de l'adresse IPv6 interne.

  Contrairement à la réservation IPv4 interne, la réservation IPv6 interne ne permet pas de réserver une adresse IP spécifique auprès du sous-réseau. À la place, une adresse IPv6 interne /96 est automatiquement allouée à partir de la plage d'adresses IPv6 interne /64 du sous-réseau.

Exemples

• Réserver une adresse IPv4 interne allouée automatiquement depuis un sous-réseau :

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1
  

• Réserver une adresse IPv4 interne spécifique dans un sous-réseau :

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12
  

• Réserver une adresse IPv6 interne statique d'un sous-réseau :

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --ip-version IPV6
  

• Créer plusieurs adresses IPv4 en transmettant plusieurs noms d'adresses IPv4. Toutes les adresses sont réservées dans le même sous-réseau :

  gcloud compute addresses create example-address-1 example-address-2 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12,10.128.0.13
  

Terraform

Vous pouvez utiliser un module Terraform pour créer une adresse IP interne.

Dans l'exemple suivant, les arguments Terraform contiennent des exemples de valeurs que vous pouvez modifier. L'exemple crée deux adresses IP internes spécifiques :

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
  addresses  = ["10.0.0.3", "10.0.0.4"]
}

L'exemple suivant permet de créer deux adresses IP internes allouées de manière dynamique :

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
}

API

Utilisez la méthode addresses.insert :

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

Pour les adresses IPv4 et IPv6, le corps de la requête doit inclure le champ addressType, qui doit être INTERNAL, le name de l'adresse, et le subnetwork auquel appartient l'adresse IP. Le corps de la requête peut éventuellement inclure le purpose de l'adresse IP interne.

En outre, pour les adresses IPv4 internes, vous pouvez laisser le système attribuer automatiquement une adresse IP ou utiliser address pour spécifier une adresse IPv4 interne. L'adresse IPv4 doit appartenir à la plage d'adresses IP principales du sous-réseau.

{
  "addressType": "INTERNAL",
  "name": "IPV4_ADDRESS_NAME",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "address": "IPV4_ADDRESS"
  "purpose": "GCE_ENDPOINT"
}

Exemple :

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv4-address-1",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "address": "10.128.0.12"
  "purpose": "GCE_ENDPOINT"
}

Pour les adresses IPv6 internes, vous devez également spécifier ipVersion en tant que IPV6. Le système attribue automatiquement une adresse IPv6 interne statique à partir de la plage d'adresses IPv6 internes du sous-réseau.

{
  "addressType": "INTERNAL",
  "name": "IPV6_ADDRESS_NAME",
  "ipVersion": "IPV6",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "purpose": "GCE_ENDPOINT"
}

Exemple :

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv6-address-1",
  "ipVersion": "IPV6"
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "purpose": "GCE_ENDPOINT"
}

Console

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

   Accéder à la page "Adresses IP"

2. Cliquez sur Adresses IP internes.
3. Facultatif: dans le champ Filtre, pour rechercher des adresses IP éphémères, saisissez ephemeral, puis sélectionnez Éphémère: Type dans la liste déroulante.
4. Sélectionnez l'adresse IP interne que vous souhaitez promouvoir.
5. Dans le menu Plus d'actions (more_vert) à la fin de la ligne d'affichage de l'adresse IP sélectionnée, sélectionnez Convertir en adresse IP statique.
6. Saisissez un nom pour la nouvelle adresse IP statique, puis cliquez sur Réserver.

gcloud

1. Avant de convertir une adresse IPv6 interne éphémère existante, vous devez connaître la valeur de cette adresse IP. Utilisez Google Cloud CLI pour envoyer une requête describe à la ressource afin d'obtenir la valeur de l'adresse IP.

   • Pour une instance avec une adresse IPv4, utilisez la commande suivante:

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "networkIP"
     

   • Pour une instance avec une adresse IPv6, utilisez la commande suivante:

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "ipv6Address"
     

   • Pour une règle de transfert régionale, utilisez la commande suivante :

     gcloud compute forwarding-rules describe FORWARDING_RULE_NAME --region REGION | grep "IPAddress"
     

     Pour une règle de transfert globale, utilisez l'option --global au lieu de l'option --region.

2. Convertissez l'adresse :

   • Pour convertir une ou plusieurs adresses IPv4 internes existantes, exécutez la commande compute addresses create et spécifiez l'option --addresses avec les adresses IP internes explicites à convertir :

     gcloud compute addresses create IPV4_ADDRESS_NAMES \
       --addresses IPV4_ADDRESSES \
       --region REGION \
       --prefix-length PREFIX_LENGTH \
       --subnet SUBNETWORK
     

     Remplacez les éléments suivants :

     • IPV4_ADDRESS_NAMES : noms des adresses IPv4. Dans le cas de plusieurs adresses, spécifiez tous les noms d'adresses sous forme de liste, séparés par des espaces, par exemple example-address-name-1 example-address-name-2 example-address-name-3. Déclarez les noms dans le même ordre que les adresses IP. Par exemple, supposons que vous spécifiez les noms d'adresse comme example-address-name-1 example-address-name-2 example-address-name-3 et les adresses IPv4 comme 192.0.2.0 192.0.2.1 192.0.2.2. Dans ce scénario, Compute Engine mappe les noms et les adresses de la manière suivante :

       • example-address-name-1 : 192.0.2.0
       • example-address-name-2 : 192.0.2.1
       • example-address-name-3 : 192.0.2.2

     • IPV4_ADDRESSES : adresses IPv4 à promouvoir. Dans le cas de plusieurs adresses, spécifiez toutes les adresses sous forme de liste, séparées par des espaces, par exemple 192.0.2.0 192.0.2.1 192.0.2.2.

     • REGION : la région dans laquelle sera réservée cette adresse.

     • PREFIX_LENGTH : facultatif. Longueur de préfixe de la plage d'adresses IPv4. Cette valeur doit être un nombre entier compris entre 7 et 31. Incluez ce champ uniquement si vous spécifiez une plage d'adresses. Excluez le champ si l'adresse IPv4 spécifiée est une adresse IP unique.

     • SUBNETWORK : le sous-réseau de cette requête.

   • Pour convertir une ou plusieurs adresses IPv6 internes existantes, exécutez la commande compute addresses create et spécifiez l'option --addresses avec les adresses IPv6 internes explicites :

     gcloud compute addresses create IPV6_ADDRESS_NAMES \
      --addresses IPV6_ADDRESSES \
      --region REGION \
      --prefix-length PREFIX_LENGTH \
      --subnet SUBNETWORK
     

     Remplacez les éléments suivants :

     • IPV6_ADDRESS_NAMES : noms de l'adresse. Déclarez les noms dans le même ordre que les adresses IPv6. Dans ce cas, IPV6_ADDRESS_NAME_1 correspond à IPV6_ADDRESS_1 et IPV6_ADDRESS_NAME_2 correspond à IPV6_ADDRESS_2.
     • IPV6_ADDRESS_1,[IPV6_ADDRESS_2,...] : adresses IPv6 à promouvoir au format CIDR
     • PREFIX_LENGTH_1,[PREFIX_LENGTH_2,...] : longueur du préfixe des adresses IPv6
     • REGION : la région dans laquelle sera réservée cette adresse.
     • SUBNETWORK : le sous-réseau de cette requête.

     L'adresse IPv6 interne reste associée à l'instance existante même après sa conversion en adresse IPv6 interne statique. Si vous devez attribuer l'adresse IPv6 interne statique que vous venez de convertir à une autre ressource, commencez par annuler l'attribution de l'adresse IPv6 interne statique à l'instance existante.

API

Utilisez la méthode addresses.insert :

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

Pour les adresses IPv4 et IPv6, le corps de la requête doit inclure le type d'adresse (addressType), qui doit être INTERNAL, le name de l'adresse, le address à convertir et le subnetwork auquel appartient l'adresse IP. Pour les adresses IPv6, le corps de la requête doit également inclure prefixLength avec 96 comme valeur.

• Corps de la requête pour convertir des adresses IPv4 internes :

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  }
  

  Exemple :

  POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv4-address-1",
  "addressType": "INTERNAL",
  "address": "10.128.0.2",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  }
  

• Corps de la requête pour convertir des adresses IPv6 internes :

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  "prefixLength": 96
  }
  

  Exemple :

  POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv6-address-1",
  "addressType": "INTERNAL",
  "address": "fd20:0:0::",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  "prefixLength": 96
  }
  

Console

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

   Accéder à la page "Adresses IP"

2. Cliquez sur Adresses IP internes.

gcloud

Exécutez la commande gcloud compute addresses list :

gcloud compute addresses list

API

Utilisez 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 de toutes les régions, utilisez la méthode addresses.aggregatedList :

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

Console

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

   Accéder à la page "Adresses IP"

2. Sélectionnez l'onglet Adresses IP internes.
3. Facultatif: dans le champ Filtre, saisissez static, puis sélectionnez Statique : Type dans la liste déroulante.
4. Sélectionnez l'adresse IP interne statique que vous souhaitez libérer.

5. Cliquez sur Libérer l'adresse statique, puis confirmez cette opération en cliquant sur Libérer dans la boîte de dialogue.

   Si cette option ne s'affiche pas, cliquez sur le menu Autres actions (more_vert) 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 \
    --region REGION

Remplacez les éléments suivants :

• ADDRESS_NAME : nom de l'adresse à supprimer
• REGION : région à laquelle appartient l'adresse

Exemple :

gcloud compute addresses delete example-address-to-delete \
    --region us-west1

API

Utilisez la méthode addresses.delete :

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

Cet exemple supprime une adresse dans la région us-west1 :

DELETE https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-west1/addresses/example-address-to-delete