Imposta e rimuovi i metadati personalizzati

Console

1. Nella console Google Cloud, vai alla pagina Metadati.

   Vai alla pagina Metadati personalizzati

2. Fai clic su edit Modifica nella parte superiore della pagina.

3. Per aggiungere nuove voci di metadati di progetto personalizzati:

   1. Vai in fondo alla pagina e fai clic su add_box Aggiungi elemento.
   2. Nel campo Chiave, inserisci il nome della chiave dei metadati personalizzati.
   3. Nel campo Valore, inserisci il valore dei metadati del progetto personalizzato.
   4. Facoltativo. Per aggiungere altre voci di metadati del progetto personalizzati, ripeti i passaggi precedenti per ogni voce di metadati che vuoi aggiungere.
   5. Per completare l'aggiunta delle voci dei metadati del progetto personalizzato, fai clic su Salva.

4. Per modificare le voci dei metadati dei progetti personalizzati esistenti:

   1. Vai alla voce dei metadati che vuoi modificare.
   2. Per aggiornare il nome di una chiave di metadati personalizzata specifica, inserisci il nuovo nome nel campo Chiave della voce.
   3. Per aggiornare il valore di una voce dei metadati del progetto personalizzato, inserisci il nuovo valore nel campo Valore della voce.
   4. Facoltativo. Per rimuovere una voce specifica dei metadati di un progetto personalizzato, fai clic sull'icona di eliminazione delete accanto alla voce dei metadati.
   5. Per modificare più voci dei metadati di progetto personalizzati, ripeti i passaggi precedenti per ogni voce dei metadati da modificare.
   6. Per completare la modifica delle voci dei metadati del progetto personalizzato, fai clic su Salva.

gcloud

Utilizza il comando project-info add-metadata.

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

Sostituisci quanto segue:

• KEY: il nome della chiave dei metadati
• VALUE: il valore memorizzato per questa chiave

Esempio

Ad esempio, per impostare due nuove voci foo=bar e baz=bat in un progetto, esegui il seguente comando:

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

Facoltativamente, puoi specificare uno o più file da cui leggere i metadati utilizzando il flag --metadata-from-file.

REST

1. Facoltativo. Per eseguire il blocco ottimistico, puoi facoltativamente fornire un'impronta.

   Un'impronta è una stringa casuale di caratteri generata da Compute Engine. L'impronta cambia dopo ogni richiesta e, se fornisci un'impronta non corrispondente, la richiesta viene rifiutata.

   Se non fornisci un'impronta, non viene eseguito alcun controllo di coerenza e la richiesta projects().setCommonInstanceMetadata va a buon fine. Questo comportamento è diverso dai metodi instances().setMetadata e instanceSettings().patch, in cui è sempre obbligatoria una impronta.

   Per ottenere l'impronta corrente di un progetto, chiama il metodo project().get.

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

   L'output è simile al seguente:

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

2. Invia una richiesta al metodo projects().setCommonInstanceMetadata e imposta le coppie chiave/valore dei metadati personalizzati:

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

Sostituisci PROJECT_ID con l'ID del tuo progetto.

gcloud

• Per aggiungere o aggiornare i metadati di zona personalizzati, utilizza il comando gcloud compute project-zonal-metadata add.

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

  Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto
  • ZONE: la zona in cui vuoi aggiungere o aggiornare i metadati di zona.
  • KEY1, KEY2…: le chiavi dei metadati personalizzati per i quali vuoi aggiungere o aggiornare i valori dei metadati zonali.

  • VALUE1, VALUE2 e così via: i valori dei metadati di zona che vuoi impostare per le chiavi dei metadati personalizzati esistenti e nuove. A seconda della chiave e del valore dei metadati personalizzati, si verifica una delle seguenti situazioni:

  • Se la chiave dei metadati personalizzati corrispondente è una chiave esistente con metadati di progetto, nella zona specificata Compute Engine sostituisce il valore dei metadati di progetto della chiave con il valore dei metadati zonali specificato. Tutte le VM nella zona specificata del progetto ereditano questi metadati di zona appena specificati per la chiave e le VM in altre zone continuano a mantenere i valori dei metadati di progetto o di zona prevalenti. Se apporti aggiornamenti futuri al valore dei metadati del progetto per questa chiave, le VM in questa zona del progetto rimangono invariate e continuano a utilizzare il valore dei metadati di zona per questa chiave.

  • Se la chiave dei metadati personalizzati corrispondente è una nuova chiave di metadati che non viene utilizzata per i metadati di progetto o di zona esistenti, Compute Engine crea la chiave dei metadati personalizzati e imposta questo valore come metadati di zona nella zona specificata.

  • Se la chiave dei metadati personalizzati corrispondente è una chiave dei metadati esistente con un valore dei metadati di zona nella zona specificata:

    • Se il valore dei metadati specificato è diverso da quello esistente, Compute Engine aggiorna la voce dei metadati zonali con il nuovo valore.
    • Se il valore dei metadati specificato corrisponde a quello esistente, la voce dei metadati zonali rimane invariata.

Esempio: aggiungi una nuova voce di metadati zonali personalizzati

Ad esempio, considera un progetto denominato my-project con i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"value-1" e "key-2":"value-2"

Per aggiungere "key-4":"value-4" come nuova coppia di metadati di zona personalizzati nella zona us-central1-a, esegui il seguente comando

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

Esempio: aggiorna i valori di una voce di metadati di zona personalizzati esistente

Considera lo stesso progetto di esempio my-project, che ora ha i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"value-1", "key-2":"value-2" e "key-4":"value-4"

Per aggiornare i valori dei metadati di zona di key-1 e key-4 nella zona us-cerntral1-a con nuovi valori, esegui il seguente comando.

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

Esempio: sostituisci il valore dei metadati del progetto per una chiave e utilizza un valore dei metadati zonali

Considera lo stesso progetto di esempio my-project, che ora ha i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2" e "key-4":"new-value-4"

In questo progetto di esempio, considera key-3, che ha un valore dei metadati del progetto di value-c. Supponiamo che tu voglia impostare un valore di metadati di zona value-3 per questa chiave per tutte le VM nella zona us-central1-a. Quando esegui l'operazione, per tutte le VM nella zona us-central1-a, Compute Engine sostituisce i valori dei metadati del progetto e utilizza i valori dei metadati della zona. Le VM in tutte le altre zone del progetto mantengono i valori dei metadati di progetto o di zona prevalenti per key-3.

Per sostituire il valore dei metadati del progetto per key-3 e impostare un valore di metadati per la zona, esegui il seguente comando:

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

REST

1. Ottieni l'impronta corrente e visualizza eventuali coppie chiave/valore esistenti per il progetto nella zona.

   Per eseguire il blocco ottimistico, devi fornire un'impronta. Un'impronta è una stringa casuale di caratteri generata da Compute Engine. L'impronta cambia ogni volta che effettui una richiesta di aggiunta, aggiornamento o rimozione di metadati zonali e, se fornisci un'impronta non corrispondente, Compute Engine rifiuta la richiesta.

   Se non fornisci un'impronta, viene eseguito un controllo di coerenza e la richiesta di aggiornamento non va a buon fine. In questo modo è possibile effettuare una sola richiesta alla volta, evitando collisioni. Questo comportamento corrisponde a instances().setMetadata, dove è sempre richiesta un'impronta.

   Per ottenere l'impronta corrente dei metadati di zona, effettua una richiesta GET al metodo instanceSettings().get.

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

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto
   • ZONE: la zona in cui vuoi impostare i metadati di zona.

   Di seguito è riportato un esempio di output per questa richiesta:

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

2. Per aggiungere o aggiornare i metadati di zona, effettua una richiesta PATCH al metodo instanceSettings().patch. Devi fornire quanto segue con la tua richiesta:

   • Una maschera di aggiornamento. Utilizza il parametro di query update_mask. La maschera di aggiornamento deve contenere le chiavi dei metadati per quanto segue:

     • I nuovi metadati di zona personalizzati da aggiungere
     • I metadati di zona personalizzati esistenti per i quali vuoi aggiornare i valori

     Devi aggiungere la stringa metadata.items. come prefisso per ogni chiave, ad esempio metadata.items.key1,metadata.items.key3.

   • Nel corpo della richiesta, fornisci quanto segue:

     • Le chiavi e i valori dei metadati per i nuovi metadati zonali personalizzati che vuoi aggiungere
     • Le chiavi e i valori dei metadati di zona personalizzati esistenti che vuoi aggiornare
     • Il valore attuale dell'impronta

   PATCH https://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",
         ...
       }
     }
   }
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del progetto.
   • ZONE: la zona in cui vuoi impostare i metadati di zona.

   • PREFIXED_METADATA_KEYS: l'elenco delle chiavi dei metadati per quanto segue, dove a ogni chiave è anteposto il prefisso metadata.items.:

     • I nuovi metadati di zona personalizzati da aggiungere
     • I metadati di zona personalizzati esistenti per i quali vuoi aggiornare i valori

     Ad esempio, supponiamo che le chiavi dei metadati zonali correnti in una zona specifica siano key-1 e key-2. Se vuoi aggiungere una nuova chiave, key-3, per i metadati di zona nella zona in questione e aggiornare anche i metadati di zona per una delle chiavi esistenti, key-1, la maschera di aggiornamento deve avere la seguente stringa:

     metadata.items.key1,metadata.items.key3

   • FINGER_PRINT: il valore attuale dell'impronta.

   • KEY1, KEY2 e così via: le chiavi dei metadati di zona personalizzati per i quali vuoi aggiungere o aggiornare i valori. Specifica tutte le chiavi dei metadati zonali personalizzati che hai specificato nella maschera di aggiornamento.

   • VALUE1, VALUE2 e così via: i valori dei metadati di zona che vuoi impostare per le chiavi dei metadati personalizzati esistenti e nuove. A seconda della chiave e del valore dei metadati personalizzati, si verifica una delle seguenti situazioni:

     • Se la chiave dei metadati personalizzati corrispondente è una chiave esistente con metadati di progetto, nella zona specificata Compute Engine sostituisce il valore dei metadati di progetto della chiave con il valore dei metadati zonali specificato. Tutte le VM nella zona specificata del progetto ereditano questi metadati di zona appena specificati per quella chiave e le VM in altre zone continuano a mantenere i valori dei metadati di progetto o di zona prevalenti. Se apporti aggiornamenti futuri al valore dei metadati del progetto per questa chiave, le VM in questa zona del progetto rimangono invariate e continuano a utilizzare il valore dei metadati di zona per questa chiave.
     • Se la chiave dei metadati personalizzati corrispondente è una nuova chiave di metadati che non viene utilizzata per i metadati di progetto o di zona esistenti, Compute Engine crea la chiave dei metadati personalizzati e imposta questo valore come metadati di zona nella zona specificata.

     • Se la chiave dei metadati personalizzati corrispondente è una chiave dei metadati esistente con un valore dei metadati di zona nella zona specificata:

     • Se il valore dei metadati specificato è diverso da quello esistente, Compute Engine aggiorna la voce dei metadati zonali con il nuovo valore.

     • Se il valore dei metadati specificato corrisponde a quello esistente, la voce dei metadati zonali rimane invariata.

Esempio: aggiungi una nuova voce di metadati zonali personalizzati

Ad esempio, considera un progetto denominato my-project con i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"value-1" e "key-2":"value-2"

Per aggiungere "key-4":"value-4" come nuova coppia di metadati di zona personalizzati nella zona us-central1-a, effettua la seguente richiesta PATCH:

PATCH https://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"
    }
  }
}

Esempio: aggiorna i valori di una voce di metadati di zona personalizzata esistente

Considera lo stesso progetto di esempio my-project, che ora ha i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"value-1", "key-2":"value-2" e "key-4":"value-4"

Per aggiornare i valori dei metadati di zona di key-1 e key-4 nella zona us-cerntral1-a con nuovi valori, effettua la seguente richiesta PATCH:

PATCH https://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"
    }
  }
}

Esempio: sostituisci il valore dei metadati di progetto per una chiave e imposta un valore dei metadati zonali

Considera lo stesso progetto di esempio my-project, che ora ha i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2" e "key-4":"new-value-4"

In questo progetto di esempio, considera key-3, che ha un valore dei metadati del progetto di value-c. Supponiamo che tu voglia impostare un valore di metadati di zona value-3 per questa chiave per tutte le VM nella zona us-central1-a. Quando esegui l'operazione, per tutte le VM nella zona us-central1-a, Compute Engine sostituisce i valori dei metadati del progetto e utilizza i valori dei metadati zonali. Le VM in tutte le altre zone del progetto mantengono i valori dei metadati di progetto o di zona prevalenti per key-3.

Per sostituire il valore dei metadati del progetto per key-3 e utilizzare il valore dei metadati di zona value-3, effettua la seguente richiesta PATCH:

PATCH https://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. Nella console Google Cloud, vai alla pagina Crea un'istanza.

   Vai a Crea un'istanza

2. Specifica i dettagli della VM.

3. Espandi la sezione Opzioni avanzate e segui questi passaggi:

   1. Espandi la sezione Gestione.
   2. Per aggiungere più coppie chiave-valore per i metadati personalizzati, fai clic su Aggiungi elemento nella sezione Metadati.

4. Per creare la VM, fai clic su Crea.

gcloud

Per impostare metadati personalizzati, utilizza il comando gcloud compute instances create con il flag --metadata.

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

Sostituisci quanto segue:

• VM_NAME: il nome della VM
• KEY: il nome della chiave dei metadati
• VALUE: il valore memorizzato per questa chiave

Esempio

Ad esempio, per impostare una nuova chiave foo con un valore bar su una VM denominata example-instance, esegui il seguente comando:

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

REST

Utilizza il metodo instances.insert e fornisci i metadati personalizzati come parte della proprietà metadata nella richiesta:

POST https://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"
      }
    ]
  },
  ..
}

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto
• ZONE: la zona in cui creare la VM
• MACHINE_TYPE: tipo di macchina, predefinito o personalizzato, per la nuova VM
• VM_NAME: nome della nuova VM
• KEY: il nome della chiave dei metadati
• VALUE: il valore memorizzato per questa chiave

Console

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai alla pagina Istanze VM

2. Fai clic sull'istanza per cui vuoi aggiornare i metadati.
3. Fai clic sul pulsante Modifica nella parte superiore della pagina.
4. In Metadati personalizzati, fai clic su Aggiungi elemento o modifica le voci dei metadati esistenti.
5. Salva le modifiche.

gcloud

L'aggiornamento dei metadati della VM con l'gcloud CLI è un'azione aggiuntiva. Specifica solo le chiavi dei metadati che vuoi aggiungere o modificare. Se una chiave che hai fornito esiste già, il valore della chiave viene aggiornato con il nuovo valore.

Utilizza il comando instances add-metadata:

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

Sostituisci quanto segue:

• VM_NAME: il nome della VM
• KEY: il nome della chiave dei metadati
• VALUE: il valore memorizzato per questa chiave

Esempi

Se vuoi aggiungere la voce foo=bar, utilizza:

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

Se vuoi modificare la voce foo=bar in foo=bat, utilizza:

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

REST

1. Ottieni l'impronta corrente e visualizza eventuali coppie chiave-valore esistenti per la VM. Per farlo, chiama il metodo instances().get.

   Un'impronta è una stringa casuale di caratteri generata da Compute Engine e viene utilizzata per eseguire il blocco ottimistico. Per aggiornare la VM, devi fornire il valore dell'impronta corrispondente. L'impronta cambia dopo ogni richiesta e, se fornisci un'impronta non corrispondente, la richiesta viene rifiutata. In questo modo è possibile apportare un solo aggiornamento alla volta, evitando collisioni.

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

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto
   • ZONE: la zona in cui si trova la VM
   • VM_NAME: il nome della VM

   L'output è simile al seguente:

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

2. Invia una richiesta al metodo instances().setMetadata. Fornisci un elenco dei nuovi valori dei metadati e del valore fingerprint attuale.

   Se la VM ha coppie chiave-valore esistenti che vuoi conservare, devi includerle in questa richiesta insieme alle nuove coppie chiave-valore.

   Esempio

   POST https://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"
     }
   ]
   }
   

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto
   • ZONE: la zona in cui si trova la VM
   • VM_NAME: il nome della VM

Console

1. Nella console Google Cloud, vai alla pagina Metadati.

   Vai alla pagina Metadati

2. Fai clic su edit Modifica nella parte superiore della pagina.

3. Vai alla voce dei metadati che vuoi rimuovere e fai clic sul pulsante di eliminazione delete accanto alla voce.

   Ripeti questo passaggio per ogni voce di metadati che vuoi rimuovere.

4. Per completare la rimozione delle voci dei metadati del progetto personalizzato, fai clic su Salva.

gcloud

Per rimuovere i metadati del progetto personalizzati, utilizza il comando gcloud compute project-info remove-metadata.

• Se vuoi rimuovere le voci dei metadati personalizzati per chiavi specifiche, specifica queste chiavi utilizzando il flag --keys ed escludi i valori di quelle chiavi.

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

• Se vuoi rimuovere tutti i metadati personalizzati per la VM, specifica il --all flag.

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

Sostituisci quanto segue:

• KEY1, KEY2...: le chiavi dei metadati delle istanze personalizzate che vuoi rimuovere.

gcloud

Per rimuovere i metadati zonali personalizzati, utilizza il comando gcloud compute project-zonal-metadata remove e specifica tutte le chiavi di metadati che vuoi rimuovere utilizzando il --keys flag.

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

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto
• ZONE: la zona in cui vuoi rimuovere i metadati di zona.
• KEY1, KEY2...: le chiavi dei metadati zonali personalizzati che vuoi rimuovere.

Dopo aver eseguito il comando, se per una delle chiavi specificate sono disponibili valori dei metadati del progetto, le VM nella zona specificata erediteranno questi valori. Se la voce dei metadati è stata impostata solo a livello di zona e non esiste un valore dei metadati di progetto corrispondente per quella chiave, le VM in quella zona perdono queste informazioni sui metadati.

Esempio:

Considera un progetto di esempio my-project, con i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2", "key-3":"value-3" e "key-4":"new-value-4"

Per rimuovere tutti i metadati di zona nella zona us-central1-a, esegui il seguente comando.

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

Dopo aver eseguito il comando, le VM nella zona us-central1-a dispongono delle seguenti voci di metadati di progetto personalizzati:

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

REST

1. Ottieni l'impronta corrente e visualizza eventuali coppie chiave/valore esistenti per il progetto nella zona.

   Per eseguire il blocco ottimistico, devi fornire un'impronta. Un'impronta è una stringa casuale di caratteri generata da Compute Engine. L'impronta cambia ogni volta che effettui una richiesta di aggiunta, aggiornamento o rimozione di metadati zonali e, se fornisci un'impronta non corrispondente, Compute Engine rifiuta la richiesta.

   Se non fornisci un'impronta, viene eseguito un controllo di consistenza e la richiesta di eliminazione non va a buon fine. In questo modo è possibile effettuare una sola richiesta alla volta, evitando collisioni. Questo comportamento corrisponde a instances().setMetadata, dove è sempre richiesta un'impronta.

   Per ottenere l'impronta corrente di un progetto, effettua una chiamata al metodo instanceSettings().get.

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

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto
   • ZONE: la zona in cui vuoi rimuovere i metadati di zona.

   Di seguito è riportato un esempio di output per questa richiesta:

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

2. Per rimuovere i metadati di zona personalizzati, invia una richiesta PATCH al metodo instanceSettings().patch escludendo le chiavi dei metadati per i quali vuoi rimuovere i metadati di zona dal corpo della richiesta. Devi fornire quanto segue con la tua richiesta:

   • Una maschera di aggiornamento. Utilizza il parametro di query update_mask. La maschera di aggiornamento deve contenere tutte le chiavi dei metadati personalizzati esistenti per i quali vuoi rimuovere i metadati di zona. Devi aggiungere la stringa metadata.items. come prefisso per ogni chiave, ad esempio metadata.items.key1,metadata.items.key3.

   • Nel corpo della richiesta, fornisci solo il valore attuale dell'impronta. Escludi tutte le chiavi dei metadati personalizzati specificate nella maschera di aggiornamento. Se includi una delle chiavi dei metadati sia nella maschera di aggiornamento sia nel corpo della richiesta, Compute Engine non rimuove i metadati zonali per queste chiavi.

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

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del progetto.
   • ZONE: la zona in cui vuoi rimuovere i metadati di zona.

   • PREFIXED_METADATA_KEYS: l'elenco di tutte le chiavi dei metadati personalizzati esistenti per i quali vuoi rimuovere i metadati di zona, dove a ogni chiave è anteposto il prefisso metadata.items.. Per assicurarti che la richiesta di eliminazione sia andata a buon fine, escludi queste chiavi dei metadati dal corpo della richiesta. Se includi una delle chiavi dei metadati sia nella maschera di aggiornamento sia nel corpo della richiesta, Compute Engine non rimuove i metadati zonali per queste chiavi.

     Ad esempio, supponiamo che le tue chiavi dei metadati attuali con metadati di zona siano key-1, key-2, key-3 e key-4 e che tu voglia rimuovere le voci dei metadati di zona per key-1 e key-2. La maschera di aggiornamento deve avere la seguente stringa:

     metadata.items.key1,metadata.items.key2

   • FINGER_PRINT: il valore attuale dell'impronta.

Dopo aver effettuato la richiesta, se per una delle chiavi specificate sono disponibili valori dei metadati del progetto, le VM nella zona specificata erediteranno questi valori. Se la chiave dei metadati è stata impostata solo a livello di zona e non esiste un valore dei metadati del progetto corrispondente per quella chiave, le VM in quella zona perdono queste informazioni sui metadati.

Esempio:

Considera un progetto di esempio my-project, con i seguenti metadati personalizzati:

• Metadati del progetto: "key-1":"value-a", "key-2":"value-b" e "key-3":"value-c"
• Metadati di zona nella zona us-central1-a: "key-1":"new-value-1", "key-2":"value-2", "key-3":"value-3" e "key-4":"new-value-4"

Per rimuovere i metadati di zona per key-1 e key-2 nella us-central1-a, invia la seguente richiesta PATCH.

PATCH https://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": {
    }
  }
}

Dopo l'elaborazione di questa richiesta, le VM nella zona us-central1-a dispongono dei seguenti metadati personalizzati. Le VM ereditano i valori dei metadati del progetto per key-1 e key-2, ma mantengono i metadati di zona per key-3 e key-4.

• Metadati del progetto: "key-1":"value-a" e "key-2":"value-b"
• Metadati di zona nella zona us-central1-a: "key-3":"value-3" e "key-4":"new-value-4"

Console

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai alla pagina Istanze VM

2. Nella colonna Nome, fai clic sul nome della VM per cui vuoi rimuovere i metadati.
3. Fai clic su edit Modifica nella parte superiore della pagina.
4. Nella sezione Metadati, fai clic su delete Elimina elemento per ogni voce dei metadati che vuoi rimuovere.
5. Per confermare le modifiche e rimuovere i metadati dell'istanza personalizzata, fai clic su Salva.

gcloud

Per rimuovere i metadati delle istanze personalizzate, utilizza il comando gcloud compute instances remove-metadata.

• Se vuoi rimuovere le voci dei metadati personalizzati per chiavi specifiche, specifica queste chiavi utilizzando il flag --keys ed escludi i valori di quelle chiavi.

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

• Se vuoi rimuovere tutti i metadati personalizzati per la VM, specifica il --all flag.

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

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto.
• ZONE: la zona della VM.
• VM_NAME: il nome della VM
• KEY1, KEY2...: le chiavi dei metadati delle istanze personalizzate che vuoi rimuovere.

REST

1. Ottieni l'impronta corrente e visualizza eventuali coppie chiave-valore esistenti per la VM. Per farlo, chiama il metodo instances().get.

   Un'impronta è una stringa casuale di caratteri generata da Compute Engine e viene utilizzata per eseguire il blocco ottimistico. Per aggiornare la VM, devi fornire il valore dell'impronta corrispondente. L'impronta cambia dopo ogni richiesta e, se fornisci un'impronta non corrispondente, la richiesta viene rifiutata. In questo modo è possibile apportare un solo aggiornamento alla volta, evitando collisioni.

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

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto.
   • ZONE: la zona della VM.
   • VM_NAME: il nome della VM

   L'output è simile al seguente:

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

2. Invia una richiesta al metodo instances().setMetadata. Per la corretta elaborazione della richiesta, devi includere il valore corrente dell'impronta dei metadati.

   • Per rimuovere tutte le coppie chiave-valore dei metadati personalizzati da una VM, nella proprietà items escludi le chiavi dei metadati per i quali vuoi rimuovere i valori dei metadati.

     POST https://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"
       }
       ...
     ]
     }
     

   • Per rimuovere tutti i metadati delle istanze personalizzate sulla VM, escludi del tutto la proprietà items.

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

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto.
   • ZONE: la zona della VM.
   • VM_NAME: il nome della VM
   • FINGER_PRINT: il valore attuale dell'impronta.
   • KEY1, KEY2...: le chiavi dei metadati delle istanze personalizzate che vuoi rimuovere.
   • VALUE1, VALUE2…: i valori delle chiavi dei metadati delle istanze personalizzate che vuoi rimuovere.