VM メタデータの表示とクエリ

Linux

1. Linux VM に接続します。

2. Linux VM から、curl ツールを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリをクエリするには、次のコマンドを実行します。

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

   PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

   • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
   • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
   • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。

   たとえば、VM のブートイメージにクエリを実行するには、次のクエリを実行します。

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

   出力は次のようになります。

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

Windows

1. Windows VM に接続します。

2. Windows VM から、Invoke-RestMethod コマンドを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリをクエリするには、次のコマンドを実行します。

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

   PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

   • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
   • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
   • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。

   たとえば、VM のブートイメージにクエリを実行するには、次のクエリを実行します。

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

   出力は次のようになります。

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

Linux

1. Linux VM に接続します。

2. Linux VM から VM インスタンスまたはプロジェクトのメタデータ ディレクトリをクエリするには、次のコマンドを実行します。

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

   PATH_TO_METADATA_DIRECTORY は、リスティングを再帰的にクエリする VM インスタンスまたはプロジェクトのメタデータ ディレクトリのパスに置き換えます。次に例を示します。

   • attributes プロジェクト メタデータ ディレクトリ エントリを表示するには、project/attributes/ のパスを指定します。
   • disks VM インスタンスのメタデータ ディレクトリ エントリを表示するには、instance/disks/ のパスを指定します。

   たとえば、VM にアタッチされているディスクのディレクトリである disks/ エントリについて考えてみましょう。disks/ エントリをクエリするには、次の手順を完了します。

   1. ディスク ディレクトリで curl ツールコマンドを実行します。

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

      出力は次のようになります。

      0/
      1/
      2/
      

   2. ディスクの 0/ ディレクトリに関する詳細情報が必要な場合は、そのディレクトリの特定の URL をクエリで取得できます。

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

      出力は次のようになります。

      device-name
      index
      mode
      type
      

   3. 次に、ディスク 0/ のディスクタイプ（type）をクエリするために、次のコマンドを実行します。

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

      出力は次のようになります。

      PERSISTENT
      

Windows

disks/ というエントリは、その VM にアタッチされているディスクのディレクトリです。ディスク エントリをクエリするには、次の手順を完了します。

1. Windows VM に接続します。

2. Windows VM から VM インスタンスまたはプロジェクトのメタデータ ディレクトリをクエリするには、次のコマンドを実行します。

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

   PATH_TO_METADATA_DIRECTORY は、リスティングを再帰的にクエリする VM インスタンスまたはプロジェクトのメタデータ ディレクトリのパスに置き換えます。次に例を示します。

   • attributes プロジェクト メタデータ ディレクトリ エントリを表示するには、project/attributes/ のパスを指定します。
   • disks VM インスタンスのメタデータ ディレクトリ エントリを表示するには、instance/disks/ のパスを指定します。

   たとえば、VM にアタッチされているディスクのディレクトリである disks/ エントリについて考えてみましょう。disks/ エントリをクエリするには、次の手順を完了します。

   1. ディスク ディレクトリで Invoke-RestMethod コマンドを実行します。

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

      出力は次のようになります。

      0/
      1/
      2/
      

   2. ディスク 0/ ディレクトリに関する詳細情報が必要な場合は、そのディレクトリの特定の URL をクエリで取得できます。

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

      出力は次のようになります。

      device-name
      index
      mode
      type
      

   3. 次に、ディスク 0/ のディスクタイプ（type）をクエリするために、次のコマンドを実行します。

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

      出力は次のようになります。

      PERSISTENT
      

Linux

1. Linux VM に接続します。

2. Linux VM から、curl ツールを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ ディレクトリのリスティングを再帰的にクエリするには、次のコマンドを実行します。

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

   PATH_TO_METADATA_DIRECTORY は、リスティングを再帰的にクエリする VM インスタンスまたはプロジェクトのメタデータ ディレクトリのパスに置き換えます。次に例を示します。

   • attributes プロジェクト メタデータ ディレクトリ エントリを表示するには、project/attributes/ のパスを指定します。
   • disks VM インスタンスのメタデータ ディレクトリ エントリを表示するには、instance/disks/ のパスを指定します。

   たとえば、次のコマンドを実行すると、disks/ ディレクトリのインスタンス メタデータ リスティングを再帰的にクエリします。

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

   出力は次のようになります。

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

   デフォルトでは、再帰クエリの結果は JSON 形式で返されます。これらの内容をテキスト形式で返されるようにするには、alt=text クエリ パラメータを追加します。

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

   出力は次のようになります。

     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. Windows VM に接続します。

2. Windows VM から、Invoke-RestMethod コマンドを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ ディレクトリのリスティングを再帰的にクエリするには、次のコマンドを実行します。

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

   PATH_TO_METADATA_DIRECTORY は、リスティングを再帰的にクエリする VM インスタンスまたはプロジェクトのメタデータ ディレクトリのパスに置き換えます。次に例を示します。

   • attributes プロジェクト メタデータ ディレクトリ エントリを表示するには、project/attributes/ のパスを指定します。
   • disks VM インスタンスのメタデータ ディレクトリ エントリを表示するには、instance/disks/ のパスを指定します。

   たとえば、次のコマンドを実行すると、disks/ ディレクトリのインスタンス メタデータ リスティングを再帰的にクエリします。

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

   出力は次のようになります。

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

   デフォルトでは、再帰クエリの結果は JSON 形式で返されます。これらの内容をテキスト形式で返されるようにするには、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
   

   出力は次のようになります。

   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. Linux VM に接続します。

2. Linux VM から、curl ツールを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリのクエリ レスポンス データ形式を変更するには、次のコマンドを実行します。

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

   次のように置き換えます。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。
   • DATA_FORMAT: クエリ レスポンス データ形式（例: text、json）。

例

たとえば、tags キーではデータが自動的に JSON 形式で返されますが、これをテキスト形式で返されるように変更するには、alt=text クエリ パラメータを指定します。

デフォルトのキーワード

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

出力は次のようになります。

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

書式設定を使用したクエリ

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

出力は次のようになります。

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

Windows

1. Windows VM に接続します。

2. Windows VM から、Invoke-RestMethod コマンドを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリのクエリ レスポンス データ形式を変更するには、次のコマンドを実行します。

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

   次のように置き換えます。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。
   • DATA_FORMAT: クエリ レスポンス データ形式（例: text、json）。

例

たとえば、tags キーではデータが自動的に JSON 形式で返されますが、これをテキスト形式で返されるように変更するには、alt=text クエリ パラメータを指定します。

デフォルトのキーワード

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

出力は次のようになります。

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

書式設定を使用したクエリ

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

出力は次のようになります。

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

Linux

1. Linux VM に接続します。

2. Linux VM から、curl ツールを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリに wait-for-change リクエストを実行するには、次のコマンドを実行します。

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

   PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

   • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
   • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
   • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。

   指定したメタデータキーが変更されると、クエリで新しい値が返されるようになります。

例

この例では、setInstanceTags method にリクエストが送信されると新しい値が返されるようになります。

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

出力は次のようになります。

  http-server
  db-client
  

wait-for-change リクエストは、ディレクトリの内容に対して再帰的に実行することもできます。

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

変更があった場合は、新しい内容が返されます。

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

Windows

1. Windows VM に接続します。

2. Windows VM から、Invoke-RestMethod コマンドを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリに wait-for-change リクエストを実行するには、次のコマンドを実行します。

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

   PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

   • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
   • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
   • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。

   指定したメタデータキーが変更されると、クエリで新しい値が返されるようになります。

例

指定したメタデータキーが変更されると、クエリで新しい値が返されるようになります。 この例では、setInstanceTags method にリクエストが送信されると新しい値が返されるようになります。

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

出力は次のようになります。

  http-server
  db-client
  

wait-for-change リクエストは、ディレクトリの内容に対して再帰的に実行することもできます。

  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
  

変更があった場合は、新しい内容が返されます。

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

Linux VM

メタデータキーの最新の ETag 値を取得するには、次の操作を行います。

1. Linux VM に接続します。

2. そのキーに対するリクエストを送信してヘッダーを出力します。これを行うには、-v フラグを指定して curl ツールを使用します。VM インスタンスまたはプロジェクトのメタデータ エントリの現在の ETag を取得するには、次のコマンドを実行します。

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

   PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

   • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
   • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
   • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。

   たとえば、次のコマンドを実行すると、tags インスタンスのメタデータキーの現在の ETag 値を取得します。

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

   出力は次のようになります。

   * 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. その ETag 値を使用するには、wait-for-change リクエストの curl ツールコマンドを使用します。インスタンスまたはプロジェクトのメタデータの wait-for-change リクエストに ETag 値を使用するには、次のコマンドを実行します。

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

   次のように置き換えます。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。
   • ETAG: メタデータキーの ETag 値。

   この例では、次のコマンドで tags キーに ETag 値を使用し、インスタンスのメタデータ エントリをクエリします。

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

   指定した ETag 値がメタデータ サーバーで照合され、値が変更されていた場合は、メタデータキーの新しい内容が返されます。

Windows VM

メタデータキーの最新の ETag 値を取得するには、次の操作を行います。

1. Windows VM に接続します。

2. そのキーに対するリクエストを送信してヘッダーを出力します。Windows では、Invoke-WebRequest コマンドを使用します。VM インスタンスまたはプロジェクトのメタデータ エントリの現在の ETag を取得するには、次のコマンドを実行します。

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

   PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

   • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
   • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
   • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。

   たとえば、次のコマンドを実行すると、tags インスタンスのメタデータキーの現在の ETag 値を取得します。

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

   出力は次のようになります。

     * 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. これで、この ETag 値を wait-for-change リクエストで使用できます。インスタンスまたはプロジェクトのメタデータの wait-for-change リクエストに ETag 値を使用するには、次のコマンドを実行します。

     $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
     

   次のように置き換えます。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。
   • ETAG: メタデータキーの ETag 値。

   この例では、次のコマンドで tags キーに ETag 値を使用し、インスタンスのメタデータ エントリをクエリします。

     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
     

   指定した ETag 値がメタデータ サーバーで照合され、値が変更されていた場合は、メタデータキーの新しい内容が返されます。

Python

次の Python サンプルは、メタデータ サーバーの変更をプログラムで監視する方法を示しています。

このサンプルでは、最初の ETag が 0 に設定されています。メタデータ サーバーは、ETag 値が 0 のレスポンスを返しません。リクエストで前回の ETag として 0 を指定すると、メタデータ サーバーから最新の値と ETag が返されます。これにより、最初の値と 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. Linux VM に接続します。

2. Linux VM から、curl ツールを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリにタイムアウト値を指定して wait-for-change リクエストを実行するには、次のコマンドを実行します。

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

   次のように置き換えます。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。
   • TIMEOUT: タイムアウト値。

たとえば、次のコマンドは、360 秒後にタイムアウトするように設定された wait-for-change リクエストを実行します。

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

Windows

1. Windows VM に接続します。

2. Windows VM から、Invoke-RestMethod コマンドを使用してクエリを実行します。VM インスタンスまたはプロジェクトのメタデータ エントリにタイムアウト値を指定して wait-for-change リクエストを実行するには、次のコマンドを実行します。

     $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
     

   次のように置き換えます。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。
   • TIMEOUT: タイムアウト値。

たとえば、次のコマンドは、360 秒後にタイムアウトするように設定された wait-for-change リクエストを実行します。

  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. Linux VM に接続します。

2. Linux VM から、curl ツールを使用してクエリを実行し、クライアント ID 証明書を指定します。必要に応じて、ルート証明書を指定します。

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

   次のように置き換えます。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。
   • CLIENT_CERTIFICATE: クライアント ID 証明書のパス: /run/google-mds-mtls/client.key
   • 省略可: ROOT_CERTIFICATE: ルート証明書 /run/google-mds-mtls/root.crt へのパス。

   たとえば、VM のブートイメージにクエリを実行するには、次のクエリを実行します。

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

   出力は次のようになります。

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

   エラー メッセージが表示された場合は、トラブルシューティングのドキュメントをご覧ください。

Windows

1. Windows VM に接続します。

2. 次のいずれかのコマンドを使用して、クライアント ID 証明書を取得します。

   • $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. Windows VM から Invoke-RestMethod コマンドを使用し、クライアント ID 証明書を指定してクエリを実行します。

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

   次のように置き換えます。

   • CLIENT_CERTIFICATE: VM 上のクライアント ID 証明書のパス。これは、前のステップで設定した $cert 変数です。

   • PATH_TO_METADATA_ENTRY は、値をクエリする VM インスタンスまたはプロジェクトのメタデータキーのパスに置き換えます。キーがインスタンスまたはプロジェクト ディレクトリのサブディレクトリにある場合は、サブディレクトリも含めてください。次に例を示します。

     • プロジェクト メタデータに保存されている project-id メタデータキーを表示するには、project/project-id を指定します。
     • VM インスタンス メタデータに保存されている image メタデータキーを表示するには、instance/image を指定します。
     • プロジェクトまたは VM インスタンス メタデータの attributes サブディレクトリに保存できる enable-oslogin を表示するには、ユースケースに応じて project/attributes/enable-oslogin または instance/attributes/enable-oslogin を指定します。

   たとえば、Windows Server 2019 VM のブートイメージにクエリを実行するには、次のクエリを実行します。

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

   出力は次のようになります。

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

コンソール

1. Google Cloud コンソールで、[メタデータ] ページに移動します。

   [メタデータ] ページに移動

   [メタデータ] ページに、プロジェクトのすべてのカスタム プロジェクト メタデータ エントリのリストが表示されます。

gcloud

プロジェクトのメタデータをクエリするには、gcloud compute project-info describe コマンドを使用します。

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

出力は次のようになります。

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

REST

プロジェクトのメタデータをクエリするには、project.get メソッドに GET リクエストを送信します。

PROJECT_ID は、実際のプロジェクト ID に置き換えます。

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

出力は次のようになります。

"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

カスタム ゾーン メタデータをクエリするには、gcloud compute project-zonal-metadata describe コマンドを使用します。

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

次のように置き換えます。

• PROJECT_ID: プロジェクト ID
• ZONE: ゾーン メタデータを表示するゾーン。

出力は次のようになります。

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

REST

カスタム ゾーン メタデータをクエリするには、instanceSettings().get メソッドに GET リクエストを送信します。

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

次のように置き換えます。

• PROJECT_ID: プロジェクト ID
• ZONE: ゾーン メタデータを表示するゾーン。

出力は次のようになります。

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

コンソール

1. Google Cloud コンソールで [VM インスタンス] ページに移動します。

   [VM インスタンス] に移動

2. メタデータを表示する VM の名前をクリックします。

   • この VM の SSH 認証鍵。[セキュリティとアクセス] セクションで、[SSH 認証鍵] フィールドを表示します。

     • 値 None は、インスタンスのメタデータに保存された SSH 認証鍵がないことを示します。

     • その他の値は、SSH 認証鍵がインスタンス メタデータに格納されていることを示します。

   • プロジェクトの SSH 認証鍵。[セキュリティとアクセス] セクションで、[プロジェクト全体の SSH 認証鍵をブロック] フィールドを表示します。

     • 値 On は、インスタンス メタデータのメタデータキー block-project-ssh-keys の値が TRUE であることを示します。

     • 値 Off は、メタデータキー block-project-ssh-keys の値が FALSE であるか、キーが設定されていないことを示します。

   • その他すべてのカスタム メタデータ。[カスタム メタデータ] セクションを表示します。SSH 認証鍵メタデータ以外の、すべてのカスタム メタデータのキーと値が表示されます。

gcloud

gcloud compute instances describe コマンドを使用して、インスタンスのメタデータをクエリします。

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

VM_NAME は、メタデータを検索する VM の名前に置き換えます。

出力は次のようになります。

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

REST

特定の VM のメタデータをクエリするには、GET リクエストを instances.get メソッドに送信します。

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

出力は次のようになります。

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

次のように置き換えます。

• PROJECT_ID: プロジェクト ID
• ZONE: VM を配置するゾーン。
• VM_NAME: VM の名前