Kunci metadata yang telah ditentukan sebelumnya

Setiap entri metadata disimpan di server metadata sebagai key-value pair. Kunci metadata peka huruf besar/kecil. Kunci Anda dapat berupa kunci metadata yang telah ditetapkan atau kunci metadata kustom.

Kunci metadata yang telah ditetapkan adalah kunci metadata yang dibuat oleh Compute Engine. Saat Anda membuat VM, Compute Engine secara otomatis menetapkan nilai metadata untuk beberapa kunci ini di VM tersebut, misalnya ID instance VM atau project ID. Untuk kunci yang telah ditentukan sebelumnya dengan Compute Engine tidak menetapkan nilai secara otomatis, Anda dapat memilih dari serangkaian nilai yang tersedia berdasarkan 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 bagi VM tersebut, Anda dapat memperbarui nilai kunci menjadi FALSE. Anda hanya dapat memperbarui nilai untuk kunci ini, tetapi tidak dapat memperbarui nilai kunci itu sendiri.

Dokumen ini memberikan informasi tentang kunci metadata yang telah ditetapkan 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 yang telah ditentukan sebelumnya

Kunci metadata yang telah ditentukan sebelumnya untuk metadata project disimpan di direktori berikut:

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

Tabel berikut berisi daftar kunci metadata dan direktori yang dibuat secara otomatis oleh Compute Engine dalam 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 yang telah ditentukan sebelumnya

Kunci metadata yang telah ditentukan sebelumnya untuk atribut project disimpan di direktori berikut:

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

Tabel berikut menyediakan daftar kunci metadata yang dibuat secara otomatis oleh Compute Engine 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 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 penggunaan nama DNS zona untuk VM, lihat Menggunakan DNS Zona untuk jenis DNS internal.

Kunci metadata instance yang telah ditentukan sebelumnya

Kunci metadata yang telah ditentukan sebelumnya untuk metadata instance disimpan dalam direktori berikut:

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

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

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

Kunci metadata atribut instance yang telah ditentukan sebelumnya

Kunci metadata yang telah ditentukan sebelumnya untuk atribut instance disimpan di direktori berikut:

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

Tabel berikut menyediakan daftar kunci metadata yang dibuat secara otomatis oleh Compute Engine 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

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 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 dalam metadata.

Kunci metadata atribut tamu yang telah ditentukan sebelumnya

Kunci metadata yang telah ditentukan sebelumnya untuk atribut tamu instance disimpan dalam direktori berikut:

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

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