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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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. VM 인스턴스 또는 프로젝트 메타데이터 디렉터리를 쿼리하려면 Linux VM에서 다음 명령어를 실행합니다.

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

   목록을 재귀적으로 쿼리하려는 VM 인스턴스나 프로젝트 메타데이터 디렉터리의 경로로 PATH_TO_METADATA_DIRECTORY를 바꿉니다. 예를 들면 다음과 같습니다.

   • 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. VM 인스턴스 또는 프로젝트 메타데이터 디렉터리를 쿼리하려면 Windows VM에서 다음 명령어를 실행합니다.

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

   목록을 재귀적으로 쿼리하려는 VM 인스턴스나 프로젝트 메타데이터 디렉터리의 경로로 PATH_TO_METADATA_DIRECTORY를 바꿉니다. 예를 들면 다음과 같습니다.

   • 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"
   

   목록을 재귀적으로 쿼리하려는 VM 인스턴스나 프로젝트 메타데이터 디렉터리의 경로로 PATH_TO_METADATA_DIRECTORY를 바꿉니다. 예를 들면 다음과 같습니다.

   • 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
     

   목록을 재귀적으로 쿼리하려는 VM 인스턴스나 프로젝트 메타데이터 디렉터리의 경로로 PATH_TO_METADATA_DIRECTORY를 바꿉니다. 예를 들면 다음과 같습니다.

   • 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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. 그런 다음 wait-for-change 요청에서 curl 도구 명령어로 ETag 값을 사용할 수 있습니다. 인스턴스나 프로젝트 메타데이터의 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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. 그러면 wait-for-change 요청에서 ETag 값을 사용할 수 있습니다. 인스턴스나 프로젝트 메타데이터의 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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으로 설정합니다. 메타데이터 서버는 0가 ETag 값인 응답을 반환하지 않습니다. 요청에서 0이 마지막 ETag로 지정되면 메타데이터 서버는 현재 값과 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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 인스턴스 메타데이터의 속성 하위 디렉터리에 저장될 수 있는 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

커스텀 영역 메타데이터를 쿼리하려면 GET 요청을 instanceSettings().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에 대해 메타데이터를 쿼리하려면 instances.get 메서드에 대해 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의 이름