Ver e consultar metadados da VM

Linux

1. Conecte-se à VM do Linux.

2. Na VM do Linux, use a ferramenta curl para fazer uma consulta. Para consultar uma entrada de metadados de instância de VM ou projeto, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

   • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
   • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
   • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.

   Por exemplo, para consultar a imagem de inicialização da VM, execute a seguinte consulta:

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

   O resultado será assim:

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

Windows

1. Conecte-se à VM do Windows:

2. Na VM do Windows, use o comando Invoke-RestMethod para fazer uma consulta. Para consultar uma entrada de metadados de instância de VM ou projeto, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

   • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
   • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
   • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.

   Por exemplo, para consultar a imagem de inicialização da VM, execute a seguinte consulta:

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

   O resultado será assim:

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

Linux

1. Conecte-se à VM do Linux.

2. Para consultar uma instância de VM ou um diretório de metadados do projeto, na VM do Linux, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_DIRECTORY pelo caminho para a instância de VM ou o diretório de metadados do projeto para o qual você quer consultar as listagens. Por exemplo:

   • Para conferir a entrada do diretório de metadados do projeto attributes, o caminho a ser especificado é project/attributes/.
   • Para acessar a entrada de diretório de metadados da instância de VM disks, o caminho a ser especificado é instance/disks/.

   Por exemplo, considere a entrada disks/, que é um diretório de discos anexado à VM. Para consultar a entrada de disks/, siga estas etapas:

   1. Execute o comando curl ferramenta no diretório de discos.

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

      O resultado será assim:

      0/
      1/
      2/
      

   2. Se você quiser mais informações sobre o diretório 0/ do disco, consulte o URL específico desse diretório:

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

      O resultado será assim:

      device-name
      index
      mode
      type
      

   3. Em seguida, para consultar o tipo de disco (type) para discos 0/, execute:

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

      O resultado será assim:

      PERSISTENT
      

Windows

A entrada disks/ é um diretório de discos anexado à VM. Para consultar a entrada de discos, siga estas etapas:

1. Conecte-se à VM do Windows:

2. Para consultar uma instância de VM ou um diretório de metadados do projeto, na VM do Windows, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_DIRECTORY pelo caminho para a instância de VM ou o diretório de metadados do projeto para o qual você quer consultar as listagens. Por exemplo:

   • Para conferir a entrada do diretório de metadados do projeto attributes, o caminho a ser especificado é project/attributes/.
   • Para acessar a entrada de diretório de metadados da instância de VM disks, o caminho a ser especificado é instance/disks/.

   Por exemplo, considere a entrada disks/, que é um diretório de discos anexado à VM. Para consultar a entrada de disks/, siga estas etapas:

   1. Execute oInvoke-RestMethod comando no diretório de discos.

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

      O resultado será assim:

      0/
      1/
      2/
      

   2. Se você quiser mais informações sobre o diretório 0/ do disco, consulte o URL específico desse diretório:

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

      O resultado será assim:

      device-name
      index
      mode
      type
      

   3. Em seguida, para consultar o tipo de disco (type) para discos 0/, execute:

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

      O resultado será assim:

      PERSISTENT
      

Linux

1. Conecte-se à VM do Linux.

2. Na VM do Linux, use a ferramenta curl para fazer uma consulta. Para consultar recursivamente as listagens de uma instância de VM ou de um diretório de metadados do projeto, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_DIRECTORY pelo caminho para a instância de VM ou o diretório de metadados do projeto para o qual você quer consultar as listagens. Por exemplo:

   • Para conferir a entrada do diretório de metadados do projeto attributes, o caminho a ser especificado é project/attributes/.
   • Para acessar a entrada de diretório de metadados da instância de VM disks, o caminho a ser especificado é instance/disks/.

   Por exemplo, o comando a seguir consulta de maneira recursiva as listagens de metadados da instância para o diretório disks/.

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

   O resultado será assim:

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

   Por padrão, o conteúdo recursivo é retornado no formato JSON. Se desejar retornar esses conteúdos no formato de texto, anexe o 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"
     

   O resultado será assim:

     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. Conecte-se à VM do Windows:

2. Na VM do Windows, use o comando Invoke-RestMethod para fazer uma consulta. Para consultar recursivamente as listagens de uma instância de VM ou de um diretório de metadados do projeto, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_DIRECTORY pelo caminho para a instância de VM ou o diretório de metadados do projeto para o qual você quer consultar as listagens. Por exemplo:

   • Para conferir a entrada do diretório de metadados do projeto attributes, o caminho a ser especificado é project/attributes/.
   • Para acessar a entrada de diretório de metadados da instância de VM disks, o caminho a ser especificado é instance/disks/.

   Por exemplo, o comando a seguir consulta de maneira recursiva as listagens de metadados da instância para o diretório disks/.

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

   O resultado será assim:

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

   Por padrão, o conteúdo recursivo é retornado no formato JSON. Se desejar retornar esses conteúdos no formato de texto, anexe o 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
   

   O resultado será assim:

   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. Conecte-se à VM do Linux.

2. Na VM do Linux, use a ferramenta curl para fazer uma consulta. Para alterar o formato dos dados da resposta da consulta para uma entrada de metadados do projeto ou de instância de VM, execute o seguinte comando:

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

   Substitua:

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.
   • DATA_FORMAT: o formato em que você quer os dados de resposta da consulta. Por exemplo, text ou json.

Exemplo

Por exemplo, a tecla tags retorna automaticamente os dados no formato JSON. No entanto, é possível retornar dados em formato de texto especificando o parâmetro de consulta alt=text.

Consulta padrão

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

O resultado será assim:

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

Consulta com formatação

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

O resultado será assim:

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

Windows

1. Conecte-se à VM do Windows:

2. Na VM do Windows, use o comando Invoke-RestMethod para fazer uma consulta. Para alterar o formato dos dados da resposta da consulta para uma entrada de metadados do projeto ou de instância de VM, execute o seguinte comando:

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

   Substitua:

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.
   • DATA_FORMAT: o formato em que você quer os dados de resposta da consulta. Por exemplo, text ou json.

Exemplo

Por exemplo, a tecla tags retorna automaticamente os dados no formato JSON. No entanto, é possível retornar dados em formato de texto especificando o parâmetro de consulta alt=text.

Consulta padrão

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

O resultado será assim:

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

Consulta com formatação

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

O resultado será assim:

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

Linux

1. Conecte-se à VM do Linux.

2. Na VM do Linux, use a ferramenta curl para fazer uma consulta. Para executar uma solicitação wait-for-change para uma instância de VM ou a entrada de metadados do projeto, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

   • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
   • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
   • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.

   Depois que a chave de metadados especificada é alterada, a consulta retorna o novo valor.

Exemplos

Neste exemplo, se uma solicitação for feita para setInstanceTags method, a solicitação retornará com os novos valores:

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

O resultado será assim:

  http-server
  db-client
  

Também é possível executar uma solicitação wait-for-change de maneira recursiva no conteúdo de um diretório:

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

Quando houver alterações, o servidor de metadados retorna o novo conteúdo:

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

Windows

1. Conecte-se à VM do Windows:

2. Na VM do Windows, use o comando Invoke-RestMethod para fazer uma consulta. Para executar uma solicitação wait-for-change em uma entrada de metadados de instância de VM ou de projeto, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

   • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
   • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
   • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.

   Depois que a chave de metadados especificada é alterada, a consulta retorna o novo valor.

Exemplos

Depois que a chave de metadados especificada é alterada, a consulta retorna o novo valor. Neste exemplo, se uma solicitação for feita para setInstanceTags method, a solicitação retornará com os novos valores:

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

O resultado será assim:

  http-server
  db-client
  

Também é possível executar uma solicitação wait-for-change de maneira recursiva no conteúdo de um diretório:

  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
  

Quando houver alterações, o servidor de metadados retorna o novo conteúdo:

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

VMs do Linux

Para receber o valor atual da ETag de uma chave de metadados, siga estas etapas:

1. Conecte-se à VM do Linux.

2. Faça uma solicitação para essa chave e imprima os cabeçalhos. Para fazer isso, use a ferramenta curl com a flag -v: Para receber a ETag atual de uma entrada de metadados do projeto ou de uma instância de VM, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

   • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
   • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
   • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.

   Por exemplo, o comando a seguir recebe o valor atual da ETag para a chave de metadados da instância tags.

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

   O resultado será assim:

   * 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. Em seguida, use esse valor de ETag com o comando ferramenta curl na sua solicitação wait-for-change: Para usar o valor da ETag para a solicitação wait-for-change dos metadados de instância ou projeto, execute o seguinte comando:

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

   Substitua:

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.
   • ETAG: o valor da ETag da chave de metadados.

   Neste exemplo, o comando a seguir usa o valor da ETag para a chave tags e consulta a entrada de metadados da instância.

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

   O servidor de metadados corresponde ao valor da ETag especificado e, se esse valor for alterado, a solicitação retornará com o novo conteúdo da chave de metadados.

VM do Windows

Para receber o valor atual da ETag de uma chave de metadados, siga estas etapas:

1. Conecte-se à VM do Windows:

2. Faça uma solicitação para essa chave e imprima os cabeçalhos. No Windows, use o Invoke-WebRequest comando. Para receber a ETag atual de uma entrada de metadados do projeto ou de uma instância de VM, execute o seguinte comando:

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

   Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

   • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
   • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
   • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.

   Por exemplo, o comando a seguir recebe o valor atual da ETag para a chave de metadados da instância tags.

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

   O resultado será assim:

     * 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. Em seguida, use esse valor de ETag na solicitação wait-for-change. Para usar o valor da ETag para a solicitação wait-for-change dos metadados de instância ou projeto, execute o seguinte 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
     

   Substitua:

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.
   • ETAG: o valor da ETag da chave de metadados.

   Neste exemplo, o comando a seguir usa o valor da ETag para a chave tags e consulta a entrada de metadados da instância.

     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
     

   O servidor de metadados corresponde ao valor da ETag especificado e, se esse valor for alterado, a solicitação retornará com o novo conteúdo da chave de metadados.

Python

Na amostra de Python a seguir, veja como monitorar o servidor de metadados programaticamente para verificar se houve alterações.

Nesta amostra, a ETag inicial foi definida como 0. O servidor de metadados não retornará uma resposta com 0 como o valor da ETag. Quando 0 for especificado como a última ETag em uma solicitação, o servidor de metadados responderá com o valor atual e a ETag. Isso poupa um pouco do código necessário para conseguir o valor e a ETag iniciais.

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. Conecte-se à VM do Linux.

2. Na VM do Linux, use a ferramenta curl para fazer uma consulta. Para executar uma solicitação wait-for-change com um valor de tempo limite para uma entrada de metadados da instância de VM ou de projeto, execute o seguinte comando:

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

   Substitua:

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.
   • TIMEOUT: o valor de tempo limite.

Por exemplo, o comando a seguir executa uma solicitação wait-for-change configurada para expirar após 360 segundos:

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

Windows

1. Conecte-se à VM do Windows:

2. Na VM do Windows, use o comando Invoke-RestMethod para fazer uma consulta. Para executar uma solicitação wait-for-change com um valor de tempo limite para uma entrada de metadados da instância de VM ou de projeto, execute o seguinte 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
     

   Substitua:

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.
   • TIMEOUT: o valor de tempo limite.

Por exemplo, o comando a seguir executa uma solicitação wait-for-change configurada para expirar após 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. Conecte-se à VM do Linux.

2. Na VM do Linux, use o ferramenta curl para fazer uma consulta e especificar o certificado de identidade do cliente. Como opção, também é possível especificar o certificado raiz.

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

   Substitua:

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.
   • CLIENT_CERTIFICATE: o caminho para o certificado de identidade do cliente: /run/google-mds-mtls/client.key.
   • Opcional: ROOT_CERTIFICATE: o caminho para o certificado raiz: /run/google-mds-mtls/root.crt.

   Por exemplo, para consultar a imagem de inicialização da VM, execute a seguinte consulta:

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

   O resultado será assim:

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

   Se uma mensagem de erro for exibida, consulte documentação de solução de problemas.

Windows

1. Conecte-se à VM do Windows:

2. Receba o certificado de identidade do cliente usando um dos seguintes 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. Na VM do Windows, use o comando Invoke-RestMethod e especifique o certificado de identidade do cliente para fazer uma 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
   

   Substitua:

   • CLIENT_CERTIFICATE: o caminho para o certificado de identidade do cliente na VM. Essa é a variável $cert definida na etapa anterior.

   • Substitua PATH_TO_METADATA_ENTRY pelo caminho a instância de VM ou a chave de metadados do projeto em que você quer consultar o valor. Se a chave estiver em um subdiretório da instância ou do projeto, verifique se para incluir também o subdiretório. Por exemplo:

     • Para visualizar a chave de metadados project-id, que é armazenada em metadados do projeto, especifique project/project-id.
     • Para acessar a chave de metadados image, que está armazenada nos metadados de instância de VM, especifique instance/image.
     • Para conferir o enable-oslogin, que pode ser armazenado no arquivo atribui um subdiretório dos metadados do projeto ou da instância de VM, especifique project/attributes/enable-oslogin ou instance/attributes/enable-oslogin, dependendo do caso de uso.

   Por exemplo, para consultar a imagem de inicialização de uma VM do Windows Server 2019, execute: a seguinte consulta:

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

   O resultado será assim:

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

Console

1. No Console do Google Cloud, acesse a página Metadados.

   Acessar a página "Metadados"

   Na página Metadados, você verá uma lista de todos os metadados personalizados das entradas de metadados para seu projeto.

gcloud

Use o comando gcloud compute project-info describe para consultar os metadados do projeto:

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

O resultado será assim:

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

REST

Para consultar os metadados do projeto, crie uma solicitação GET para o método project.get.

Substitua PROJECT_ID pelo ID do projeto.

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

O resultado será assim:

"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

Para consultar os metadados personalizados zonais, use o comando gcloud compute project-zonal-metadata describe.

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

Substitua:

• PROJECT_ID: ID do projeto
• ZONE: a zona em que você quer visualizar os metadados zonais.

O resultado será assim:

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

REST

Para consultar os metadados personalizados zonais, faça uma solicitação GET para o método instanceSettings().get

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

Substitua:

• PROJECT_ID: ID do projeto
• ZONE: a zona em que você quer visualizar os metadados zonais.

O resultado será assim:

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

Console

1. No console do Google Cloud, acesse a página Instâncias de VMs.

   Acessar instâncias de VM

2. Clique no nome da VM com os metadados que você quer ver.

   • Chaves SSH para esta VM. Na seção Segurança e acesso, veja o campo Chaves SSH.

     • Um valor None indica que não há chaves SSH armazenadas nos metadados da instância.

     • Qualquer outro valor indica que há chaves SSH armazenadas nos metadados da instância.

   • Chaves SSH de um projeto. Na seção Segurança e acesso, veja o campo Bloquear chaves SSH do projeto inteiro.

     • Um valor de On indica que o valor da chave de metadados block-project-ssh-keys é TRUE nos metadados da instância.

     • Um valor de Off indica que o valor da chave de metadados block-project-ssh-keys é FALSE ou que a chave não está definida.

   • Todos os outros metadados personalizados. Veja a seção Metadados personalizados. Você verá todos os valores e chaves de metadados personalizados, exceto metadados de chave SSH.

gcloud

Use o comando gcloud compute instances describe para consultar os metadados da instância:

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

Substitua VM_NAME pelo nome da VM que você quer encontrar os metadados.

O resultado será assim:

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

REST

Para consultar metadados de uma VM específica, envie uma solicitação GET para o método instances.get.

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

O resultado será assim:

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

Substitua:

• PROJECT_ID: ID do projeto
• ZONE: é a zona em que a VM está localizada
• VM_NAME: o nome da VM