Kunci metadata standar

Setiap entri metadata disimpan di server metadata sebagai pasangan nilai kunci. Kunci metadata peka huruf besar/kecil. Kunci Anda dapat berupa kunci metadata kustom atau yang telah ditentukan sebelumnya.

Kunci metadata standar adalah kunci metadata yang dibuat oleh Compute Engine. Saat Anda membuat VM, Compute Engine akan otomatis menetapkan nilai metadata untuk beberapa kunci ini di VM tersebut—misalnya, ID instance VM atau project ID. Untuk kunci standar yang tidak ditetapkan secara otomatis oleh Compute Engine, Anda dapat memilih dari serangkaian nilai yang tersedia, bergantung pada konfigurasi sistem. Misalnya, untuk mengaktifkan login OS untuk VM, Anda dapat menetapkan nilai kunci standar enable-oslogin ke TRUE untuk VM tersebut. Untuk menonaktifkan login OS untuk VM tersebut, Anda dapat memperbarui nilai kunci menjadi FALSE. Anda hanya dapat memperbarui nilai untuk kunci ini, tetapi tidak dapat memperbarui kunci itu sendiri.

Dokumen ini memberikan informasi tentang kunci metadata standar yang disediakan Compute Engine di direktori metadata instance/ dan project/ Anda.

Untuk mengetahui informasi tentang cara metadata VM untuk Compute Engine ditentukan, dikategorikan, dan diatur, lihat Tentang metadata VM.

Kunci metadata project standar

Kunci metadata standar untuk metadata project disimpan di direktori berikut:

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

Tabel berikut memberikan daftar kunci dan direktori metadata yang dibuat secara otomatis oleh Compute Engine di direktori metadata 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.

Kunci metadata atribut project standar

Kunci metadata standar untuk atribut project disimpan di direktori berikut:

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

Tabel berikut memberikan daftar kunci metadata yang dibuat Compute Engine secara otomatis di direktori metadata 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 OS. Hal ini mencakup informasi seperti nama host, versi kernel, arsitektur, dan 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 Windows VM.

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 penggunaan nama DNS zona untuk VM, lihat Menggunakan DNS Zona untuk jenis DNS internal.

Kunci metadata instance standar

Kunci metadata standar untuk metadata instance disimpan di direktori berikut:

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

Tabel berikut memberikan daftar kunci dan direktori metadata yang dibuat secara otomatis oleh Compute Engine di direktori metadata 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.

gce-workload-certificates/(Pratinjau)

Menyimpan endpoint berikut untuk fitur identitas workload terkelola yang digunakan oleh aplikasi yang berjalan di VM.

  • config-status: Berisi error dalam nilai konfigurasi yang diberikan melalui metadata VM.
  • workload-identities: Berisi identitas yang dikelola oleh bidang kontrol Compute Engine. Endpoint ini berisi sertifikat X.509 dan kunci pribadi untuk domain kepercayaan VM.
  • trust-anchors: Berisi kumpulan sertifikat tepercaya untuk validasi rantai sertifikat X.509 peer.

Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi workload ke workload lain melalui mTLS.

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.

partner-attributes/(Pratinjau)

Direktori yang berisi namespace tempat entri metadata disimpan. Namespace dibuat oleh layanan Google Cloud, yang menggunakan atribut partner untuk menyimpan konfigurasinya. Jika tidak ada layanan yang menggunakan atribut partner, direktori akan kosong.

Misalnya, workload identity terkelola menggunakan atribut partner untuk konfigurasinya.

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

Kunci metadata atribut instance standar

Kunci metadata standar untuk atribut instance disimpan di direktori berikut:

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

Tabel berikut memberikan daftar kunci metadata yang dibuat Compute Engine secara otomatis di direktori metadata 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 (Pratinjau)

Mengaktifkan atau menonaktifkan SSH untuk Windows VM.

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

enable-workload-certificate (Pratinjau)

Mengaktifkan atau menonaktifkan identitas workload terkelola di VM.

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan identitas beban kerja terkelola untuk setiap VM.
vmdnssetting

Aktifkan DNS zona dan DNS global untuk VM.

Untuk mengetahui informasi selengkapnya tentang penggunaan nama DNS zona untuk DNS VM, lihat Menggunakan DNS Zona untuk jenis 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 di metadata.

Kunci metadata atribut tamu standar

Kunci metadata standar untuk atribut tamu instance disimpan di direktori berikut:

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

Tabel berikut memberikan daftar kunci dan direktori metadata yang dibuat secara otomatis oleh Compute Engine di direktori metadata 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?