Définir et supprimer des métadonnées personnalisées

Console

1. Dans la console Google Cloud, accédez à la page Métadonnées.

   Accéder à la page "Métadonnées personnalisées"

2. Cliquez sur edit Modifier en haut de la page.

3. Pour ajouter des entrées de métadonnées de projet personnalisées, procédez comme suit :

   1. Accédez au bas de la page, puis cliquez sur add_box Ajouter un élément.
   2. Dans le champ Clé, saisissez le nom de votre clé de métadonnées personnalisées.
   3. Dans le champ Valeur, saisissez la valeur des métadonnées personnalisées du projet.
   4. Facultatif. Pour ajouter d'autres entrées de métadonnées de projet personnalisées, répétez les étapes précédentes pour chaque entrée de métadonnées que vous souhaitez ajouter.
   5. Pour terminer d'ajouter des entrées de métadonnées de projet personnalisées, cliquez sur Enregistrer.

4. Pour modifier des entrées de métadonnées de projet personnalisées existantes, procédez comme suit:

   1. Accédez à l'entrée de métadonnées que vous souhaitez modifier.
   2. Pour mettre à jour le nom d'une clé de métadonnées personnalisées spécifique, saisissez le nouveau nom dans le champ Clé de cette entrée.
   3. Pour mettre à jour la valeur d'une entrée de métadonnées de projet personnalisées, saisissez la nouvelle valeur dans le champ Valeur de cette entrée.
   4. Facultatif. Pour supprimer une entrée de métadonnées de projet personnalisées spécifique, cliquez sur l'icône de suppression delete à côté de l'entrée de métadonnées.
   5. Pour modifier plusieurs entrées de métadonnées de projet personnalisées, répétez les étapes précédentes pour chaque entrée de métadonnées que vous souhaitez modifier.
   6. Pour terminer de modifier les entrées de métadonnées personnalisées de votre projet, cliquez sur Enregistrer.

gcloud

Utilisez la commande project-info add-metadata.

gcloud compute project-info add-metadata \
    --metadata=KEY=VALUE

Remplacez les éléments suivants :

• KEY : nom de votre clé de métadonnées
• VALUE : valeur stockée pour cette clé

Exemple

Par exemple, pour définir deux nouvelles entrées foo=bar et baz=bat dans un projet, exécutez la commande suivante :

gcloud compute project-info add-metadata \
    --metadata=foo=bar,baz=bat

Vous pouvez éventuellement spécifier un ou plusieurs fichiers à partir desquels lire les métadonnées à l'aide de l'option --metadata-from-file.

REST

1. Facultatif. Pour effectuer un verrouillage optimiste, vous pouvez éventuellement fournir une empreinte.

   Une empreinte est une chaîne aléatoire de caractères générée par Compute Engine. L'empreinte change après chaque requête. Si vous fournissez une empreinte non concordante, votre requête est refusée.

   Si vous ne fournissez pas d'empreinte, aucune vérification de cohérence n'est effectuée et la requête projects().setCommonInstanceMetadata aboutit. Ce comportement est différent des méthodes instances().setMetadata et instanceSettings().patch, où une empreinte est toujours requise.

   Pour obtenir l'empreinte actuelle d'un projet, appelez la méthode project().get.

   GET http://compute.googleapis.com/compute/v1/projects/PROJECT_ID
   

   Le résultat ressemble à ce qui suit :

   {
     "name": "myproject",
     "commonInstanceMetadata": {
       "kind": "compute#metadata",
       "fingerprint": "FikclA7UBC0=",
       ...
     }
   }
   

2. Envoyez ensuite une requête à la méthode projects().setCommonInstanceMetadata, puis définissez les paires clé/valeur des métadonnées personnalisées :

   POST http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/setCommonInstanceMetadata
   
   {
     "fingerprint": "FikclA7UBC0=",
     "items": [
       {
       "key": "foo",
       "value": "bar"
       }
     ]
   }
   

Remplacez PROJECT_ID par l'ID de votre projet.

gcloud

• Pour ajouter ou mettre à jour des métadonnées zonales personnalisées, exécutez la commande gcloud compute project-zonal-metadata add.

  gcloud compute project-zonal-metadata add \
    --zone=ZONE \
    --project=PROJECT_ID  \
    --metadata=KEY1=VALUE1,KEY2=VALUE2,...

  Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet.
  • ZONE : zone dans laquelle vous souhaitez ajouter ou mettre à jour les métadonnées zonales du projet.
  • KEY1, KEY2, etc. : clés de métadonnées personnalisées pour lesquelles vous souhaitez ajouter ou mettre à jour des valeurs de métadonnées zonales.

  • VALUE1, VALUE2, etc. : valeurs de métadonnées zonales que vous souhaitez définir pour vos clés de métadonnées personnalisées existantes et nouvelles. En fonction de votre clé et de votre valeur de métadonnées personnalisées, l'une des situations suivantes se présente :

  • Si la clé de métadonnées personnalisées correspondante est une clé existante contenant des métadonnées de projet, Compute Engine remplace la valeur de métadonnées du projet de la clé par la valeur de métadonnées zonale spécifiée dans la zone spécifiée. Toutes les VM de la zone spécifiée dans le projet héritent de ces métadonnées zonales nouvellement spécifiées pour cette clé et les VM des autres zones continuent de conserver leurs valeurs de métadonnées zonales ou de projet dominantes. Si vous effectuez des mises à jour ultérieures de la valeur de métadonnées du projet pour cette clé, les VM de cette zone du projet ne sont pas affectées et continuent à utiliser la valeur de métadonnées zonales pour cette clé.

  • Si la clé de métadonnées personnalisées correspondante est une nouvelle clé de métadonnées qui n'est pas utilisée pour les métadonnées de projet ou zonales existantes, Compute Engine crée la clé de métadonnées personnalisées et définit cette valeur comme métadonnées zonales dans la zone spécifiée.

  • Si la clé de métadonnées personnalisées correspondante est une clé de métadonnées existante avec une valeur de métadonnées zonale dans la zone spécifiée:

    • Si la valeur de métadonnées spécifiée est différente de la valeur existante, Compute Engine met à jour l'entrée de métadonnées zonales avec la nouvelle valeur.
    • Si la valeur de métadonnées spécifiée est identique à la valeur existante, l'entrée de métadonnées zonale reste inchangée.

Exemple : Ajouter une entrée de métadonnées zonales personnalisées

Par exemple, considérons un projet appelé my-project avec les métadonnées personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"value-1" et "key-2":"value-2"

Pour ajouter "key-4":"value-4" en tant que nouvelle paire de métadonnées zonales personnalisées dans la zone us-central1-a, exécutez la commande suivante :

gcloud compute project-zonal-metadata add \
    --metadata=key-4=value-4 \
    --project=my-project \
    --zone=us-central1-a

Exemple : Mettre à jour les valeurs d'une entrée de métadonnées zonale personnalisée existante

Prenons l'exemple de projet my-project, qui contient désormais les métadonnées personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"value-1", "key-2":"value-2" et "key-4":"value-4"

Pour mettre à jour les valeurs de métadonnées zonales avec key-1 et key-4 dans la zone us-cerntral1-a avec de nouvelles valeurs, exécutez la commande suivante :

gcloud compute project-zonal-metadata add \
    --metadata=key-1=new-value-1,key-4=new-value-4 \
    --project=my-project \
    --zone=us-central1-a

Exemple: remplacer la valeur de métadonnées du projet pour une clé et utiliser une valeur de métadonnées zonale

Prenons l'exemple de projet my-project, qui contient désormais les métadonnées personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"new-value-1", "key-2":"value-2" et "key-4":"new-value-4"

Dans cet exemple de projet, considérons key-3, qui a une valeur de métadonnées value-c de projet. Supposons que vous souhaitiez définir une valeur de métadonnées zonales value-3 pour cette clé pour toutes les VM de la zone us-central1-a. Lorsque vous exécutez l'opération, pour toutes les VM de la zone us-central1-a, Compute Engine remplace les valeurs de métadonnées du projet et utilise les valeurs de métadonnées zonales. Les VM de toutes les autres zones du projet conservent leur projet ou les valeurs de métadonnées zonales prédominantes pour key-3.

Pour remplacer la valeur de métadonnées du projet pour key-3 et définir une valeur de métadonnées zonale, exécutez la commande suivante:

gcloud compute project-zonal-metadata add \
    --metadata=key-3=value-3 \
    --project=my-project \
    --zone=us-central1-a

REST

1. Obtenez l'empreinte actuelle et affichez les paires clé/valeur existantes pour le projet dans cette zone.

   Pour effectuer un verrouillage optimiste, vous devez fournir une empreinte. Une empreinte est une chaîne aléatoire de caractères générée par Compute Engine. L'empreinte change chaque fois que vous effectuez une requête d'ajout, de mise à jour ou de suppression de métadonnées zonales. Si vous fournissez une empreinte non concordante, Compute Engine rejette la requête.

   Si vous ne fournissez pas d'empreinte, une vérification de cohérence est effectuée et votre requête de mise à jour échoue. Cela permet de n'effectuer qu'une seule requête à la fois, évitant ainsi les conflits. Ce comportement correspond à instances().setMetadata, où une empreinte est toujours requise.

   Pour obtenir l'empreinte actuelle des métadonnées zonales, envoyez une requête GET à la méthode instanceSettings().get.

   GET http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceSettings
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet.
   • ZONE : zone dans laquelle vous souhaitez définir les métadonnées zonales.

   Voici un exemple de résultat de cette requête :

       {
         "fingerprint": "VlRIl8dx9vk=",
         "metadata": {
           ...
         }
       }
   

2. Pour ajouter ou mettre à jour les métadonnées zonales, envoyez une requête PATCH à la méthode instanceSettings().patch. Vous devez fournir les éléments suivants avec votre requête :

   • Un masque de mise à jour. Utilisez le paramètre de requête update_mask. Le masque de mise à jour doit contenir les clés de métadonnées pour les éléments suivants :

     • Nouvelles métadonnées zonales que vous souhaitez ajouter
     • Métadonnées zonales personnalisé existantes dont vous souhaitez mettre à jour les valeurs

     Vous devez ajouter la chaîne metadata.items. comme préfixe pour chaque clé, par exemple, metadata.items.key1,metadata.items.key3.

   • Dans le corps de la requête, fournissez les informations suivantes :

     • Clés et valeurs de métadonnées des nouvelles métadonnées zonales personnalisées que vous souhaitez ajouter
     • Clés et valeurs de métadonnées des métadonnées zonales personnalisées existantes que vous souhaitez mettre à jour
     • Valeur d'empreinte actuelle

   PATCH http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceSettings?update_mask=PREFIXED_METADATA_KEYS
   {
     "fingerprint": "FINGER_PRINT",
     "metadata": {
       "items": {
         "KEY1": "VALUE1",
         "KEY2": "VALUE2",
         ...
       }
     }
   }
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet.
   • ZONE : zone dans laquelle vous souhaitez définir les métadonnées zonales.

   • PREFIXED_METADATA_KEYS : liste des clés de métadonnées pour le code suivant, où chaque clé est préfixée par la chaîne metadata.items. :

     • Nouvelles métadonnées zonales que vous souhaitez ajouter
     • Métadonnées zonales personnalisé existantes dont vous souhaitez mettre à jour les valeurs

     Par exemple, supposons que vos clés de métadonnées zonales actuelles dans une zone spécifique soient key-1 et key-2. Si vous souhaitez ajouter une clé key-3 pour les métadonnées zonales dans cette zone et mettre à jour les métadonnées zonales de l'une des clés existantes, key-1, votre masque de mise à jour doit comporter la chaîne suivante :

     metadata.items.key1,metadata.items.key3

   • FINGER_PRINT : valeur d'empreinte actuelle.

   • KEY1, KEY2, etc. : clés de métadonnées zonales personnalisées pour lesquelles vous souhaitez ajouter ou mettre à jour des valeurs. Spécifiez toutes les clés de métadonnées zonales personnalisées que vous avez spécifiées dans le masque de mise à jour.

   • VALUE1, VALUE2, etc. : valeurs de métadonnées zonales que vous souhaitez définir pour vos clés de métadonnées personnalisées existantes et nouvelles. En fonction de votre clé et de votre valeur de métadonnées personnalisées, l'une des situations suivantes se présente :

     • Si la clé de métadonnées personnalisées correspondante est une clé existante contenant des métadonnées de projet, Compute Engine remplace la valeur de métadonnées du projet de la clé par la valeur de métadonnées zonale spécifiée dans la zone spécifiée. Toutes les VM de la zone spécifiée dans le projet héritent de ces métadonnées zonales nouvellement spécifiées pour cette clé et les VM des autres zones continuent de conserver leurs valeurs de métadonnées zonales ou de projet dominantes. Si vous effectuez des mises à jour ultérieures de la valeur de métadonnées du projet pour cette clé, les VM de cette zone du projet ne sont pas affectées et continuent à utiliser la valeur de métadonnées zonales pour cette clé.
     • Si la clé de métadonnées personnalisées correspondante est une nouvelle clé de métadonnées qui n'est pas utilisée pour les métadonnées de projet ou zonales existantes, Compute Engine crée la clé de métadonnées personnalisées et définit cette valeur comme métadonnées zonales dans la zone spécifiée.

     • Si la clé de métadonnées personnalisées correspondante est une clé de métadonnées existante avec une valeur de métadonnées zonale dans la zone spécifiée:

     • Si la valeur de métadonnées spécifiée est différente de la valeur existante, Compute Engine met à jour l'entrée de métadonnées zonales avec la nouvelle valeur.

     • Si la valeur de métadonnées spécifiée est identique à la valeur existante, l'entrée de métadonnées zonale reste inchangée.

Exemple : Ajouter une entrée de métadonnées zonales personnalisées

Par exemple, considérons un projet appelé my-project avec les métadonnées personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"value-1" et "key-2":"value-2"

Pour ajouter "key-4":"value-4" en tant que nouvelle paire de métadonnées zonale personnalisées dans la zone us-central1-a, exécutez la requête PATCH suivante :

PATCH http://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-4
{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
  "items": {
    "key-4": "value-4"
    }
  }
}

Exemple : Mettre à jour les valeurs d'une entrée de métadonnées zonale personnalisée existante

Prenons l'exemple de projet my-project, qui contient désormais les métadonnées personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"value-1", "key-2":"value-2" et "key-4":"value-4"

Pour mettre à jour les valeurs de métadonnées zonales key-1 et key-4 dans la zone us-cerntral1-a avec de nouvelles valeurs, exécutez la requête PATCH suivante :

PATCH http://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-1,metadata.items.key-4
{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
  "items": {
    "key-1": "new-value-1",
    "key-4": "new-value-4"
    }
  }
}

Exemple: remplacer la valeur de métadonnées du projet pour une clé et définir une valeur de métadonnées zonale

Prenons l'exemple de projet my-project, qui contient désormais les métadonnées personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"new-value-1", "key-2":"value-2" et "key-4":"new-value-4"

Dans cet exemple de projet, considérons key-3, qui a une valeur de métadonnées value-c de projet. Supposons que vous souhaitiez définir une valeur de métadonnées zonales value-3 pour cette clé pour toutes les VM de la zone us-central1-a. Lorsque vous exécutez l'opération, pour toutes les VM de la zone us-central1-a, Compute Engine remplace les valeurs de métadonnées du projet et utilise les valeurs de métadonnées zonales. Les VM de toutes les autres zones du projet conservent leur projet ou les valeurs de métadonnées zonales prédominantes pour key-3.

Pour remplacer la valeur de métadonnées du projet pour key-3 et utiliser plutôt la valeur de métadonnées zonale value-3, exécutez la requête PATCH suivante:

PATCH http://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-3
{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
  "items": {
    "key-3": "value-3"
    }
  }
}

Console

1. Accédez à la page Créer une instance dans Google Cloud Console.

   Accéder à la page Créer une instance

2. Spécifiez les détails de la VM.

3. Développez la section Options avancées et procédez comme suit :

   1. Développez la section Gestion.
   2. Pour ajouter plusieurs paires clé/valeur pour vos métadonnées personnalisées, dans la section Métadonnées, cliquez sur Ajouter un élément.

4. Pour créer la VM, cliquez sur Créer.

gcloud

Pour définir des métadonnées personnalisées, exécutez la commande gcloud compute instances create avec l'option --metadata.

gcloud compute instances create VM_NAME \
    --metadata=KEY=VALUE

Remplacez les éléments suivants :

• VM_NAME : nom de votre VM
• KEY : nom de votre clé de métadonnées
• VALUE : valeur stockée pour cette clé

Exemple

Par exemple, pour définir une nouvelle clé foo dont la valeur est bar sur une VM nommée example-instance, exécutez la commande suivante :

gcloud compute instances create example-instance \
    --metadata=foo=bar

REST

Utilisez la méthode instances.insert et indiquez les métadonnées personnalisées dans la propriété metadata de la requête :

POST http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "...": [
    {
    }
    ],
  "metadata": {
    "items": [
      {
        "key": "KEY",
        "value": "VALUE"
      }
    ]
  },
  ..
}

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet.
• ZONE : zone dans laquelle créer la VM
• MACHINE_TYPE : type de machine prédéfini ou personnalisé pour la nouvelle VM
• VM_NAME : nom de la nouvelle VM
• KEY : nom de votre clé de métadonnées
• VALUE : valeur stockée pour cette clé

Console

1. Dans Google Cloud Console, accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Cliquez sur l'instance pour laquelle vous souhaitez mettre à jour les métadonnées.
3. Cliquez sur le bouton Modifier en haut de la page.
4. Sous Métadonnées personnalisées, cliquez sur Ajouter un élément ou modifiez les entrées de métadonnées existantes.
5. Enregistrez les modifications.

gcloud

Les mises à jour des métadonnées de VM avec gcloud CLI s'ajoutent les unes aux autres. Spécifiez uniquement les clés de métadonnées que vous souhaitez ajouter ou modifier. Si une clé que vous avez fournie existe déjà, cette clé est mise à jour avec la nouvelle valeur.

Exécutez la commande instances add-metadata :

gcloud compute instances add-metadata VM_NAME \
    --metadata=KEY=VALUE,KEY=VALUE

Remplacez les éléments suivants :

• VM_NAME : nom de votre VM
• KEY : nom de votre clé de métadonnées
• VALUE : valeur stockée pour cette clé

Exemples

Si vous souhaitez ajouter l'entrée foo=bar, exécutez la commande suivante :

gcloud compute instances add-metadata VM_NAME \
    --metadata=foo=bar

Pour remplacer l'entrée foo=bar par foo=bat, exécutez la commande suivante :

gcloud compute instances add-metadata VM_NAME \
    --metadata=foo=bat

REST

1. Obtenez l'empreinte actuelle et affichez les paires clé/valeur existantes pour la VM. Pour ce faire, appelez la méthode instances().get.

   Une empreinte est une chaîne aléatoire de caractères générée par Compute Engine et utilisée pour effectuer un verrouillage optimal. Pour mettre à jour la VM, vous devez fournir la valeur d'empreinte correspondante. L'empreinte change après chaque requête et si vous fournissez une empreinte non concordante, votre requête est refusée. Cela permet de n'effectuer qu'une seule mise à jour à la fois, évitant ainsi les conflits.

   GET http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet.
   • ZONE : zone où se trouve votre VM.
   • VM_NAME : nom de votre VM

   Le résultat ressemble à ce qui suit :

   {
     ...
     "name": "example-instance",
     "metadata": {
       "kind": "compute#metadata",
       "fingerprint": "zhma6O1w2l8="
       "items": [
         {
           "key": "foo",
           "value": "bar"
         }
       ]
       },
     ...
   }
   

2. Envoyez une requête à la méthode instances().setMetadata. Fournissez la liste des nouvelles valeurs de métadonnées et la valeur fingerprint actuelle.

   Si la VM possède des paires clé/valeur existantes que vous souhaitez conserver, vous devez les inclure dans la requête avec les nouvelles paires clé/valeur.

   Exemple

   POST http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata
   
   {
   "fingerprint": "zhma6O1w2l8=",
   "items": [
     {
       "key": "foo",
       "value": "bar"
     },
     {
       "key": "baz",
       "value": "bat"
     }
   ]
   }
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet.
   • ZONE : zone où se trouve votre VM.
   • VM_NAME : nom de votre VM

Console

1. Dans Google Cloud Console, accédez à la page Métadonnées.

   Accéder à la page "Métadonnées"

2. Cliquez sur edit Modifier en haut de la page.

3. Accédez à l'entrée de métadonnées que vous souhaitez supprimer, puis cliquez sur le bouton de suppression delete situé à côté de cette entrée.

   Répétez cette étape pour chaque entrée de métadonnées que vous souhaitez supprimer.

4. Pour terminer la suppression des entrées de métadonnées personnalisées du projet, cliquez sur Enregistrer.

gcloud

Pour supprimer des métadonnées de projet personnalisées, utilisez la commande gcloud compute project-info remove-metadata.

• Si vous souhaitez supprimer les entrées de métadonnées personnalisées pour des clés spécifiques, spécifiez ces clés à l'aide de l'option --keys et excluez les valeurs de ces clés.

gcloud compute project-info remove-metadata \
    --keys=KEY1,KEY2,...

• Si vous souhaitez supprimer toutes les métadonnées personnalisées de la VM, spécifiez l'option --all.

gcloud compute project-info remove-metadata \
    --all

Remplacez les éléments suivants :

• KEY1, KEY2, etc. : clés de métadonnées d'instance personnalisées que vous souhaitez supprimer.

gcloud

Pour supprimer des métadonnées zonales personnalisées, exécutez la commande gcloud compute project-zonal-metadata remove et spécifiez toutes les clés de métadonnées que vous souhaitez supprimer à l'aide de l'option --keys.

gcloud compute project-zonal-metadata remove \
    --project=PROJECT_ID  \
    --zone=ZONE \
    --keys=KEY1,KEY2,...

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet.
• ZONE : zone dans laquelle vous souhaitez supprimer les métadonnées zonales.
• KEY1, KEY2, etc. : clés de métadonnées zonales personnalisées que vous souhaitez supprimer.

Après avoir exécuté la commande, si l'une des clés spécifiées dispose de valeurs de métadonnées de projet, les VM de la zone spécifiée héritent de ces valeurs de métadonnées de projet. Si l'entrée de métadonnées n'a été définie qu'au niveau zonal et qu'il n'y a pas de valeur de métadonnées de projet correspondante pour cette clé, les VM de cette zone perdent ces informations de métadonnées.

Exemple :

Prenons l'exemple d'un projet my-project, qui inclut les métadonnées de projet personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"new-value-1", "key-2":"value-2", "key-3":"value-3" et "key-4":"new-value-4"

Pour supprimer toutes les métadonnées zonales de la zone us-central1-a, exécutez la commande suivante.

gcloud compute project-zonal-metadata remove \
    --metadata=key-1,key-2,key-3,key-4 \
    --project=my-project \
    --zone=us-central1-a

Une fois la commande exécutée, les VM de la zone us-central1-a possèdent les entrées de métadonnées de projet personnalisées suivantes :

• "key-1":"value-a"
• "key-2":"value-b"
• "key-3":"value-c"

REST

1. Obtenez l'empreinte actuelle et affichez les paires clé/valeur existantes pour le projet dans cette zone.

   Pour effectuer un verrouillage optimiste, vous devez fournir une empreinte. Une empreinte est une chaîne aléatoire de caractères générée par Compute Engine. L'empreinte change chaque fois que vous effectuez une requête d'ajout, de mise à jour ou de suppression de métadonnées zonales. Si vous fournissez une empreinte non concordante, Compute Engine rejette la requête.

   Si vous ne fournissez pas d'empreinte, une vérification de cohérence est effectuée et votre requête de suppression n'aboutit pas. Cela permet de n'effectuer qu'une seule requête à la fois, évitant ainsi les conflits. Ce comportement correspond à instances().setMetadata, où une empreinte est toujours requise.

   Pour obtenir l'empreinte actuelle d'un projet, appelez la méthode instanceSettings().get.

   GET http://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceSettings
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet.
   • ZONE : zone dans laquelle vous souhaitez supprimer les métadonnées zonales.

   Voici un exemple de résultat de cette requête :

       {
         "fingerprint": "FikclA7UBC0=",
         "metadata": {
           ...
         }
       }
   

2. Pour supprimer des métadonnées zonales personnalisées, exécutez une requête PATCH sur la méthode instanceSettings().patch en excluant les clés de métadonnées pour lesquelles vous souhaitez supprimer les métadonnées zonales du corps de la requête. Vous devez fournir les éléments suivants avec votre requête :

   • Un masque de mise à jour. Utilisez le paramètre de requête update_mask. Le masque de mise à jour doit contenir toutes les clés de métadonnées zonales existantes dont vous souhaitez supprimer les métadonnées. Vous devez ajouter la chaîne metadata.items. comme préfixe pour chaque clé, par exemple, metadata.items.key1,metadata.items.key3.

   • Dans le corps de la requête, indiquez uniquement la valeur actuelle de l'empreinte. Excluez toutes les clés de métadonnées personnalisées que vous avez spécifiées dans le masque de mise à jour. Si vous incluez l'une des clés de métadonnées dans le masque de mise à jour et dans le corps de la requête, Compute Engine ne supprime pas les métadonnées zonales de ces clés.

   PATCH http://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceSettings?update_mask=PREFIXED_METADATA_KEYS
   {
     "fingerprint": "FINGER_PRINT",
     "metadata": {
       "items": {
       }
     }
   }
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet.
   • ZONE : zone dans laquelle vous souhaitez supprimer les métadonnées zonales.

   • PREFIXED_METADATA_KEYS: liste de toutes les clés de métadonnées personnalisées existantes pour lesquelles vous souhaitez supprimer des métadonnées zonales, où chaque clé est préfixée par la chaîne metadata.items.. Pour vous assurer que votre requête de suppression aboutit, excluez ces clés de métadonnées du corps de la requête. Si vous incluez l'une des clés de métadonnées dans le masque de mise à jour et dans le corps de la requête, Compute Engine ne supprime pas les métadonnées zonales de ces clés.

     Par exemple, supposons que vos clés de métadonnées actuelles avec des métadonnées zonales soient key-1, key-2, key-3 et key-4, et que vous souhaitez supprimer les entrées de métadonnées zonales pour key-1 et key-2, votre masque de mise à jour doit comporter la chaîne suivante:

     metadata.items.key1,metadata.items.key2

   • FINGER_PRINT : valeur d'empreinte actuelle.

Après avoir envoyé la requête, si l'une des clés spécifiées dispose de valeurs de métadonnées de projet, les VM de la zone spécifiée héritent de ces valeurs de métadonnées de projet. Si la clé de métadonnées n'a été définie qu'au niveau zonal et qu'il n'y a pas de valeur de métadonnées de projet correspondante pour cette clé, les VM de cette zone perdent ces informations de métadonnées.

Exemple :

Prenons l'exemple d'un projet my-project, qui inclut les métadonnées de projet personnalisées suivantes :

• Métadonnées du projet: "key-1":"value-a", "key-2":"value-b" et "key-3":"value-c"
• Métadonnées zonales dans la zone us-central1-a: "key-1":"new-value-1", "key-2":"value-2", "key-3":"value-3" et "key-4":"new-value-4"

Pour supprimer les métadonnées zonales pour key-1 et key-2 dans la zone us-central1-a, envoyez la requête PATCH suivante.

PATCH http://compute.googleapis.com/compute/beta/projects/my-project/zones/us-central1-a/instanceSettings?update_mask=metadata.items.key-1,metadata.items.key-2
{
  "fingerprint": "FikclA7UBC0=",
  "metadata": {
  "items": {
    }
  }
}

Une fois cette requête transmise, les VM de la zone us-central1-a possèdent les métadonnées personnalisées suivantes. Les VM héritent des valeurs de métadonnées du projet pour key-1 et key-2, mais conservent les métadonnées zonales pour key-3 et key-4.

• Métadonnées du projet: "key-1":"value-a" et "key-2":"value-b"
• Métadonnées zonales dans la zone us-central1-a: "key-3":"value-3" et "key-4":"new-value-4"

Console

1. Dans Google Cloud Console, accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Dans la colonne Nom, cliquez sur le nom de la VM pour laquelle vous souhaitez supprimer les métadonnées.
3. Cliquez sur edit Modifier en haut de la page.
4. Dans la section Métadonnées, cliquez deletesur Supprimer l'élément pour chacune des entrées de métadonnées que vous souhaitez supprimer.
5. Pour confirmer vos modifications et supprimer les métadonnées d'instance personnalisées, cliquez sur Enregistrer.

gcloud

Pour supprimer des métadonnées d'instance personnalisées, utilisez la commande gcloud compute instances remove-metadata.

• Si vous souhaitez supprimer les entrées de métadonnées personnalisées pour des clés spécifiques, spécifiez ces clés à l'aide de l'option --keys et excluez les valeurs de ces clés.

gcloud compute instances remove-metadata VM_NAME \
    --zone=ZONE  \
    --keys=KEY1,KEY2,...

• Si vous souhaitez supprimer toutes les métadonnées personnalisées de la VM, spécifiez l'option --all.

gcloud compute instances remove-metadata VM_NAME \
    --zone=ZONE  \
    --all

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet.
• ZONE : zone de votre VM
• VM_NAME : nom de votre VM
• KEY1, KEY2, etc. : clés de métadonnées d'instance personnalisées que vous souhaitez supprimer.

REST

1. Obtenez l'empreinte actuelle et affichez les paires clé/valeur existantes pour la VM. Pour ce faire, appelez la méthode instances().get.

   Une empreinte est une chaîne aléatoire de caractères générée par Compute Engine et utilisée pour effectuer un verrouillage optimal. Pour mettre à jour la VM, vous devez fournir la valeur d'empreinte correspondante. L'empreinte change après chaque requête et si vous fournissez une empreinte non concordante, votre requête est refusée. Cela permet de n'effectuer qu'une seule mise à jour à la fois, évitant ainsi les conflits.

   GET http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet.
   • ZONE : zone de votre VM
   • VM_NAME : nom de votre VM

   Le résultat ressemble à ce qui suit :

   {
     ...
     "name": "example-instance",
     "metadata": {
       "kind": "compute#metadata",
       "fingerprint": "zhma6O1w2l8="
       "items": [
       {
         "key": "key-1",
         "value": "value-1"
       }
       {
         "key": "key-2",
         "value": "value-2"
       }
       ]
     },
     ...
   }
   

2. Envoyez une requête à la méthode instances().setMetadata. Vous devez inclure la valeur actuelle d'empreinte des métadonnées pour que votre requête aboutisse.

   • Pour supprimer toutes les paires clé/valeur des métadonnées personnalisées d'une VM, dans la propriété items, excluez les clés de métadonnées pour lesquelles vous souhaitez supprimer les valeurs de métadonnées.

     POST http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata
     
     {
     "fingerprint": "FINGER_PRINT"
     "items": [
       {
         "key": "KEY1"
         "value": "VALUE1"
       }
       {
         "key": "KEY2"
         "value": "VALUE2"
       }
       ...
     ]
     }
     

   • Pour supprimer toutes les métadonnées d'instances personnalisées de la VM, excluez complètement la propriété items.

     POST http://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata
     
     {
     "fingerprint": FINGER_PRINT
     }
     

   Remplacez les éléments suivants :

   • PROJECT_ID : ID de votre projet.
   • ZONE : zone de votre VM
   • VM_NAME : nom de votre VM
   • FINGER_PRINT : valeur d'empreinte actuelle.
   • KEY1, KEY2, etc. : clés de métadonnées d'instance personnalisées que vous souhaitez supprimer.
   • VALUE1, VALUE2, etc. : valeurs des clés de métadonnées d'instance personnalisées que vous souhaitez supprimer.