Ver y consultar metadatos de VM

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

linux

1. Conéctese a su máquina virtual Linux.

2. Desde su máquina virtual Linux, utilice la herramienta curl para realizar una consulta. Para consultar una instancia de VM o una entrada de metadatos del proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

   • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
   • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
   • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.

   Por ejemplo, para consultar la imagen de inicio de la VM, ejecute la siguiente consulta:

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

   El resultado es similar al siguiente:

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

ventanas

1. Conéctese a su máquina virtual Windows.

2. Desde su máquina virtual Windows, use el comando Invoke-RestMethod para realizar una consulta. Para consultar una instancia de VM o una entrada de metadatos del proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

   • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
   • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
   • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.

   Por ejemplo, para consultar la imagen de inicio de la VM, ejecute la siguiente consulta:

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

   El resultado es similar al siguiente:

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

linux

1. Conéctese a su máquina virtual Linux.

2. Para consultar una instancia de VM o un directorio de metadatos de proyecto, desde su VM Linux, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_DIRECTORY con la ruta a la instancia de VM o al directorio de metadatos del proyecto cuyos listados desea consultar de forma recursiva. Por ejemplo:

   • Para ver la entrada del directorio de metadatos del proyecto attributes , la ruta a especificar es project/attributes/ .
   • Para ver la entrada del directorio de metadatos de la instancia de VM disks , la ruta a especificar es instance/disks/ .

   Por ejemplo, considere la entrada disks/ , que es un directorio de discos adjunto a la VM. Para consultar los disks/ entrada, complete los siguientes pasos:

   1. Ejecute el comando de la herramienta curl en el directorio de discos.

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

      El resultado es similar al siguiente:

      0/
      1/
      2/
      

   2. Si desea obtener más información sobre el directorio del disco 0/ , puede consultar la URL específica para ese directorio:

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

      El resultado es similar al siguiente:

      device-name
      index
      mode
      type
      

   3. Luego, para consultar el tipo de disco ( type ) para los discos 0/ , puede ejecutar lo siguiente:

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

      El resultado es similar al siguiente:

      PERSISTENT
      

ventanas

La entrada disks/ es un directorio de discos que está conectado a la VM. Para consultar la entrada de discos, complete los siguientes pasos:

1. Conéctese a su máquina virtual Windows.

2. Para consultar una instancia de VM o un directorio de metadatos de proyecto, desde su VM de Windows, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_DIRECTORY con la ruta a la instancia de VM o al directorio de metadatos del proyecto cuyos listados desea consultar de forma recursiva. Por ejemplo:

   • Para ver la entrada del directorio de metadatos del proyecto attributes , la ruta a especificar es project/attributes/ .
   • Para ver la entrada del directorio de metadatos de la instancia de VM disks , la ruta a especificar es instance/disks/ .

   Por ejemplo, considere la entrada disks/ , que es un directorio de discos adjunto a la VM. Para consultar los disks/ entrada, complete los siguientes pasos:

   1. Utilice el comando Invoke-RestMethod en el directorio de discos.

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

      El resultado es similar al siguiente:

      0/
      1/
      2/
      

   2. Si desea obtener más información sobre el directorio del disco 0/ , puede consultar la URL específica para ese directorio:

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

      El resultado es similar al siguiente:

      device-name
      index
      mode
      type
      

   3. Luego, para consultar el tipo de disco ( type ) para los discos 0/ , puede ejecutar lo siguiente:

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

      El resultado es similar al siguiente:

      PERSISTENT
      

linux

1. Conéctese a su máquina virtual Linux.

2. Desde su máquina virtual Linux, utilice la herramienta curl para realizar una consulta. Para consultar recursivamente los listados de una instancia de VM o un directorio de metadatos del proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_DIRECTORY con la ruta a la instancia de VM o al directorio de metadatos del proyecto cuyos listados desea consultar de forma recursiva. Por ejemplo:

   • Para ver la entrada del directorio de metadatos del proyecto attributes , la ruta a especificar es project/attributes/ .
   • Para ver la entrada del directorio de metadatos de la instancia de VM disks , la ruta a especificar es instance/disks/ .

   Por ejemplo, el siguiente comando consulta de forma recursiva los listados de metadatos de la instancia para el directorio disks/ .

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

   El resultado es similar al siguiente:

     [{"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"}]
     

   De forma predeterminada, los contenidos recursivos se devuelven en formato JSON. Si desea devolver estos contenidos en formato de texto, agregue el parámetro de consulta alt=text :

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

   El resultado es similar al siguiente:

     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
     

ventanas

1. Conéctese a su máquina virtual Windows.

2. Desde su máquina virtual Windows, use el comando Invoke-RestMethod para realizar una consulta. Para consultar recursivamente los listados de una instancia de VM o un directorio de metadatos del proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_DIRECTORY con la ruta a la instancia de VM o al directorio de metadatos del proyecto cuyos listados desea consultar de forma recursiva. Por ejemplo:

   • Para ver la entrada del directorio de metadatos del proyecto attributes , la ruta a especificar es project/attributes/ .
   • Para ver la entrada del directorio de metadatos de la instancia de VM disks , la ruta a especificar es instance/disks/ .

   Por ejemplo, el siguiente comando consulta de forma recursiva los listados de metadatos de la instancia para el directorio disks/ .

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

   El resultado es similar al siguiente:

   [{"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"}]
   

   De forma predeterminada, los contenidos recursivos se devuelven en formato JSON. Si desea devolver estos contenidos en formato de texto, agregue el parámetro de consulta 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
   

   El resultado es similar al siguiente:

   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. Conéctese a su máquina virtual Linux.

2. Desde su máquina virtual Linux, utilice la herramienta curl para realizar una consulta. Para cambiar el formato de datos de respuesta de consulta para una instancia de VM o una entrada de metadatos de proyecto, ejecute el siguiente comando:

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

   Reemplace lo siguiente:

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.
   • DATA_FORMAT : el formato en el que desea los datos de respuesta de la consulta (por ejemplo, text o json ).

Ejemplo

Por ejemplo, la clave tags devuelve automáticamente datos en formato JSON. En su lugar, puede devolver datos en formato de texto, especificando el parámetro de consulta alt=text .

Consulta predeterminada

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

El resultado es similar al siguiente:

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

Consulta con formato

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

El resultado es similar al siguiente:

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

ventanas

1. Conéctese a su máquina virtual Windows.

2. Desde su máquina virtual Windows, use el comando Invoke-RestMethod para realizar una consulta. Para cambiar el formato de datos de respuesta de consulta para una instancia de VM o una entrada de metadatos de proyecto, ejecute el siguiente comando:

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

   Reemplace lo siguiente:

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.
   • DATA_FORMAT : el formato en el que desea los datos de respuesta de la consulta (por ejemplo, text o json ).

Ejemplo

Por ejemplo, la clave tags devuelve automáticamente datos en formato JSON. En su lugar, puede devolver datos en formato de texto, especificando el parámetro de consulta alt=text .

Consulta predeterminada

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

El resultado es similar al siguiente:

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

Consulta con formato

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

El resultado es similar al siguiente:

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

linux

1. Conéctese a su máquina virtual Linux.

2. Desde su máquina virtual Linux, utilice la herramienta curl para realizar una consulta. Para realizar una solicitud de wait-for-change para una instancia de VM o una entrada de metadatos de proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

   • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
   • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
   • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.

   Después de que hay un cambio en la clave de metadatos especificada, la consulta regresa con el nuevo valor.

Ejemplos

En este ejemplo, si se realiza una solicitud al setInstanceTags method , la solicitud regresa con los nuevos valores:

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

El resultado es similar al siguiente:

  http-server
  db-client
  

También puede realizar una solicitud de wait-for-change de forma recursiva en el contenido de un directorio:

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

El servidor de metadatos devuelve los nuevos contenidos si hay algún cambio:

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

ventanas

1. Conéctese a su máquina virtual Windows.

2. Desde su máquina virtual Windows, use el comando Invoke-RestMethod para realizar una consulta. Para realizar una solicitud de wait-for-change para una instancia de VM o una entrada de metadatos de proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

   • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
   • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
   • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.

   Después de que hay un cambio en la clave de metadatos especificada, la consulta regresa con el nuevo valor.

Ejemplos

Después de que hay un cambio en la clave de metadatos especificada, la consulta regresa con el nuevo valor. En este ejemplo, si se realiza una solicitud al setInstanceTags method , la solicitud regresa con los nuevos valores:

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

El resultado es similar al siguiente:

  http-server
  db-client
  

También puede realizar una solicitud de wait-for-change de forma recursiva en el contenido de un directorio:

  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
  

El servidor de metadatos devuelve los nuevos contenidos si hay algún cambio:

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

Máquinas virtuales Linux

Para obtener el valor de ETag actual para una clave de metadatos, complete los siguientes pasos:

1. Conéctese a su máquina virtual Linux.

2. Realice una solicitud a esa clave e imprima los encabezados. Para hacer esto, use la herramienta curl con el indicador -v . Para obtener la ETag actual para una instancia de VM o una entrada de metadatos del proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

   • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
   • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
   • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.

   Por ejemplo, el siguiente comando obtiene el valor ETag actual para la clave de metadatos de la instancia tags .

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

   El resultado es similar al siguiente:

   * 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. Luego puede usar ese valor de ETag con el comando de la herramienta curl en su solicitud wait-for-change . Para utilizar el valor de ETag para la solicitud wait-for-change de metadatos de instancia o proyecto, ejecute el siguiente comando:

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

   Reemplace lo siguiente:

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.
   • ETAG : el valor de ETag para la clave de metadatos.

   En este ejemplo, el siguiente comando utiliza el valor ETag para la clave tags y consulta la entrada de metadatos de la instancia.

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

   El servidor de metadatos coincide con el valor de ETag especificado y, si ese valor cambia, la solicitud regresa con el nuevo contenido de su clave de metadatos.

Máquinas virtuales de Windows

Para obtener el valor de ETag actual para una clave de metadatos, complete los siguientes pasos:

1. Conéctese a su máquina virtual Windows.

2. Realice una solicitud a esa clave e imprima los encabezados. En Windows, utilice el comando Invoke-WebRequest . Para obtener la ETag actual para una instancia de VM o una entrada de metadatos del proyecto, ejecute el siguiente comando:

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

   Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

   • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
   • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
   • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.

   Por ejemplo, el siguiente comando obtiene el valor ETag actual para la clave de metadatos de la instancia tags .

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

   El resultado es similar al siguiente:

     * 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. Luego puede usar ese valor de ETag en su solicitud wait-for-change . Para utilizar el valor de ETag para la solicitud wait-for-change de metadatos de instancia o proyecto, ejecute el siguiente 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
     

   Reemplace lo siguiente:

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.
   • ETAG : el valor de ETag para la clave de metadatos.

   En este ejemplo, el siguiente comando utiliza el valor ETag para la clave tags y consulta la entrada de metadatos de la instancia.

     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
     

   El servidor de metadatos coincide con el valor de ETag especificado y, si ese valor cambia, la solicitud regresa con el nuevo contenido de su clave de metadatos.

Pitón

El siguiente ejemplo de Python muestra cómo observar mediante programación el servidor de metadatos en busca de cambios.

Este ejemplo establece la ETag inicial en 0 . El servidor de metadatos no devuelve una respuesta con 0 como valor de ETag. Cuando se especifica 0 como la última ETag en una solicitud, el servidor de metadatos responde con el valor actual y la ETag. Esto ahorra un poco del código necesario para obtener el valor inicial y 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. Conéctese a su máquina virtual Linux.

2. Desde su máquina virtual Linux, utilice la herramienta curl para realizar una consulta. Para realizar una solicitud de wait-for-change con un valor de tiempo de espera para una instancia de VM o una entrada de metadatos del proyecto, ejecute el siguiente comando:

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

   Reemplace lo siguiente:

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.
   • TIMEOUT : el valor del tiempo de espera.

Por ejemplo, el siguiente comando realiza una solicitud de wait-for-change cuyo tiempo de espera se establece en 360 segundos:

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

ventanas

1. Conéctese a su máquina virtual Windows.

2. Desde su máquina virtual Windows, use el comando Invoke-RestMethod para realizar una consulta. Para realizar una solicitud de wait-for-change con un valor de tiempo de espera para una instancia de VM o una entrada de metadatos del proyecto, ejecute el siguiente 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
     

   Reemplace lo siguiente:

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.
   • TIMEOUT : el valor del tiempo de espera.

Por ejemplo, el siguiente comando realiza una solicitud de wait-for-change cuyo tiempo de espera se establece en 360 segundos:

  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. Conéctese a su máquina virtual Linux.

2. Desde su máquina virtual Linux, utilice la herramienta curl para realizar una consulta y especificar el certificado de identidad del cliente. Opcionalmente, también puede especificar el certificado raíz.

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

   Reemplace lo siguiente:

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.
   • CLIENT_CERTIFICATE : la ruta al certificado de identidad del cliente: /run/google-mds-mtls/client.key .
   • Opcional: ROOT_CERTIFICATE : la ruta al certificado raíz: /run/google-mds-mtls/root.crt .

   Por ejemplo, para consultar la imagen de inicio de una VM, ejecute la siguiente consulta:

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

   El resultado es similar al siguiente:

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

   Si ve un mensaje de error, revise la documentación de solución de problemas .

ventanas

1. Conéctese a su máquina virtual Windows.

2. Obtenga el certificado de identidad del cliente mediante uno de los siguientes comandos:

   • $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. Desde su máquina virtual Windows, use el comando Invoke-RestMethod y especifique el certificado de identidad del cliente para realizar una consulta.

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

   Reemplace lo siguiente:

   • CLIENT_CERTIFICATE : la ruta al certificado de identidad del cliente en la VM. Esta es la variable $cert que se configuró en el paso anterior.

   • Reemplace PATH_TO_METADATA_ENTRY con la ruta a la instancia de VM o clave de metadatos del proyecto cuyo valor desea consultar. Si la clave está en un subdirectorio del directorio de instancia o proyecto, asegúrese de incluir también el subdirectorio. Por ejemplo:

     • Para ver la clave de metadatos project-id , que se almacena en los metadatos del proyecto, especifique project/project-id .
     • Para ver la clave de metadatos image , que se almacena en los metadatos de la instancia de VM, especifique instance/image .
     • Para ver enable-oslogin que se puede almacenar en el subdirectorio de atributos de los metadatos del proyecto o de la instancia de VM, especifique project/attributes/enable-oslogin o instance/attributes/enable-oslogin según su caso de uso.

   Por ejemplo, para consultar la imagen de inicio de una máquina virtual de Windows Server 2019, ejecute la siguiente consulta:

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

   El resultado es similar al siguiente:

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

Consola

1. En la consola de Google Cloud, vaya a la página Metadatos .

   Ir a la página de Metadatos

   En la página de metadatos , ve una lista de todas las entradas de metadatos de proyecto personalizados para su proyecto.

nube de gcloud

Use el gcloud compute project-info describe el comando para consultar metadatos del proyecto:

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

El resultado es similar al siguiente:

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

DESCANSAR

Para consultar los metadatos del proyecto, cree una solicitud GET al método project.get .

Reemplace PROJECT_ID con su ID de proyecto.

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

El resultado es similar al siguiente:

"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"
    }
  ]
}, ...

nube de gcloud

Para consultar los metadatos zonales personalizados, use el Comando gcloud compute project-zonal-metadata describe .

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

Reemplace lo siguiente:

• PROJECT_ID : ID de tu proyecto
• ZONE : la zona para la que desea ver los metadatos zonales.

El resultado es similar al siguiente:

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

DESCANSAR

Para consultar los metadatos zonales personalizados, realice una solicitud GET a los instanceSettings().get método

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

Reemplace lo siguiente:

• PROJECT_ID : ID de tu proyecto
• ZONE : la zona para la que desea ver los metadatos zonales.

El resultado es similar al siguiente:

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

Consola

1. En la consola de Google Cloud, vaya a la página de instancias de VM .

   Ir a instancias de VM

2. Haga clic en el nombre de la VM para el que desea ver metadatos.

   • Claves SSH para esta VM . En la sección de seguridad y acceso , vea el campo de teclas SSH .

     • Un valor de None indica que no hay claves SSH almacenadas en metadatos de instancia.

     • Cualquier otro valor indica que hay claves SSH almacenadas en metadatos de instancia.

   • Cayos SSH para un proyecto . En la sección de seguridad y acceso , vea el campo Bloque de teclas SSH de todo el proyecto .

     • Un valor de On indica que el valor de los metadatos clave block-project-ssh-keys es TRUE en los metadatos de caso.

     • Un valor de Off indica que el valor de la block-project-ssh-keys es FALSE o que la clave no está establecida.

   • Todos los demás metadatos personalizados . Ver la sección Metadatos personalizados . Ves todas las teclas y valores de metadatos personalizados, aparte de los metadatos de clave SSH.

nube de gcloud

Use las gcloud compute instances describe el comando para consultar metadatos de instancia:

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

Reemplace VM_NAME con el nombre de la VM para la que desea encontrar metadatos.

El resultado es similar al siguiente:

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

DESCANSAR

Para consultar metadatos para una VM específica, envíe una solicitud GET al método instances.get .

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

El resultado es similar al siguiente:

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

Reemplace lo siguiente:

• PROJECT_ID : ID de tu proyecto
• ZONE : la zona donde se encuentra la VM
• VM_NAME : el nombre de la VM