Visualizza ed esegui query sui metadati della VM

Linux

1. Connettiti alla VM Linux.

2. Dalla VM Linux, utilizza lo strumento curl per eseguire una query. Per eseguire una query per una voce di metadati di un'istanza VM o di un progetto, esegui il seguente comando:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY" -H "Metadata-Flavor: Google"
   

   Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

   • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
   • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
   • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.

   Ad esempio, per eseguire una query sull'immagine di avvio della VM, esegui la seguente query:

   user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/image" -H "Metadata-Flavor: Google"
   

   L'output è simile al seguente:

   projects/rhel-cloud/global/images/rhel-8-v20210122

Windows

1. Connettiti alla VM Windows.

2. Dalla VM Windows, utilizza il comando Invoke-RestMethod per eseguire una query. Per eseguire una query per una voce di metadati di un'istanza VM o di un progetto, esegui questo comando:

   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY")
   $value
   

   Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

   • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
   • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
   • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.

   Ad esempio, per eseguire una query sull'immagine di avvio della VM, esegui la seguente query:

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/image")
   $value
   

   L'output è simile al seguente:

   projects/windows-cloud/global/images/windows-server-2019-dc-v20210112

Linux

1. Connettiti alla VM Linux.

2. Per eseguire query su una directory di metadati di un progetto o di un'istanza VM, dalla VM Linux, esegui questo comando:

     curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/" -H "Metadata-Flavor: Google"
     

   Sostituisci PATH_TO_METADATA_DIRECTORY con il percorso della directory dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query ricorsive sugli elenchi. Ad esempio:

   • Per visualizzare la voce di directory dei metadati del progetto attributes, il percorso da specificare è project/attributes/.
   • Per visualizzare la voce di directory dei metadati dell'istanza VM disks, il percorso da specificare è instance/disks/.

   Ad esempio, considera la voce disks/, che è una directory dei dischi collegati alla VM. Per eseguire una query sulla voce disks/, completa i seguenti passaggi:

   1. Esegui il comando curl tool nella directory dei dischi.

      user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/" -H "Metadata-Flavor: Google"
      

      L'output è simile al seguente:

      0/
      1/
      2/
      

   2. Se vuoi maggiori informazioni sulla directory 0/ del disco, puoi interrogare l'URL specifico di quella directory:

      user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/" -H "Metadata-Flavor: Google"
      

      L'output è simile al seguente:

      device-name
      index
      mode
      type
      

   3. Per eseguire una query sul tipo di disco (type) per i dischi 0/, puoi eseguire il comando seguente:

      user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/type" -H "Metadata-Flavor: Google"
      

      L'output è simile al seguente:

      PERSISTENT
      

Windows

La voce disks/ è una directory dei dischi collegati alla VM. Per eseguire una query sulla voce relativa ai dischi, completa i seguenti passaggi:

1. Connettiti alla VM Windows.

2. Per eseguire una query per una directory di metadati di un progetto o di un'istanza VM, dalla tua VM Windows, esegui questo comando:

   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/")
   $value
   

   Sostituisci PATH_TO_METADATA_DIRECTORY con il percorso della directory dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query ricorsive sugli elenchi. Ad esempio:

   • Per visualizzare la voce di directory dei metadati del progetto attributes, il percorso da specificare è project/attributes/.
   • Per visualizzare la voce di directory dei metadati dell'istanza VM disks, il percorso da specificare è instance/disks/.

   Ad esempio, considera la voce disks/, che è una directory dei dischi collegati alla VM. Per eseguire una query sulla voce disks/, completa i seguenti passaggi:

   1. Utilizza il comando Invoke-RestMethod nella directory dei dischi.

      PS C:\> 
      $value = (Invoke-RestMethod `
                -Headers @{'Metadata-Flavor' = 'Google'} `
                -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/")
      $value
      

      L'output è simile al seguente:

      0/
      1/
      2/
      

   2. Se vuoi maggiori informazioni sulla directory 0/ del disco, puoi eseguire una query sull'URL specifico di questa directory:

      PS C:\> 
      $value = (Invoke-RestMethod `
                -Headers @{'Metadata-Flavor' = 'Google'} `
                -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/")
      $value
      

      L'output è simile al seguente:

      device-name
      index
      mode
      type
      

   3. Per eseguire una query sul tipo di disco (type) per i dischi 0/, puoi eseguire il comando seguente:

      PS C:\> 
      $value = (Invoke-RestMethod `
                -Headers @{'Metadata-Flavor' = 'Google'} `
                -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/0/type")
      $value
      

      L'output è simile al seguente:

      PERSISTENT
      

Linux

1. Connettiti alla VM Linux.

2. Dalla VM Linux, utilizza lo strumento curl per eseguire una query. Per eseguire query in modo ricorsivo sugli elenchi per una VM o una directory di metadati del progetto, esegui questo comando:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/?recursive=true" -H "Metadata-Flavor: Google"
   

   Sostituisci PATH_TO_METADATA_DIRECTORY con il percorso della directory dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query ricorsive sugli elenchi. Ad esempio:

   • Per visualizzare la voce di directory dei metadati del progetto attributes, il percorso da specificare è project/attributes/.
   • Per visualizzare la voce di directory dei metadati dell'istanza VM disks, il percorso da specificare è instance/disks/.

   Ad esempio, il seguente comando esegue una query ricorsiva sugli elenchi di metadati dell'istanza per la directory disks/.

     user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true" -H "Metadata-Flavor: Google"
     

   L'output è simile al seguente:

     [{"deviceName":"boot","index":0,"mode":"READ_WRITE","type":"PERSISTENT"},
     {"deviceName":"persistent-disk-1","index":1,"mode":"READ_WRITE","type":"PERSISTENT"},
     {"deviceName":"persistent-disk-2","index":2,"mode":"READ_ONLY","type":"PERSISTENT"}]
     

   Per impostazione predefinita, i contenuti ricorsivi vengono restituiti in formato JSON. Se vuoi restituire questi contenuti in formato di testo, aggiungi il parametro di query alt=text:

     user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true&alt=text" -H "Metadata-Flavor: Google"
     

   L'output è simile al seguente:

     0/device-name boot
     0/index 0
     0/mode READ_WRITE
     0/type PERSISTENT
     1/device-name persistent-disk-1
     1/index 1
     1/mode READ_WRITE
     1/type PERSISTENT
     2/device-name persistent-disk-1
     2/index 2
     2/mode READ_ONLY
     2/type PERSISTENT
     

Windows

1. Connettiti alla VM Windows.

2. Dalla VM Windows, utilizza il comando Invoke-RestMethod per eseguire una query. Per eseguire query in modo ricorsivo sugli elenchi di una directory di metadati di un progetto o di un'istanza VM, esegui questo comando:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
               -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_DIRECTORY/?recursive=true")
     $value
     

   Sostituisci PATH_TO_METADATA_DIRECTORY con il percorso della directory dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query ricorsive sugli elenchi. Ad esempio:

   • Per visualizzare la voce di directory dei metadati del progetto attributes, il percorso da specificare è project/attributes/.
   • Per visualizzare la voce di directory dei metadati dell'istanza VM disks, il percorso da specificare è instance/disks/.

   Ad esempio, il seguente comando esegue una query ricorsiva sugli elenchi di metadati dell'istanza per la directory disks/.

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true")
   $value
   

   L'output è simile al seguente:

   [{"deviceName":"boot","index":0,"mode":"READ_WRITE","type":"PERSISTENT"},
   {"deviceName":"persistent-disk-1","index":1,"mode":"READ_WRITE","type":"PERSISTENT"},
   {"deviceName":"persistent-disk-2","index":2,"mode":"READ_ONLY","type":"PERSISTENT"}]
   

   Per impostazione predefinita, i contenuti ricorsivi vengono restituiti in formato JSON. Se vuoi restituire questi contenuti in formato di testo, aggiungi il parametro di query alt=text:

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/instance/disks/?recursive=true&alt=text")
   $value
   

   L'output è simile al seguente:

   0/device-name boot
   0/index 0
   0/mode READ_WRITE
   0/type PERSISTENT
   1/device-name persistent-disk-1
   1/index 1
   1/mode READ_WRITE
   1/type PERSISTENT
   2/device-name persistent-disk-1
   2/index 2
   2/mode READ_ONLY
   2/type PERSISTENT
   

Linux

1. Connettiti alla VM Linux.

2. Dalla VM Linux, utilizza lo strumento curl per eseguire una query. Per modificare il formato dei dati di risposta alla query per una voce di metadati di un progetto o di un'istanza VM, esegui questo comando:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?alt=DATA_FORMAT" -H "Metadata-Flavor: Google"
   

   Sostituisci quanto segue:

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.
   • DATA_FORMAT: il formato in cui vuoi i dati di risposta alla query, ad esempio text o json.

Esempio

Ad esempio, la chiave tags restituisce automaticamente i dati in formato JSON. Puoi restituire i dati in formato di testo specificando il parametro di query alt=text.

Query predefinita

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags" -H "Metadata-Flavor: Google"
  

L'output è simile al seguente:

  ["http-server", "db-client", "app-server", "mysql-server"]
  

Query con formattazione

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?alt=text" -H "Metadata-Flavor: Google"
  

L'output è simile al seguente:

  http-server
  db-client
  app-server
  mysql-server

Windows

1. Connettiti alla VM Windows.

2. Dalla VM Windows, utilizza il comando Invoke-RestMethod per eseguire una query. Per modificare il formato dei dati di risposta della query per una voce di metadati di un progetto o di un'istanza VM, esegui questo comando:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
               -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?alt=DATA_FORMAT")
     $value
     

   Sostituisci quanto segue:

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.
   • DATA_FORMAT: il formato in cui vuoi i dati di risposta alla query, ad esempio text o json.

Esempio

Ad esempio, la chiave tags restituisce automaticamente i dati in formato JSON. Puoi restituire i dati in formato di testo specificando il parametro di query alt=text.

Query predefinita

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags")
  $value
  

L'output è simile al seguente:

  ["http-server", "db-client", "app-server", "mysql-server"]
  

Query con formattazione

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?alt=text")
  $value
  

L'output è simile al seguente:

  http-server
  db-client
  app-server
  mysql-server

Linux

1. Connettiti alla VM Linux.

2. Dalla VM Linux, utilizza lo strumento curl per eseguire una query. Per eseguire una richiesta wait-for-change per una voce di metadati di un progetto o di un'istanza VM, esegui questo comando:

   curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true" -H "Metadata-Flavor: Google"
   

   Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

   • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
   • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
   • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.

   Dopo una modifica alla chiave dei metadati specificata, la query restituisce il nuovo valore.

Esempi

In questo esempio, se viene effettuata una richiesta a setInstanceTags method, la richiesta viene restituita con i nuovi valori:

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true" -H "Metadata-Flavor: Google"
  

L'output è simile al seguente:

  http-server
  db-client
  

Puoi anche eseguire una richiesta wait-for-change in modo ricorsivo sui contenuti di una directory:

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/attributes/?recursive=true&wait_for_change=true" -H "Metadata-Flavor: Google"
  

Se vengono apportate modifiche, il server metadati restituisce i nuovi contenuti:

  {"foo":"bar","baz":"bat"}
  

Windows

1. Connettiti alla VM Windows.

2. Dalla VM Windows, utilizza il comando Invoke-RestMethod per eseguire una query. Per eseguire una richiesta wait-for-change per una voce di metadati di un progetto o di un'istanza VM, esegui questo comando:

   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true")
   $value
   

   Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

   • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
   • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
   • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.

   Dopo una modifica alla chiave dei metadati specificata, la query restituisce il nuovo valore.

Esempi

Dopo una modifica alla chiave dei metadati specificata, la query restituisce il nuovo valore. In questo esempio, se viene effettuata una richiesta a setInstanceTags method, la richiesta viene restituita con i nuovi valori:

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true")
  $value
  

L'output è simile al seguente:

  http-server
  db-client
  

Puoi anche eseguire una richiesta wait-for-change in modo ricorsivo sui contenuti di una directory:

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes?recursive=true&wait_for_change=true")
  $value
  

Se vengono apportate modifiche, il server metadati restituisce i nuovi contenuti:

  {"foo":"bar","baz":"bat"}
  

VM Linux

Per ottenere il valore ETag corrente per una chiave di metadati, completa i seguenti passaggi:

1. Connettiti alla VM Linux.

2. Invia una richiesta a questa chiave e stampa le intestazioni. Per farlo, utilizza lo strumento curl con il flag -v. Per ottenere l'ETag corrente per una voce di metadati di un progetto o di un'istanza VM, esegui il seguente comando:

   curl -v "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY" -H "Metadata-Flavor: Google"
   

   Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

   • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
   • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
   • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.

   Ad esempio, il seguente comando recupera il valore ETag corrente per la chiave dei metadati dell'istanza tags.

     user@myinst:~$ curl -v "http://metadata.google.internal/computeMetadata/v1/instance/tags" -H "Metadata-Flavor: Google"
     

   L'output è simile al seguente:

   * About to connect() to metadata port 80 (#0)
   * Trying 169.254.169.254... connected
   * Connected to metadata (169.254.169.254) port 80 (#0)
   > GET /computeMetadata/v1/instance/tags HTTP/1.1
   > User-Agent: curl/7.19.7 (x86_64-pc-linux-gnu) libcurl/7.19.7 OpenSSL/0.9.8k zlib/1.2.3.3 libidn/1.15
   > Host: metadata
   > Accept: */*
   >
   < HTTP/1.1 200 OK
   < Content-Type: application/text
   < ETag: 411261ca6c9e654e
   < Date: Wed, 13 Feb 2013 22:43:45 GMT
   < Server: Metadata Server for VM
   < Content-Length: 26
   < X-XSS-Protection: 1; mode=block
   < X-Frame-Options: SAMEORIGIN
   <
   http-server
   db-client

3. Puoi quindi utilizzare il valore ETag con il comando curl tool nella richiesta wait-for-change. Per utilizzare il valore ETag per la richiesta wait-for-change dei metadati dell'istanza o del progetto, esegui il seguente comando:

     curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&last_etag=ETAG" -H "Metadata-Flavor: Google"
     

   Sostituisci quanto segue:

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.
   • ETAG: il valore ETag per la chiave dei metadati.

   In questo esempio, il seguente comando utilizza il valore ETag per la chiave tags ed esegue una query per la voce dei metadati dell'istanza.

     user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&last_etag=411261ca6c9e654e" -H "Metadata-Flavor: Google"
     

   Il server metadati corrisponde al valore ETag specificato e, se questo valore cambia, la richiesta viene restituita con i nuovi contenuti della chiave di metadati.

VM Windows

Per ottenere il valore ETag corrente per una chiave di metadati, completa i seguenti passaggi:

1. Connettiti alla VM Windows.

2. Invia una richiesta a questa chiave e stampa le intestazioni. Su Windows, utilizza il comando Invoke-WebRequest. Per ottenere l'ETag corrente per una voce di metadati di un progetto o di un'istanza VM, esegui il seguente comando:

     $value = (Invoke-WebRequest -Headers @{'Metadata-Flavor' = 'Google'} `
     -Uri http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY)
   
   
   $value.Headers.ETag
     

   Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

   • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
   • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
   • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.

   Ad esempio, il seguente comando recupera il valore ETag corrente per la chiave dei metadati dell'istanza tags.

     PS C:> 
     $value = (Invoke-WebRequest -Headers @{'Metadata-Flavor' = 'Google'} `
     -Uri http://metadata.google.internal/computeMetadata/v1/instance/tags)
   
   
   $value.Headers.ETag
     

   L'output è simile al seguente:

     * About to connect() to metadata port 80 (#0)
     * Trying 169.254.169.254... connected
     * Connected to metadata (169.254.169.254) port 80 (#0)
     > GET /computeMetadata/v1/instance/tags HTTP/1.1
     > User-Agent: curl/7.19.7 (x86_64-pc-linux-gnu) libcurl/7.19.7 OpenSSL/0.9.8k zlib/1.2.3.3 libidn/1.15
     > Host: metadata
     > Accept: /
     >
     < HTTP/1.1 200 OK
     < Content-Type: application/text
     < ETag: 411261ca6c9e654e
     < Date: Wed, 13 Feb 2013 22:43:45 GMT
     < Server: Metadata Server for VM
     < Content-Length: 26
     < X-XSS-Protection: 1; mode=block
     < X-Frame-Options: SAMEORIGIN
     <
     http-server
     db-client

3. Puoi quindi utilizzare il valore ETag nella richiesta wait-for-change. Per utilizzare il valore ETag per la richiesta wait-for-change dei metadati dell'istanza o del progetto, esegui questo comando:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&last_etag=ETAG")
     $value
     

   Sostituisci quanto segue:

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.
   • ETAG: il valore ETag per la chiave dei metadati.

   In questo esempio, il seguente comando utilizza il valore ETag per la chiave tags ed esegue una query per la voce dei metadati dell'istanza.

     PS C:> 
     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
               -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&last_etag=411261ca6c9e654e")
     $value
     

   Il server metadati corrisponde al valore ETag specificato e, se questo valore cambia, la richiesta viene restituita con i nuovi contenuti della chiave di metadati.

Python

Il seguente esempio Python mostra come monitorare a livello di programmazione il server dei metadati per rilevare le modifiche.

Questo esempio imposta l'ETag iniziale su 0. Il server dei metadati non restituisce una risposta con 0 come valore ETag. Quando 0 viene specificato come ultimo ETag in una richiesta, il server dei metadati risponde con il valore corrente e l'ETag. In questo modo si risparmia un po' di codice necessario per ottenere il valore iniziale e l'ETag.

last_etag = "0"

while True:
    r = requests.get(
        url,
        params={"last_etag": last_etag, "wait_for_change": True},
        headers=METADATA_HEADERS,
    )

    # During maintenance the service can return a 503, so these should
    # be retried.
    if r.status_code == 503:
        time.sleep(1)
        continue
    r.raise_for_status()

    last_etag = r.headers["etag"]

Linux

1. Connettiti alla VM Linux.

2. Dalla VM Linux, utilizza lo strumento curl per eseguire una query. Per eseguire una richiesta wait-for-change con un valore di timeout per una voce di metadati di un'istanza VM o di un progetto, esegui questo comando:

     curl "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&timeout_sec=TIMEOUT" -H "Metadata-Flavor: Google"
     

   Sostituisci quanto segue:

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.
   • TIMEOUT: il valore di timeout.

Ad esempio, il seguente comando esegue una richiesta wait-for-change che scade dopo 360 secondi:

  user@myinst:~$ curl "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&timeout_sec=360" -H "Metadata-Flavor: Google"
  

Windows

1. Connettiti alla VM Windows.

2. Dalla VM Windows, utilizza il comando Invoke-RestMethod per eseguire una query. Per eseguire una richiesta wait-for-change con un valore di timeout per una voce di metadati di un'istanza VM o di un progetto, esegui questo comando:

     $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
             -Uri "http://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY?wait_for_change=true&timeout_sec=TIMEOUT")
     $value
     

   Sostituisci quanto segue:

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.
   • TIMEOUT: il valore di timeout.

Ad esempio, il seguente comando esegue una richiesta wait-for-change che scade dopo 360 secondi:

  PS C:> 
  $value = (Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'}
            -Uri "http://metadata.google.internal/computeMetadata/v1/instance/tags?wait_for_change=true&timeout_sec=360")
  $value
  

Linux

1. Connettiti alla VM Linux.

2. Dalla tua VM Linux, utilizza lo strumento curl per eseguire una query e specificare il certificato di identità client. Se vuoi, puoi anche specificare il certificato radice.

   curl "https://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY" \
     -E CLIENT_CERTIFICATE \
     [--cacert ROOT_CERTIFICATE] \
     -H "Metadata-Flavor: Google"
   

   Sostituisci quanto segue:

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.
   • CLIENT_CERTIFICATE: il percorso del certificato di identità client: /run/google-mds-mtls/client.key.
   • (Facoltativo) ROOT_CERTIFICATE: il percorso del certificato root: /run/google-mds-mtls/root.crt. Devi specificare questo valore se il certificato radice non viene aggiunto all'archivio di attendibilità del sistema operativo.

   Ad esempio, per eseguire una query sull'immagine di avvio di una VM, esegui la seguente query:

   user@myinst:~$ 
   curl "https://metadata.google.internal/computeMetadata/v1/instance/image" \
     -E /run/google-mds-mtls/client.key \
     -H "Metadata-Flavor: Google"
   

   L'output è simile al seguente:

   projects/rhel-cloud/global/images/rhel-8-v20210122

   Se viene visualizzato un messaggio di errore, consulta la documentazione per la risoluzione dei problemi.

Windows

1. Connettiti alla VM Windows.

2. Recupera il certificato di identità client utilizzando uno dei seguenti comandi:

   • $cert = Get-PfxCertificate -FilePath "C:\ProgramData\Google\Compute Engine\mds-mtls-client.key.pfx"
     

   • $cert = Get-ChildItem Cert:\LocalMachine\My | Where-Object { $_.Issuer -like "google.internal" }
     

3. Dalla VM Windows, utilizza il comando Invoke-RestMethod e specifica il certificato di identità client per eseguire una query.

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} -Certificate CLIENT_CERTIFICATE `
             -Uri "https://metadata.google.internal/computeMetadata/v1/PATH_TO_METADATA_ENTRY")
   $value
   

   Sostituisci quanto segue:

   • CLIENT_CERTIFICATE: il percorso del certificato di identità client sulla VM. Si tratta della variabile $cert impostata nel passaggio precedente.

   • Sostituisci PATH_TO_METADATA_ENTRY con il percorso della chiave dei metadati dell'istanza VM o del progetto per cui vuoi eseguire query sul valore. Se la chiave si trova in una sottodirectory della directory dell'istanza o del progetto, assicurati di includere anche la sottodirectory. Ad esempio:

     • Per visualizzare la chiave di metadati project-id, archiviata nei metadati del progetto, specifica project/project-id.
     • Per visualizzare la chiave di metadati image, archiviata nei metadati dell'istanza VM, specifica instance/image.
     • Per visualizzare enable-oslogin che possono essere archiviati nella sottodirectory degli attributi dei metadati del progetto o dell'istanza VM, specifica project/attributes/enable-oslogin o instance/attributes/enable-oslogin a seconda del caso d'uso.

   Ad esempio, per eseguire una query sull'immagine di avvio di una VM Windows Server 2019, esegui la seguente query:

   PS C:\> 
   $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} -Certificate $cert `
             -Uri "https://metadata.google.internal/computeMetadata/v1/instance/image")
   $value
   

   L'output è simile al seguente:

   projects/windows-cloud/global/images/windows-server-2019-dc-v20210112

Console

1. Nella console Trusted Cloud , vai alla pagina Metadati

   Vai alla pagina Metadati

   Nella pagina Metadati, viene visualizzato un elenco di tutte le voci di metadati personalizzati del progetto.

gcloud

Utilizza il comando gcloud compute project-info describe per eseguire query sui metadati del progetto:

gcloud compute project-info describe --flatten="commonInstanceMetadata[]"

L'output è simile al seguente:

---
fingerprint: HcSFdS_1_1I=
items:
- key: ssh-keys
  value: USERNAME:ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDWZ...
kind: compute#metadata

REST

Per eseguire query sui metadati del progetto, crea una richiesta GET al metodo project.get.

Sostituisci PROJECT_ID con l'ID progetto.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID

L'output è simile al seguente:

"kind": "compute#project",
"id": "XXXXXXX",
"creationTimestamp": "2018-12-10T08:34:33.616-08:00",
"name": "YOUR_PROJECT",
"commonInstanceMetadata": {
  "kind": "compute#metadata",
  "fingerprint": "XXXXXCdg=",
  "items": [
    {
      "key": "enable-guest-attributes",
      "value": "TRUE"
    },
    {
      "key": "enable-os-inventory",
      "value": "true"
    },
    {
      "key": "enable-osconfig",
      "value": "TRUE"
    },
    {
      "key": "enable-oslogin",
      "value": "TRUE"
    },
    {
      "key": "sshKeys",
      "value": "XXXXX"
    }
  ]
}, ...

gcloud

Per eseguire query sui metadati di zona personalizzati, utilizza il comando gcloud compute project-zonal-metadata describe.

gcloud compute project-zonal-metadata describe \
    --zone=ZONE \
    --project=PROJECT_ID

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto
• ZONE: la zona per la quale vuoi visualizzare i metadati di zona.

L'output è simile al seguente:

{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
    items: {
      "key-1": "value-1",
      "key-2": "value-2"
    }
  }
}

REST

Per eseguire query sui metadati di zona personalizzati, invia una richiesta GET al metodo instanceSettings().get.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceSettings

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto
• ZONE: la zona per la quale vuoi visualizzare i metadati di zona.

L'output è simile al seguente:

{
  "fingerprint": "VlRIl8dx9vk=",
  "metadata": {
    items: {
      "key-1": "value-1",
      "key-2": "value-2"
    }
  }
}

Console

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

   Vai a Istanze VM

2. Fai clic sul nome della VM per cui vuoi visualizzare i metadati.

   • Chiavi SSH per questa VM. Nella sezione Sicurezza e accesso, visualizza il campo Chiavi SSH.

     • Un valore None indica che non sono presenti chiavi SSH archiviate nei metadati dell'istanza.

     • Qualsiasi altro valore indica che nei metadati dell'istanza sono archiviate chiavi SSH.

   • Chiavi SSH per un progetto. Nella sezione Sicurezza e accesso, visualizza il campo Blocca chiavi SSH a livello di progetto.

     • Un valore di On indica che il valore della chiave di metadati block-project-ssh-keys è TRUE nei metadati dell'istanza.

     • Un valore di Off indica che il valore della chiave di metadati block-project-ssh-keys è FALSE oppure che la chiave non è impostata.

   • Tutti gli altri metadati personalizzati. Visualizza la sezione Metadati personalizzati. Vengono visualizzate tutte le chiavi e i valori dei metadati personalizzati, ad eccezione dei metadati delle chiavi SSH.

gcloud

Utilizza il comando gcloud compute instances describe per eseguire query sui metadati dell'istanza:

gcloud compute instances describe VM_NAME --flatten="metadata[]"

Sostituisci VM_NAME con il nome della VM per cui vuoi trovare i metadati.

L'output è simile al seguente:

---
fingerprint: MTgTJ5m-Cjs=
items:
- key: enable-oslogin
  value: 'true'
kind: compute#metadata

REST

Per eseguire query sui metadati di una VM specifica, invia una richiesta GET al metodo instances.get.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

L'output è simile al seguente:

......
"metadata": {
"kind": "compute#metadata",
"fingerprint": "XXXXXXVo=",
"items": [
  {
    "key": "enable-oslogin",
    "value": "true"
  }
]
},....

Sostituisci quanto segue:

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