사전 정의된 메타데이터 키

각 메타데이터 항목은 메타데이터 서버에 키-값 쌍으로 저장됩니다. 메타데이터 키는 대소문자를 구분합니다. 키는 사전 정의된 키 또는 커스텀 메타데이터 키일 수 있습니다.

사전 정의된 메타데이터 키는 Compute Engine에서 생성된 메타데이터 키입니다. VM을 만들면 Compute Engine이 VM 인스턴스 ID 또는 프로젝트 ID와 같이 해당 VM에서 이러한 일부 키에 대해 메타데이터 값을 자동으로 설정합니다. Compute Engine이 값을 자동으로 설정하지 않는 사전 정의된 키의 경우 시스템 구성에 따라 제공되는 값 집합 중에서 선택할 수 있습니다. 예를 들어 특정 VM에 대해 OS 로그인을 사용 설정하려면 enable-oslogin 사전 정의된 키의 값을 해당 VM에 대해 TRUE로 설정하면 됩니다. 해당 VM에 대해 OS 로그인을 사용 중지하려면 키 값을 FALSE로 설정하면 됩니다.이러한 키의 값만 업데이트할 수 있고 키 자체는 업데이트할 수 없습니다.

이 문서에서는 Compute Engine이 instance/ 및 project/ 메타데이터 디렉터리에서 제공하는 사전 정의된 메타데이터 키에 대한 정보를 제공합니다.

Compute Engine의 VM 메타데이터의 정의, 분류, 정렬 방법에 대한 자세한 내용은 VM 메타데이터 정보를 참조하세요.

사전 정의된 프로젝트 메타데이터 키

프로젝트 메타데이터의 사전 정의된 메타데이터 키가 다음 디렉터리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/project/

다음 표에서는 Compute Engine이 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/

다음 표에서는 Compute Engine이 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를 사용 설정합니다.

VM에 영역 DNS 이름을 사용하는 방법에 대한 자세한 내용은 내부 DNS에 유형에 영역 DNS 사용을 참조하세요.

사전 정의된 인스턴스 메타데이터 키

프로젝트 메타데이터의 사전 정의된 메타데이터 키가 다음 디렉터리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/instance/

다음 표에서는 Compute Engine이 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

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

gce-workload-certificates/(미리보기)

VM에서 실행되는 애플리케이션에서 사용되는 관리형 워크로드 아이덴티티 기능의 다음 엔드포인트를 저장합니다.

  • config-status: VM 메타데이터를 통해 제공된 구성 값의 오류를 포함합니다.
  • workload-identities: Compute Engine 컨트롤 플레인에서 관리하는 ID를 포함합니다. 이 엔드포인트에는 X.509 인증서와 VM의 신뢰 도메인에 대한 비공개 키가 포함되어 있습니다.
  • trust-anchors: 피어 X.509 인증서 체인 유효성 검사를 위한 신뢰할 수 있는 인증서 세트가 포함되어 있습니다.

자세한 내용은 mTLS를 통해 다른 워크로드에 대해 워크로드 인증을 참조하세요.

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

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

partner-attributes/(미리보기)

메타데이터 항목이 저장되는 네임스페이스가 포함된 디렉터리입니다. 네임스페이스는 파트너 속성을 사용하여 구성을 저장하는 Google Cloud 서비스에서 생성됩니다. 파트너 속성을 사용하는 서비스가 없으면 디렉터리가 비어 있습니다.

예를 들어, 관리형 워크로드 아이덴티티는 구성을 위해 파트너 속성을 사용합니다.

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 아이덴티티 확인을 참조하세요.

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

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

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

tags

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

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

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

사전 정의된 인스턴스 속성 메타데이터 키

인스턴스 속성에 대한 사전 정의된 메타데이터 키는 다음 디렉토리에 저장됩니다.

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/

다음 표에서는 Compute Engine이 instance/attributes/ 메타데이터 디렉터리에 자동으로 생성하는 메타데이터 키 목록을 보여줍니다.

메타데이터 항목 설명
physical_host

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

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

enable-oslogin

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

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

enable-windows-ssh(미리보기)

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

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

enable-workload-certificate(미리보기)

VM에서 관리형 워크로드 아이덴티티를 사용 설정 또는 중지합니다.

자세한 내용은 개별 VM에 관리형 워크로드 아이덴티티 사용 설정을 참조하세요.
vmdnssetting

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

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/

다음 표에서는 Compute Engine이 instance/guest-attributes/ 메타데이터 디렉터리에 자동으로 만드는 메타데이터 키와 디렉터리의 목록을 보여줍니다.

메타데이터 항목 설명
guestInventory/

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

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

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

hostkeys/

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

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

다음 단계