デフォルトの 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 Login の詳細については、OS Login を設定するをご覧ください。
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 Login が管理する 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 の作成時に設定され、変更できません。

スケジューリング オプションの詳細については、インスタンス可用性ポリシーを設定するをご覧ください。
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 Login の詳細については、OS Login を設定するをご覧ください。
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 Login が管理する SSH 認証鍵は、メタデータには表示されません。

インスタンスのゲスト属性

インスタンスのゲスト属性は、次のディレクトリに保存されます。

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes
メタデータ エントリ 説明
guestInventory/

VM の OS インベントリを保存します。

OS の詳細情報を収集して保存します。これには、ホスト名、カーネル バージョン、アーキテクチャ、インストール済みパッケージの詳細などの情報が含まれます。

OS インベントリの詳細については、オペレーティング システムの詳細を表示するをご覧ください。
hostkeys/

SSH ホストキーを保存します。ホストキーを使用して、特定のホストまたはマシンを識別できます。

ホストキーの詳細については、ゲスト属性を有効にしてホストキーを保存するをご覧ください。

次のステップ