기본 VM 메타데이터 값

Compute Engine은 가상 머신(VM) 인스턴스 또는 프로젝트에 대한 정보를 제공하는 일련의 기본 메타데이터 항목을 정의합니다. 기본 메타데이터는 항상 서버에서 정의되고 설정됩니다. 기본 메타데이터 키는 대소문자를 구분합니다.

메타데이터 값 쿼리에 대한 자세한 내용은 VM 메타데이터 쿼리를 참조하세요.

메타데이터 값 정렬 방법

  • 프로젝트 및 인스턴스 메타데이터: 메타데이터를 프로젝트 및 VM에 모두 할당할 수 있습니다. 프로젝트 메타데이터는 프로젝트 내의 모든 VM에 전파되지만 인스턴스 메타데이터는 단일 VM에만 적용됩니다.

  • 디렉터리 목록: 일부 메타데이터 항목은 다른 메타데이터 키를 포함하는 디렉터리입니다. 이러한 차이는 메타데이터 이름 뒤에 있는 슬래시로 구분됩니다. 예를 들어 attributes/는 다른 메타데이터 키를 포함하는 디렉터리입니다.

프로젝트 메타데이터

프로젝트 메타데이터 항목은 다음 디렉터리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/project/
메타데이터 항목 설명
attributes/

시작 또는 종료 중에 프로젝트의 VM에 전달되는 커스텀 메타데이터 값의 디렉터리입니다. 이러한 커스텀 값은 Google Cloud 속성 또는 사용자가 만든 메타데이터 값일 수 있습니다.

설정할 수 있는 프로젝트 수준의 Google Cloud 속성 목록은 프로젝트 속성을 참조하세요.

커스텀 메타데이터 설정에 대한 자세한 내용은 커스텀 메타데이터 설정을 참조하세요.
numeric-project-id 인스턴스의 숫자 프로젝트 ID(프로젝트 번호)로, Google Cloud 콘솔에 표시되는 프로젝트 이름과 같지 않습니다. 이 값은 project-id 메타데이터 항목 값과는 다릅니다.
project-id 프로젝트 ID입니다.

프로젝트 속성

프로젝트 속성은 다음 디렉터리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/
메타데이터 항목 설명
disable-legacy-endpoints

프로젝트의 모든 VM에 대한 기존 메타데이터 서버 엔드포인트를 사용 중지합니다.

기존 엔드포인트는 지원 중단되었으며 항상 disable-legacy-endpoints=TRUE로 설정됩니다.

enable-guest-attributes

프로젝트에 대해 게스트 속성을 설정합니다.

게스트 속성은 간헐적인 상태 알림, 소량 데이터 또는 빈도가 낮은 데이터를 게시하는 데 사용할 수 있는 커스텀 VM 인스턴스 메타데이터 값입니다. 이 값은 시작 스크립트가 완료된 시기를 나타내거나 다른 애플리케이션에 다른 간헐적 상태 알림을 제공하는 데 유용합니다.

게스트 속성에 대한 자세한 내용은 게스트 속성 설정 및 질의를 참조하세요.

enable-os-inventory

프로젝트에 대해 OS 인벤토리를 사용 설정 또는 중지합니다.

OS 세부정보를 수집하고 저장합니다. 여기에는 호스트 이름, 커널 버전, 아키텍처, 설치된 패키지 세부정보와 같은 정보가 포함됩니다.

OS 인벤토리에 대한 자세한 내용은 운영체제 세부정보 보기를 참조하세요.

enable-oslogin

프로젝트에서 SSH 키 관리를 사용 설정 또는 중지합니다.

OS 로그인에 대한 자세한 내용은 OS 로그인 설정을 참조하세요.

enable-windows-ssh

Windows VM에 SSH를 사용 설정 또는 사용 중지합니다.

자세한 내용은 SSH를 사용하여 Windows VM에 연결을 참조하세요.

google-compute-default-region 설정된 경우 프로젝트에서 사용하는 기본 리전을 저장합니다.

기본 리전 설정에 대한 자세한 내용은 기본 리전 및 영역을 참조하세요.

google-compute-default-zone 설정된 경우 프로젝트에서 사용하는 기본 영역을 저장합니다.

기본 영역 설정에 대한 자세한 내용은 기본 리전 및 영역을 참조하세요.

ssh-keys

메타데이터를 사용하여 SSH 키를 관리하는 경우 이 속성을 사용해서 이 프로젝트의 VM에 연결할 수 있는 공개 SSH 키를 구성할 수 있습니다. SSH 키가 여러 개인 경우 각 키는 줄바꿈 문자(\n)로 구분됩니다. ssh-keys 속성의 값은 문자열입니다.

예: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

OS 로그인으로 관리되는 SSH 키는 메타데이터에 표시되지 않습니다.

sshKeys 지원 중단됨: ssh-keys를 사용하세요.
vmdnssetting

프로젝트에서 VM에 대해 영역 DNS 및 전역 DNS를 사용 설정합니다.

내부 DNS 이름에 대한 자세한 내용은 내부 DNS를 참조하세요.

VM 인스턴스 메타데이터

VM 메타데이터 항목은 다음 디렉터리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/instance/
메타데이터 항목 설명
attributes/

시작 또는 종료 중에 VM에 전달된 커스텀 메타데이터 값의 디렉터리입니다. 이러한 커스텀 값은 Google Cloud 속성 또는 사용자가 만든 메타데이터 값일 수 있습니다.

설정할 수 있는 인스턴스 수준의 Google Cloud 속성 목록은 인스턴스 속성을 참조하세요.

커스텀 메타데이터 설정에 대한 자세한 내용은 커스텀 메타데이터 설정을 참조하세요.
cpu-platform

VM의 CPU 플랫폼입니다.

CPU 플랫폼에 대한 자세한 내용은 CPU 플랫폼을 참조하세요.
description Google Cloud CLI 또는 API를 통해 --description 플래그를 사용하여 할당된 자유 텍스트 형식의 인스턴스 설명입니다.
disks/

VM에 연결된 디스크의 디렉터리입니다. 각 디스크에 대해 다음 정보가 제공됩니다.

  • device-name
  • index
  • interface
  • mode
  • type

디스크에 대한 자세한 내용은 스토리지 옵션을 참조하세요.

guest-attributes/

VM의 게스트 속성을 설정합니다. 이러한 커스텀 값은 Google Cloud 속성 또는 사용자가 만든 메타데이터 값일 수 있습니다.

설정할 수 있는 인스턴스 수준의 Google Cloud 속성 목록은 인스턴스 게스트 속성을 참조하세요.

게스트 속성에 대한 자세한 내용은 게스트 속성 설정 및 질의를 참조하세요.

hostname VM의 호스트 이름입니다.
id VM의 ID입니다. Compute Engine에서 생성된 고유한 숫자 ID이며, VM 이름을 사용하지 않는 경우에 VM을 식별하는 데 유용합니다.
image VM에 사용되는 운영체제 이미지입니다. 이 값은 projects/IMAGE_PROJECT/global/images/IMAGE_NAME 형식입니다.
legacy-endpoint-access/ 레거시 엔드포인트의 목록을 저장합니다. 값은 0.1 및 v1beta1입니다.
licenses/ 이미지, 스냅샷, 디스크에 라이선스를 연결하기 위해 사용되는 라이선스 코드 ID의 목록입니다.
machine-type 이 VM의 머신 유형입니다. 이 값은 projects/PROJECT_NUM/machineTypes/MACHINE_TYPE 형식입니다.
maintenance-event 유지보수 이벤트가 이 VM에 영향을 주는지 여부를 나타냅니다. 자세한 내용은 라이브 마이그레이션을 참조하세요.
name VM의 이름입니다.
network-interfaces/

네트워크 인터페이스의 디렉터리입니다. 각 네트워크 인터페이스에 대해 다음 정보가 제공됩니다.

  • access-configs/

    • external-ip
    • type
  • dns-servers
  • forwarded-ips/
  • gateway
  • ip
  • ip-aliases/
  • mac
  • mtu
  • network
  • subnetmask
  • target-instance-ips

네트워크 인터페이스에 대한 자세한 내용은 다중 네트워크 인터페이스 개요를 참조하세요.

preempted

VM이 곧 선점되는지를 나타내는 부울 값입니다.
scheduling/

VM에 대해 예약 옵션을 설정합니다.

예약 메타데이터 값에는 다음이 포함됩니다.

  • on-host-maintenance: 호스트 유지보수 중에 VM이 종료되는지 또는 라이브 마이그레이션되는지를 나타냅니다.
  • automatic-restart: 이 값이 TRUE이면 유지보수 이벤트 또는 비정상 종료 이후 VM이 자동으로 다시 시작됩니다.
  • preemptible: 값이 TRUE이면 VM이 선점형입니다. 이 값은 VM을 만들 때 설정되며, 변경될 수 없습니다.

예약 옵션에 대한 자세한 내용은 인스턴스 가용성 정책 설정을 참조하세요.

service-accounts/

VM과 인스턴스와 연결된 서비스 계정의 디렉터리입니다. 각 서비스 계정에 대한 다음 정보가 제공됩니다.

  • aliases
  • email: 서비스 계정의 이메일 주소입니다.
  • identity: VM에 고유한 JSON 웹 토큰입니다. 이 VM 메타데이터 값에 대한 요청에 audience 매개변수를 포함해야 합니다. 예를 들면 ?audience=http://www.example.com입니다.

    인스턴스 ID 토큰을 요청하고 확인하는 방법에 대한 자세한 내용은 VM ID 확인을 참조하세요.

  • scopes: 서비스 계정에 할당된 액세스 범위입니다.
  • token: 애플리케이션을 인증하는 데 사용할 수 있는 OAuth2 액세스 토큰입니다.

    액세스 토큰에 대한 자세한 내용은 액세스 토큰으로 직접 애플리케이션 인증을 참조하세요.

Compute Engine이 서비스 계정을 사용하는 방법에 대한 자세한 내용은 서비스 계정을 참조하세요.

tags

VM과 연관된 네트워크 태그를 나열합니다.

네트워크 태그에 대한 자세한 내용은 네트워크 태그 추가를 참조하세요.

zone 이 VM이 있는 영역입니다. 이 값은 projects/PROJECT_NUM/zones/ZONE 형식입니다.

인스턴스 속성

인스턴스 속성은 다음 디렉터리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/
메타데이터 항목 설명
physical_host

압축 배치 정책으로 만든 VM의 위치를 나타내는 해시 문자열입니다.

이 속성에 대한 자세한 내용은 VM의 물리적 위치 확인을 참조하세요.

enable-oslogin

VM에서 SSH 키 관리를 사용 설정 또는 중지합니다.

OS 로그인에 대한 자세한 내용은 OS 로그인 설정을 참조하세요.

enable-windows-ssh

Windows VM에 SSH를 사용 설정 또는 사용 중지합니다.

자세한 내용은 SSH를 사용하여 Windows VM에 연결을 참조하세요.

vmdnssetting

VM에 대해 영역 DNS 및 전역 DNS를 사용 설정합니다.

내부 DNS 이름에 대한 자세한 내용은 내부 DNS를 참조하세요.

ssh-keys

메타데이터를 사용하여 SSH 키를 관리하는 경우 이 속성을 사용해서 이 프로젝트의 VM에 연결할 수 있는 공개 SSH 키를 구성할 수 있습니다. SSH 키가 여러 개인 경우 각 키는 줄바꿈 문자(\n)로 구분됩니다. ssh-keys 속성의 값은 문자열입니다.

예: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

OS 로그인으로 관리되는 SSH 키는 메타데이터에 표시되지 않습니다.

인스턴스 게스트 속성

인스턴스 게스트 속성은 다음 디렉터리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes
메타데이터 항목 설명
guestInventory/

VM의 OS 인벤토리를 저장합니다.

OS 세부정보를 수집하고 저장합니다. 여기에는 호스트 이름, 커널 버전, 아키텍처, 설치된 패키지 세부정보와 같은 정보가 포함됩니다.

OS 인벤토리에 대한 자세한 내용은 운영체제 세부정보 보기를 참조하세요.

hostkeys/

SSH 호스트 키를 저장합니다. 호스트 키를 사용하여 특정 호스트 또는 머신을 식별할 수 있습니다.

호스트 키에 대한 자세한 내용은 게스트 속성을 사용 설정하여 호스트 키 저장을 참조하세요.

다음 단계