Nilai metadata VM default

Compute Engine menentukan sekumpulan entri metadata default yang memberikan informasi tentang instance virtual machine (VM) atau project Anda. Metadata default selalu ditentukan dan ditetapkan oleh server. Kunci metadata default peka huruf besar/kecil.

Untuk mengetahui informasi tentang cara mengkueri nilai metadata, baca Mengkueri metadata VM.

Cara nilai metadata diatur

  • Metadata project dan instance: Metadata dapat ditetapkan ke project dan VM. Metadata project menyebar ke semua VM dalam sebuah project, sedangkan metadata instance hanya berlaku untuk satu VM.

  • Listingan direktori: Beberapa entri metadata adalah direktori yang berisi kunci metadata lainnya. Perbedaan ini ditandai dengan garis miring di akhir nama metadata. Misalnya, attributes/ adalah direktori yang berisi kunci metadata lain.

Metadata project

Entri metadata project disimpan di direktori berikut:

  • http://metadata.google.internal/computeMetadata/v1/project/
Entri metadata Deskripsi
attributes/

Direktori nilai metadata kustom yang diteruskan ke VM di project Anda selama startup atau shutdown. Nilai kustom ini dapat berupa atribut Google Cloud atau nilai metadata buatan pengguna.

Untuk daftar atribut Google Cloud tingkat project yang dapat Anda tetapkan, lihat Atribut project.

Untuk informasi selengkapnya tentang cara menetapkan metadata kustom, lihat Menetapkan metadata kustom.
numeric-project-id Project ID numerik (nomor project) instance, yang tidak sama dengan nama project yang terlihat di Konsol Google Cloud. Nilai ini berbeda dengan nilai entri metadata project-id.
project-id Project ID.

Atribut project

Atribut project disimpan di direktori berikut:

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/
Entri metadata Deskripsi
disable-legacy-endpoints

Menonaktifkan endpoint server metadata lama untuk semua VM di project Anda.

Endpoint lama tidak digunakan lagi. Selalu tetapkan disable-legacy-endpoints=TRUE.

enable-guest-attributes

Menetapkan atribut tamu untuk project.

Atribut tamu adalah nilai metadata instance VM kustom yang dapat Anda gunakan untuk memublikasikan notifikasi status yang jarang, data volume yang rendah, atau data frekuensi yang rendah. Nilai ini berguna untuk menunjukkan kapan skrip startup telah selesai, atau untuk memberikan notifikasi status yang jarang lainnya kepada aplikasi lain.

Untuk mengetahui informasi selengkapnya tentang atribut tamu, lihat Menetapkan dan mengkueri atribut tamu.

enable-os-inventory

Mengaktifkan atau menonaktifkan inventaris OS untuk project.

Mengumpulkan dan menyimpan informasi detail OS. Hal ini mencakup informasi seperti nama host, versi kernel, arsitektur, dan detail paket yang diinstal.

Untuk mengetahui informasi selengkapnya tentang inventaris OS, lihat Melihat detail sistem operasi.

enable-oslogin

Mengaktifkan atau menonaktifkan pengelolaan kunci SSH di project Anda.

Untuk mengetahui informasi selengkapnya tentang Login OS, lihat Menyiapkan Login OS.

enable-windows-ssh

Mengaktifkan atau menonaktifkan SSH untuk VM Windows.

Untuk mengetahui informasi selengkapnya, baca Terhubung ke VM Windows menggunakan SSH.

google-compute-default-region Jika ditetapkan, menyimpan region default yang digunakan oleh project.

Untuk mengetahui informasi selengkapnya tentang cara menetapkan region default, lihat Region dan zona default.

google-compute-default-zone Jika ditetapkan, menyimpan zona default yang digunakan oleh project.

Untuk mengetahui informasi selengkapnya tentang cara menetapkan zona default, lihat Region dan zona default.

ssh-keys

Jika Anda mengelola kunci SSH menggunakan metadata, atribut ini memungkinkan Anda mengonfigurasi kunci SSH publik yang dapat terhubung ke VM dalam project ini. Jika ada banyak kunci SSH, setiap kunci dipisahkan dengan karakter baris baru (\n). Nilai atribut ssh-keys berupa string.

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

Kunci SSH yang dikelola oleh Login OS tidak terlihat dalam metadata.

sshKeys Tidak digunakan lagi: Gunakan ssh-keys.
vmdnssetting

Aktifkan DNS zona dan DNS global untuk VM di project Anda.

Untuk mengetahui informasi selengkapnya tentang nama DNS internal, lihat DNS Internal.

Metadata instance VM

Entri metadata VM disimpan di direktori berikut:

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

Direktori nilai metadata kustom yang diteruskan ke VM selama startup atau shutdown. Nilai kustom ini dapat berupa atribut Google Cloud atau nilai metadata buatan pengguna.

Untuk daftar atribut Google Cloud tingkat instance yang dapat Anda tetapkan, lihat Atribut instance.

Untuk informasi selengkapnya tentang cara menetapkan metadata kustom, lihat Menetapkan metadata kustom.
cpu-platform

Platform CPU VM.

Untuk informasi tentang platform CPU, lihat Platform CPU.
description Deskripsi teks bebas dari instance yang ditetapkan menggunakan flag --description dengan menggunakan Google Cloud CLI atau API.
disks/

Direktori disk yang dipasang ke VM. Untuk setiap disk, tersedia informasi berikut:

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

Untuk informasi selengkapnya tentang disk, lihat Opsi penyimpanan.

guest-attributes/

Menetapkan atribut tamu untuk VM. Nilai kustom ini dapat berupa atribut Google Cloud atau nilai metadata buatan pengguna.

Untuk daftar atribut Google Cloud tingkat instance yang dapat Anda tetapkan, lihat Atribut tamu instance.

Untuk mengetahui informasi selengkapnya tentang atribut tamu, lihat Menetapkan dan mengkueri atribut tamu.

hostname Nama host VM.
id ID VM. Ini adalah ID numerik unik yang dihasilkan oleh Compute Engine. ID ini berguna untuk mengidentifikasi VM jika Anda tidak menggunakan nama VM.
image Image sistem operasi yang digunakan oleh VM. Nilai ini memiliki format berikut: projects/IMAGE_PROJECT/global/images/IMAGE_NAME.
legacy-endpoint-access/ Menyimpan daftar endpoint lama. Nilainya adalah 0.1 dan v1beta1.
licenses/ Daftar ID kode lisensi yang digunakan untuk memasang lisensi ke image, snapshot, dan disk.
machine-type Jenis mesin untuk VM ini. Nilai ini memiliki format berikut: projects/PROJECT_NUM/machineTypes/MACHINE_TYPE
maintenance-event Menunjukkan apakah peristiwa pemeliharaan memengaruhi VM ini atau tidak. Untuk mengetahui informasi selengkapnya, lihat Migrasi langsung.
name Nama VM.
network-interfaces/

Direktori antarmuka jaringan. Untuk setiap antarmuka jaringan, tersedia informasi berikut:

  • access-configs/

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

Untuk mengetahui informasi selengkapnya tentang antarmuka jaringan, lihat ringkasan Berbagai antarmuka jaringan.

preempted

Nilai boolean yang menunjukkan apakah VM akan di-preempt.
scheduling/

Menetapkan opsi penjadwalan untuk VM.

Nilai metadata penjadwalan mencakup hal berikut:

  • on-host-maintenance: menunjukkan apakah VM dihentikan atau bermigrasi langsung selama pemeliharaan host.
  • automatic-restart: Jika nilai ini adalah TRUE, VM akan otomatis dimulai ulang setelah terjadi error atau peristiwa pemeliharaan.
  • preemptible: Jika nilai ini adalah TRUE, VM bersifat preemptible. Nilai ini ditetapkan saat Anda membuat VM dan tidak dapat diubah.

Untuk mengetahui informasi selengkapnya tentang opsi penjadwalan, baca Menetapkan kebijakan ketersediaan instance.

service-accounts/

Direktori akun layanan yang terkait dengan VM. Untuk setiap akun layanan, tersedia informasi berikut:

  • aliases
  • email: Alamat email untuk akun layanan.
  • identity: Token Web JSON yang unik untuk VM. Anda harus menyertakan parameter audience dalam permintaan untuk nilai metadata VM ini. Contoh: ?audience=http://www.example.com.

    Untuk mengetahui informasi tentang cara meminta dan memverifikasi token identitas instance, baca Memverifikasi identitas VM.

  • scopes: Cakupan akses yang ditetapkan ke akun layanan.
  • token: Token akses OAuth2 yang dapat digunakan untuk mengautentikasi aplikasi.

    Untuk mengetahui informasi tentang token akses, lihat Mengautentikasi aplikasi secara langsung dengan token akses.

Untuk mengetahui informasi selengkapnya tentang cara Compute Engine menggunakan akun layanan, lihat Akun layanan.

tags

Mencantumkan semua tag jaringan yang terkait dengan VM.

Untuk mengetahui informasi selengkapnya tentang tag jaringan, lihat Menambahkan tag jaringan.

zone Zona tempat VM ini berada. Nilai ini memiliki format berikut: projects/PROJECT_NUM/zones/ZONE

Atribut instance

Atribut instance disimpan di direktori berikut:

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

String hash yang mewakili lokasi VM yang dibuat dengan kebijakan penempatan rapat.

Untuk mengetahui informasi selengkapnya tentang atribut ini, lihat Memverifikasi lokasi fisik VM.

enable-oslogin

Mengaktifkan atau menonaktifkan pengelolaan kunci SSH di VM Anda.

Untuk mengetahui informasi selengkapnya tentang Login OS, lihat Menyiapkan Login OS.

enable-windows-ssh

Mengaktifkan atau menonaktifkan SSH untuk VM Windows.

Untuk mengetahui informasi selengkapnya, baca Terhubung ke VM Windows menggunakan SSH.

vmdnssetting

Aktifkan DNS zona dan DNS global untuk VM.

Untuk mengetahui informasi selengkapnya tentang nama DNS internal, lihat DNS Internal.

ssh-keys

Jika Anda mengelola kunci SSH menggunakan metadata, atribut ini memungkinkan Anda mengonfigurasi kunci SSH publik yang dapat terhubung ke VM dalam project ini. Jika ada banyak kunci SSH, setiap kunci dipisahkan dengan karakter baris baru (\n). Nilai atribut ssh-keys berupa string.

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

Kunci SSH yang dikelola oleh Login OS tidak terlihat dalam metadata.

Atribut tamu instance

Atribut tamu instance disimpan di direktori berikut:

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes
Entri metadata Deskripsi
guestInventory/

Menyimpan inventaris OS untuk VM.

Mengumpulkan dan menyimpan informasi detail OS. Hal ini mencakup informasi seperti nama host, versi kernel, arsitektur, dan detail paket yang diinstal.

Untuk mengetahui informasi selengkapnya tentang inventaris OS, lihat Melihat detail sistem operasi.

hostkeys/

Menyimpan kunci host SSH. Kunci host dapat digunakan untuk mengidentifikasi host atau mesin tertentu.

Untuk informasi tentang kunci host, lihat Menyimpan kunci host dengan mengaktifkan atribut tamu.

Apa langkah selanjutnya?