Melihat detail dan status ekstensi VM

Anda menginstal ekstensi VM pada instance virtual machine (VM) Compute Engine dengan membuat kebijakan ekstensi global atau zona di tingkat organisasi, folder, atau project. Satu kebijakan dapat menginstal beberapa ekstensi di satu VM, dan beberapa kebijakan dapat diterapkan ke VM yang sama.

Dokumen ini menjelaskan cara menggunakan metode get dan list hanya baca di seluruh hierarki resource Google Cloud untuk melakukan tugas-tugas berikut:

• Melihat kebijakan ekstensi dalam hierarki resource Anda. Cantumkan kebijakan ekstensi VM global atau zona untuk melihat detail kebijakan dan status peluncuran di seluruh organisasi, folder, atau project Anda.
• Melihat ekstensi dan versi VM. Cantumkan ekstensi VM yang didukung VM Extension Manager atau lihat detail ekstensi—termasuk nomor versi dan tingkat dukungan—di semua zona atau di zona tertentu dalam organisasi, folder, atau project Anda.
• Melihat status ekstensi yang diinstal di setiap VM. Mencantumkan semua ekstensi VM yang diinstal dan status runtime-nya pada instance saat kebijakan menginstal beberapa ekstensi pada VM, atau melihat konfigurasi efektif akhir dan kebijakan yang mengatur (policyId) saat beberapa kebijakan berlaku untuk VM yang sama.
• Memecahkan masalah ekstensi pada instance. Lihat progres penginstalan, status responsivitas runtime, dan pesan diagnostik saat ekstensi yang tidak terduga diinstal atau ekstensi gagal di instance VM.

Sebelum memulai

Sebelum melihat kebijakan ekstensi VM, mengambil detail ekstensi VM, atau memeriksa status ekstensi di instance VM, selesaikan prasyarat berikut:

• Baca artikel Tentang VM Extension Manager untuk memahami cara kebijakan ekstensi mengelola plugin agen tamu di seluruh fleet VM Anda.
• Jika Anda belum men-deploy ekstensi ke instance, buat kebijakan terlebih dahulu. Untuk mengetahui informasi selengkapnya, lihat Menginstal ekstensi VM dengan membuat kebijakan ekstensi.
• Pastikan Anda memiliki izin Identity and Access Management yang diperlukan untuk melihat kebijakan ekstensi, mengambil detail ekstensi, dan memeriksa status ekstensi instance.

Batasan tampilan kebijakan dan ekstensi

Saat Anda melihat kebijakan ekstensi VM, detail ekstensi, dan status instance, pertimbangkan batasan operasional berikut:

• Anda dapat melihat kebijakan ekstensi VM cakupan folder dan cakupan organisasi hanya dengan menggunakan Google Cloud CLI atau Compute Engine REST API.
• Anda hanya dapat mengambil detail ekstensi VM dan status ekstensi instance menggunakan Google Cloud CLI atau Compute Engine REST API. Anda tidak dapat melihat detail ekstensi VM atau status ekstensi per instance di konsolGoogle Cloud .
• API status ekstensi instance (getVmExtensionState dan listVmExtensionStates) hanya melaporkan status runtime untuk ekstensi yang diinstal dan dikelola oleh kebijakan VM Extension Manager. API ini tidak melaporkan status untuk agen mandiri yang Anda instal secara manual di luar VM Extension Manager.

Melihat kebijakan ekstensi

Anda dapat mencantumkan kebijakan ekstensi VM atau memeriksa detail konfigurasi kebijakan tertentu di level organisasi, folder, atau project.

Melihat kebijakan ekstensi global di semua zona dalam organisasi

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mencantumkan semua kebijakan ekstensi VM global di organisasi Anda atau memeriksa kebijakan global tertentu yang tercakup dalam organisasi untuk mengaudit peluncuran ekstensi di seluruh fleet.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi cakupan organisasi, minta administrator untuk memberi Anda peran IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) atau Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi cakupan organisasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi cakupan organisasi:

• Mencantumkan kebijakan ekstensi: compute.orgVmExtensionPolicies.list
• Melihat detail kebijakan ekstensi: compute.orgVmExtensionPolicies.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat kebijakan ekstensi global dalam organisasi, pilih salah satu opsi berikut:

gcloud

Untuk melihat semua kebijakan ekstensi global dalam organisasi, jalankan perintah gcloud preview compute global-vm-extension-policies list dengan flag --organization:

gcloud preview compute global-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --page-size=PAGE_SIZE

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• PAGE_SIZE: jumlah maksimum hasil yang akan ditampilkan per halaman.

Untuk melihat detail kebijakan ekstensi global tertentu dalam organisasi, jalankan perintah gcloud preview compute global-vm-extension-policies describe dengan flag --organization:

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.

REST

Untuk melihat semua kebijakan ekstensi global dalam organisasi, kirim permintaan GET ke metode organizationGlobalVmExtensionPolicies.list:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies

Untuk melihat detail kebijakan ekstensi global tertentu dalam organisasi, kirim permintaan GET ke metode organizationGlobalVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.

Melihat kebijakan ekstensi global di semua zona dalam folder

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mencantumkan semua kebijakan ekstensi VM global dalam folder atau memeriksa kebijakan global tertentu yang tercakup dalam folder untuk memverifikasi ekstensi mana yang berlaku di seluruh project dalam folder tersebut.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi cakupan folder, minta administrator untuk memberi Anda peran IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) atau Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) di folder Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi cakupan folder. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi cakupan folder:

• Mencantumkan kebijakan ekstensi: compute.folderVmExtensionPolicies.list
• Melihat detail kebijakan ekstensi: compute.folderVmExtensionPolicies.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat kebijakan ekstensi global dalam folder, pilih salah satu opsi berikut:

gcloud

Untuk melihat semua kebijakan ekstensi global dalam folder, jalankan perintah gcloud preview compute global-vm-extension-policies list dengan flag --folder:

gcloud preview compute global-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --page-size=PAGE_SIZE

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• PAGE_SIZE: jumlah maksimum hasil yang akan ditampilkan per halaman.

Untuk melihat detail kebijakan ekstensi global tertentu dalam folder, jalankan perintah gcloud preview compute global-vm-extension-policies describe dengan flag --folder:

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• FOLDER_ID: ID folder Google Cloud Anda.

REST

Untuk melihat semua kebijakan ekstensi global dalam folder, kirim permintaan GET ke metode folderGlobalVmExtensionPolicies.list:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies

Untuk melihat detail kebijakan ekstensi global tertentu dalam folder, kirim permintaan GET ke metode folderGlobalVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• FOLDER_ID: ID folder Google Cloud Anda.

Melihat kebijakan ekstensi global di semua zona dalam sebuah project

Anda dapat melihat kebijakan ekstensi VM global dalam project untuk memantau progres peluncuran dan memeriksa konfigurasi ekstensi di semua zona dalam project tersebut.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi cakupan project, minta administrator untuk memberi Anda peran IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) atau Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi cakupan project. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi cakupan project:

• Mencantumkan kebijakan ekstensi: compute.vmExtensionPolicies.list
• Melihat detail kebijakan ekstensi: compute.vmExtensionPolicies.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat kebijakan ekstensi global dalam project, pilih salah satu opsi berikut:

Konsol

Untuk melihat kebijakan ekstensi VM global di project Anda menggunakan konsol Google Cloud , selesaikan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman VM extension policies.

   Buka VM extension policies

2. Klik Global policies. Tab ini mencantumkan semua kebijakan ekstensi VM global di project Anda.

gcloud

Untuk melihat semua kebijakan ekstensi global dalam sebuah project, jalankan perintah gcloud compute global-vm-extension-policies list:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• PAGE_SIZE: jumlah maksimum hasil yang akan ditampilkan per halaman.

Untuk melihat detail kebijakan ekstensi global tertentu dalam sebuah project, jalankan perintah gcloud compute global-vm-extension-policies describe:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• PROJECT_ID: ID project Google Cloud Anda.

REST

Untuk melihat semua kebijakan ekstensi global dalam sebuah project, kirim permintaan GET ke metode globalVmExtensionPolicies.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies

Untuk melihat detail kebijakan ekstensi global tertentu dalam sebuah project, kirim permintaan GET ke metode globalVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• PROJECT_ID: ID project Google Cloud Anda.

Melihat kebijakan ekstensi zona di suatu zona di seluruh organisasi

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mencantumkan kebijakan ekstensi VM cakupan organisasi di zona tertentu atau memeriksa satu kebijakan untuk mengaudit aturan penerapan tingkat zona di seluruh organisasi Anda.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi cakupan organisasi, minta administrator untuk memberi Anda peran IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) atau Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi cakupan organisasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi cakupan organisasi:

• Mencantumkan kebijakan ekstensi: compute.orgVmExtensionPolicies.list
• Melihat detail kebijakan ekstensi: compute.orgVmExtensionPolicies.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat kebijakan ekstensi zona dalam organisasi, pilih salah satu opsi berikut:

gcloud

Untuk melihat semua kebijakan ekstensi cakupan organisasi di zona, jalankan perintah gcloud preview compute zone-vm-extension-policies list dengan flag --organization:

gcloud preview compute zone-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: nama zona tempat Anda ingin mencantumkan kebijakan ekstensi VM.
• PAGE_SIZE: jumlah maksimum hasil yang akan ditampilkan per halaman.

Untuk melihat detail kebijakan ekstensi zona tertentu yang tercakup dalam organisasi, jalankan perintah gcloud preview compute zone-vm-extension-policies describe dengan flag --organization:

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.

REST

Untuk melihat semua kebijakan ekstensi zona dalam organisasi, kirim permintaan GET ke metode organizationZoneVmExtensionPolicies.list:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies

Untuk melihat detail kebijakan ekstensi zona tertentu dalam organisasi, kirim permintaan GET ke metode organizationZoneVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.

Melihat kebijakan ekstensi zona di suatu zona di seluruh folder

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mencantumkan kebijakan ekstensi VM cakupan folder di zona tertentu atau memeriksa satu kebijakan untuk memverifikasi aturan ekstensi tingkat zona untuk project di folder Anda.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi cakupan folder, minta administrator untuk memberi Anda peran IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) atau Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) di folder Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi cakupan folder. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi cakupan folder:

• Mencantumkan kebijakan ekstensi: compute.folderVmExtensionPolicies.list
• Melihat detail kebijakan ekstensi: compute.folderVmExtensionPolicies.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat kebijakan ekstensi zona dalam folder, pilih salah satu opsi berikut:

gcloud

Untuk melihat semua kebijakan ekstensi cakupan folder di zona, jalankan perintah gcloud preview compute zone-vm-extension-policies list dengan flag --folder:

gcloud preview compute zone-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: nama zona tempat Anda ingin mencantumkan kebijakan ekstensi VM.
• PAGE_SIZE: jumlah maksimum hasil yang akan ditampilkan per halaman.

Untuk melihat detail kebijakan ekstensi zona tertentu yang tercakup dalam folder, jalankan perintah gcloud preview compute zone-vm-extension-policies describe dengan flag --folder:

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.

REST

Untuk melihat semua kebijakan ekstensi zona dalam folder, kirim permintaan GET ke metode folderZoneVmExtensionPolicies.list:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies

Untuk melihat detail kebijakan perpanjangan zona tertentu dalam folder, kirim permintaan GET ke metode folderZoneVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.

Melihat kebijakan ekstensi zona di zona dalam project

Anda dapat mencantumkan kebijakan ekstensi VM cakupan project di zona tertentu atau memeriksa satu kebijakan untuk memverifikasi ekstensi mana yang berlaku untuk instance di zona tersebut.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat kebijakan ekstensi cakupan project, minta administrator untuk memberi Anda peran IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) atau Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan ekstensi cakupan project. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat kebijakan ekstensi cakupan project:

• Mencantumkan kebijakan ekstensi: compute.vmExtensionPolicies.list
• Melihat detail kebijakan ekstensi: compute.vmExtensionPolicies.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat kebijakan ekstensi zona dalam project, pilih salah satu opsi berikut:

Konsol

Untuk melihat kebijakan ekstensi VM zona di project Anda menggunakan konsol Google Cloud , selesaikan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman VM extension policies.

   Buka VM extension policies

2. Untuk melihat detail kebijakan ekstensi tertentu, klik nama kebijakan.

gcloud

Untuk melihat semua kebijakan ekstensi cakupan project di suatu zona, jalankan perintah gcloud compute zone-vm-extension-policies list:

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• ZONE: nama zona tempat Anda ingin mencantumkan kebijakan ekstensi VM.
• PAGE_SIZE: jumlah maksimum hasil yang akan ditampilkan per halaman.

Untuk melihat detail kebijakan ekstensi zona tertentu yang tercakup dalam project, jalankan perintah gcloud compute zone-vm-extension-policies describe:

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• PROJECT_ID: ID project Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.

REST

Untuk melihat semua kebijakan ekstensi zona dalam sebuah project, kirim permintaan GET ke metode zoneVmExtensionPolicies.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies

Untuk melihat detail kebijakan ekstensi zona tertentu dalam sebuah project, kirim permintaan GET ke metode zoneVmExtensionPolicies.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda lihat.
• PROJECT_ID: ID project Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.

Melihat ekstensi dan versi VM

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat menggunakan metode get dan list hanya baca untuk melihat ekstensi VM yang didukung VM Extension Manager di seluruh organisasi, folder, atau project Anda. Anda dapat melihat nama ekstensi, nomor versi, dan tingkat dukungan ekstensi di semua zona atau dalam zona tertentu.

Melihat ekstensi VM di semua zona dalam organisasi

Gunakan metode get dan list hanya baca untuk melihat ekstensi VM yang didukung VM Extension Manager di semua zona dalam organisasi Anda, termasuk nomor versi dan tingkat dukungannya.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat ekstensi VM di seluruh organisasi, minta administrator untuk memberi Anda peran IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) atau Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk melihat ekstensi VM di seluruh organisasi Anda. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat ekstensi VM di seluruh organisasi Anda:

• Mencantumkan ekstensi VM: compute.orgVmExtensions.list
• Melihat detail ekstensi VM: compute.orgVmExtensions.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat ekstensi dan versi VM yang didukung VM Extension Manager di semua zona dalam organisasi Anda, pilih salah satu opsi berikut:

gcloud

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di semua zona dalam organisasi Anda, jalankan perintah gcloud preview compute global-vm-extension-policies extensions list dengan flag --organization:

gcloud preview compute global-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.

Outputnya mencantumkan ekstensi VM yang didukung VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di organisasi Anda, jalankan perintah gcloud preview compute global-vm-extension-policies extensions describe dengan flag --organization:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID

Ganti kode berikut:

• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent, google-cloud-sap-extension, atau google-cloud-workload-extension).
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.

REST

Untuk mencantumkan semua ekstensi VM yang didukung oleh VM Extension Manager dan tingkat dukungannya di semua zona dalam organisasi Anda, kirim permintaan GET ke metode organizationGlobalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.

Respons akan mencantumkan ekstensi VM yang didukung oleh VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di organisasi Anda, kirim permintaan GET ke metode organizationGlobalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions/EXTENSION_NAME

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent).

Melihat ekstensi VM di semua zona dalam folder

Gunakan metode get dan list hanya baca untuk melihat ekstensi VM yang didukung VM Extension Manager di semua zona dalam folder Anda, termasuk nomor versi dan tingkat dukungannya.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat ekstensi VM di seluruh folder, minta administrator untuk memberi Anda peran IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) atau Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) di folder Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat ekstensi VM di seluruh folder Anda. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat ekstensi VM di seluruh folder Anda:

• Mencantumkan ekstensi VM: compute.folderVmExtensions.list
• Melihat detail ekstensi VM: compute.folderVmExtensions.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat ekstensi dan versi VM yang didukung VM Extension Manager di semua zona dalam folder Anda, pilih salah satu opsi berikut:

gcloud

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di semua zona dalam folder Anda, jalankan perintah gcloud preview compute global-vm-extension-policies extensions list dengan flag --folder:

gcloud preview compute global-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.

Outputnya mencantumkan ekstensi VM yang didukung VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di folder Anda, jalankan perintah gcloud preview compute global-vm-extension-policies extensions describe dengan flag --folder:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID

Ganti kode berikut:

• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent, google-cloud-sap-extension, atau google-cloud-workload-extension).
• FOLDER_ID: ID folder Google Cloud Anda.

REST

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di semua zona dalam folder Anda, kirim permintaan GET ke metode folderGlobalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.

Respons akan mencantumkan ekstensi VM yang didukung oleh VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di folder Anda, kirim permintaan GET ke metode folderGlobalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions/EXTENSION_NAME

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent).

Melihat ekstensi VM di semua zona dalam project

Gunakan metode get dan list hanya baca untuk melihat ekstensi VM yang didukung VM Extension Manager di semua zona dalam project Anda, termasuk nomor versi dan tingkat dukungannya.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat ekstensi VM di project Anda, minta administrator untuk memberi Anda peran IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) atau Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat ekstensi VM di project Anda. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat ekstensi VM di project Anda:

• Mencantumkan ekstensi VM: compute.vmExtensions.list
• Melihat detail ekstensi VM: compute.vmExtensions.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat ekstensi dan versi VM yang didukung VM Extension Manager di semua zona dalam project Anda, pilih salah satu opsi berikut:

gcloud

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di semua zona dalam project Anda, jalankan perintah gcloud preview compute global-vm-extension-policies extensions list:

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.

Outputnya mencantumkan ekstensi VM yang didukung VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di project Anda, jalankan perintah gcloud preview compute global-vm-extension-policies extensions describe:

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

Ganti kode berikut:

• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent, google-cloud-sap-extension, atau google-cloud-workload-extension).
• PROJECT_ID: ID project Google Cloud Anda.

REST

Untuk mencantumkan semua ekstensi VM yang didukung oleh VM Extension Manager dan tingkat dukungannya di semua zona dalam project Anda, kirim permintaan GET ke metode globalVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.

Cuplikan JSON berikut menunjukkan contoh respons yang mencantumkan ekstensi VM yang didukung oleh VM Extension Manager dan tingkat dukungan ekstensi-nya:

{
  "kind": "compute#globalVmExtensionList",
  "items": [
    {
      "kind": "compute#globalVmExtension",
      "name": "ops-agent",
      "versions": [
        "2.58.0",
        "2.57.0"
      ],
      "supportLevel": "GA",
      "selfLink": "https://www.googleapis.com/compute/2026-10-01-preview/projects/my-project/global/vmExtensions/ops-agent"
    }
  ]
}

Untuk melihat detail ekstensi VM tertentu di project Anda, kirim permintaan GET ke metode globalVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions/EXTENSION_NAME

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent).

Melihat ekstensi VM di sebuah zona dalam organisasi

Gunakan metode get dan list hanya baca untuk melihat ekstensi VM yang didukung VM Extension Manager di zona tertentu di seluruh organisasi Anda, termasuk nomor versi dan tingkat dukungannya.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat ekstensi VM di zona di seluruh organisasi, minta administrator untuk memberi Anda peran IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) atau Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat ekstensi VM di zona di seluruh organisasi Anda. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat ekstensi VM di zona di seluruh organisasi Anda:

• Mencantumkan ekstensi VM: compute.orgVmExtensions.list
• Melihat detail ekstensi VM: compute.orgVmExtensions.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat ekstensi dan versi VM yang didukung VM Extension Manager di zona di seluruh organisasi Anda, pilih salah satu opsi berikut:

gcloud

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di zona tertentu di seluruh organisasi Anda, jalankan perintah gcloud preview compute zone-vm-extension-policies extensions list dengan flag --organization:

gcloud preview compute zone-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: zona Google Cloud tempat Anda ingin mencantumkan ekstensi VM (misalnya, us-central1-a).

Outputnya mencantumkan ekstensi VM yang didukung VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di zona di seluruh organisasi Anda, jalankan perintah gcloud preview compute zone-vm-extension-policies extensions describe dengan flag --organization:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Ganti kode berikut:

• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent).
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: zona tempat Anda ingin melihat detail ekstensi.

REST

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di zona tertentu di seluruh organisasi Anda, kirim permintaan GET ke metode organizationZoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: nama zona (misalnya, us-central1-a).

Respons akan mencantumkan ekstensi VM yang didukung oleh VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di zona di seluruh organisasi Anda, kirim permintaan GET ke metode organizationZoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: nama zona.
• EXTENSION_NAME: nama ekstensi VM.

Melihat ekstensi VM di zona dalam folder

Gunakan metode get dan list hanya baca untuk melihat ekstensi VM yang didukung VM Extension Manager di zona tertentu di seluruh folder Anda, termasuk nomor versi dan tingkat dukungannya.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat ekstensi VM di zona di seluruh folder, minta administrator untuk memberi Anda peran IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) atau Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) di folder Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat ekstensi VM di zona di seluruh folder Anda. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat ekstensi VM di zona di seluruh folder Anda:

• Mencantumkan ekstensi VM: compute.folderVmExtensions.list
• Melihat detail ekstensi VM: compute.folderVmExtensions.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat ekstensi dan versi VM yang didukung VM Extension Manager di zona di seluruh folder Anda, pilih salah satu opsi berikut:

gcloud

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di zona tertentu di seluruh folder Anda, jalankan perintah gcloud preview compute zone-vm-extension-policies extensions list dengan flag --folder:

gcloud preview compute zone-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: zona Google Cloud tempat Anda ingin mencantumkan ekstensi VM (misalnya, us-central1-a).

Outputnya mencantumkan ekstensi VM yang didukung VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di zona di seluruh folder Anda, jalankan perintah gcloud preview compute zone-vm-extension-policies extensions describe dengan flag --folder:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Ganti kode berikut:

• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent).
• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: zona tempat Anda ingin melihat detail ekstensi.

REST

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di zona tertentu di seluruh folder Anda, kirim permintaan GET ke metode folderZoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: nama zona (misalnya, us-central1-a).

Respons akan mencantumkan ekstensi VM yang didukung oleh VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di zona di seluruh folder Anda, kirim permintaan GET ke metode folderZoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: nama zona.
• EXTENSION_NAME: nama ekstensi VM.

Melihat ekstensi VM di zona dalam project

Gunakan metode get dan list hanya baca untuk melihat ekstensi VM yang didukung VM Extension Manager di zona tertentu dalam project Anda, termasuk nomor versi dan tingkat dukungannya.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat ekstensi VM di zona dalam project Anda, minta administrator untuk memberi Anda peran IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) atau Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) di project Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat ekstensi VM di zona dalam project Anda. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat ekstensi VM di zona dalam project Anda:

• Mencantumkan ekstensi VM: compute.vmExtensions.list
• Melihat detail ekstensi VM: compute.vmExtensions.get

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk melihat ekstensi dan versi VM yang didukung VM Extension Manager di zona dalam project Anda, pilih salah satu opsi berikut:

gcloud

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di zona tertentu dalam project Anda, jalankan perintah gcloud preview compute zone-vm-extension-policies extensions list:

gcloud preview compute zone-vm-extension-policies extensions list \
  --zone=ZONE \
  --project=PROJECT_ID

Ganti kode berikut:

• ZONE: zona Google Cloud tempat Anda ingin mencantumkan ekstensi VM (misalnya, us-central1-a).
• PROJECT_ID: ID project Google Cloud Anda.

Outputnya mencantumkan ekstensi VM yang didukung VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di zona dalam project Anda, jalankan perintah gcloud preview compute zone-vm-extension-policies extensions describe:

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --zone=ZONE \
  --project=PROJECT_ID

Ganti kode berikut:

• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent).
• ZONE: zona tempat Anda ingin melihat detail ekstensi.
• PROJECT_ID: ID project Google Cloud Anda.

REST

Untuk mencantumkan semua ekstensi VM yang didukung VM Extension Manager dan tingkat dukungannya di zona tertentu dalam project Anda, kirim permintaan GET ke metode zoneVmExtensionPolicies.listVmExtensions:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• ZONE: nama zona (misalnya, us-central1-a).

Respons tersebut mencantumkan ekstensi VM yang didukung VM Extension Manager, versinya, dan tingkat dukungan ekstensi.

Untuk melihat detail ekstensi VM tertentu di zona dalam project Anda, kirim permintaan GET ke metode zoneVmExtensionPolicies.getVmExtension:

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• ZONE: nama zona.
• EXTENSION_NAME: nama ekstensi VM.

Melihat status ekstensi VM pada instance

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda menginstal ekstensi VM di VM dengan membuat kebijakan ekstensi global atau zona di level organisasi, folder, atau project. Satu kebijakan dapat menginstal beberapa ekstensi di satu VM, dan beberapa kebijakan di seluruh hierarki resource Anda dapat diterapkan ke VM yang sama. Gunakan metode list dan get status ekstensi instance hanya baca untuk melihat status runtime ekstensi yang diinstal di setiap VM tanpa terhubung ke setiap mesin. Metode ini membantu Anda melihat konfigurasi efektif akhir dan kebijakan yang mengatur (policyId) untuk setiap ekstensi yang diinstal, atau memecahkan masalah saat ekstensi yang tidak terduga diinstal atau ekstensi gagal di instance.

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat status ekstensi VM pada instance, minta administrator untuk memberi Anda peran IAM Compute Viewer (roles/compute.viewer), Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1), atau Compute Admin (roles/compute.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat status ekstensi VM pada instance. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat status ekstensi VM pada instance:

• Mencantumkan semua status ekstensi VM pada instance: compute.instances.listVmExtensionStates
• Mendapatkan status ekstensi VM tertentu pada instance: compute.instances.getVmExtensionState

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mencantumkan semua status ekstensi VM pada instance

Jika kebijakan menginstal beberapa ekstensi di VM, jika beberapa kebijakan berlaku untuk instance yang sama, atau jika Anda menemukan ekstensi yang tidak terduga selama pemecahan masalah, cantumkan semua status ekstensi di VM untuk melihat konfigurasi efektif akhir dan status runtime setiap ekstensi yang diinstal. Respons akan menampilkan versi aktif, status penerapan, status respons, dan kebijakan yang mengatur (policyId) setiap ekstensi.

Untuk melihat status semua ekstensi VM yang diinstal pada instance, pilih salah satu opsi berikut:

gcloud

Untuk mencantumkan semua ekstensi VM yang diinstal dan melihat statusnya saat ini pada instance, jalankan perintah gcloud beta compute instances list-vm-extension-states:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

Ganti variabel berikut dengan nilai untuk lingkungan Anda:

• INSTANCE_NAME: nama instance VM.
• ZONE: zona tempat instance berada (misalnya, us-central1-a).
• PROJECT_ID: ID project Google Cloud Anda.

Perintah ini menampilkan tabel yang mencantumkan nama, status penerapan, dan status respons setiap ekstensi yang diinstal:

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

Untuk mencantumkan semua ekstensi VM yang diinstal dan melihat statusnya saat ini pada sebuah instance, kirim permintaan GET ke metode instances.listVmExtensionStates:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates

Ganti variabel berikut dengan nilai untuk lingkungan Anda:

• PROJECT_ID: ID project Google Cloud Anda.
• ZONE: zona tempat instance berada.
• INSTANCE_NAME: nama atau ID instance VM.

Cuplikan JSON berikut menunjukkan contoh respons yang mencantumkan status ekstensi yang diinstal pada instance:

{
  "kind": "compute#vmExtensionStatesList",
  "items": [
    {
      "name": "ops-agent",
      "version": "2.58.0",
      "healthStatus": "RUNNING",
      "enforcementState": "INSTALLED",
      "healthMsg": "Plugin is running ok",
      "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
    }
  ]
}

Melihat status ekstensi VM tertentu pada instance

Jika beberapa kebijakan menargetkan VM atau ekstensi yang diinstal tidak berjalan seperti yang diharapkan, lihat status ekstensi tertentu tersebut untuk melihat konfigurasi efektif akhir (policyId dan versi) serta pesan status diagnostiknya.

Untuk melihat status efektif dan kebijakan yang mengatur ekstensi VM tertentu pada instance, pilih salah satu opsi berikut:

gcloud

Untuk mengambil status efektif, versi aktif, dan kebijakan yang mengatur ekstensi VM tertentu pada instance, jalankan perintah gcloud beta compute instances get-vm-extension-state:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --extension-name=EXTENSION_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

Ganti variabel berikut dengan nilai untuk lingkungan Anda:

• INSTANCE_NAME: nama instance VM.
• EXTENSION_NAME: nama ekstensi yang ingin Anda periksa (misalnya, ops-agent).
• ZONE: zona tempat instance berada.
• PROJECT_ID: ID project Google Cloud Anda.

REST

Untuk mengambil status efektif, versi aktif, dan kebijakan yang mengatur ekstensi VM tertentu pada instance, kirim permintaan GET ke metode instances.getVmExtensionState:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates/EXTENSION_NAME

Ganti variabel berikut dengan nilai untuk lingkungan Anda:

• PROJECT_ID: ID project Google Cloud Anda.
• ZONE: zona tempat instance berada.
• INSTANCE_NAME: nama atau ID instance VM.
• EXTENSION_NAME: nama ekstensi VM (misalnya, ops-agent).

Cuplikan JSON berikut menunjukkan contoh respons untuk satu status ekstensi VM pada sebuah instance:

{
  "name": "ops-agent",
  "version": "2.58.0",
  "healthStatus": "RUNNING",
  "enforcementState": "INSTALLED",
  "enforcementMsg": "",
  "healthMsg": "Plugin is running ok",
  "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
}

Menafsirkan kolom status ekstensi VM

Saat Anda mengambil status ekstensi VM pada instance, responsnya mencakup kolom yang melaporkan kebijakan yang diterapkan, versi aktif, progres penginstalan, dan kondisi runtime plugin.

Tabel berikut menjelaskan kolom yang ditampilkan oleh resource VmExtensionState:

Kolom	Deskripsi
name	ID ekstensi VM (misalnya, ops-agent).
version	Versi aktif ekstensi yang diinstal di instance VM.
policyId	ID kebijakan ekstensi VM efektif yang menerapkan ekstensi ini pada instance. Jika beberapa kebijakan menargetkan VM, kolom ini menunjukkan kebijakan yang menang setelah penyelesaian prioritas.
enforcementState	Status siklus proses saat ini dari proses penegakan ekstensi. Nilai yang memungkinkan mencakup: ENFORCEMENT_STATE_UNSPECIFIED: Status penerapan tidak ditentukan. INSTALLING: Agen tamu sedang menginstal ekstensi. INSTALLED: Ekstensi diinstal pada instance. INSTALL_FAILED: Penginstalan gagal dan tidak ada revisi stabil sebelumnya yang tersedia untuk rollback. ROLLING_BACK: Agen tamu me-roll back ekstensi ke revisi stabil terakhir yang tercatat. ROLLED_BACK: Ekstensi di-roll back ke revisi stabil terakhir. ROLLBACK_FAILED: Upaya rollback gagal. INCOMPATIBLE: Tidak ada revisi yang tersedia untuk versi ekstensi yang kompatibel dengan sistem operasi atau arsitektur VM. REMOVING: Agen tamu menghapus ekstensi dari instance. SERVICE_DISABLED: API layanan yang diperlukan untuk ekstensi ini dinonaktifkan dalam project. APPLYING_CONFIG: Agen tamu sedang menerapkan konfigurasi baru ke ekstensi, yang mungkin melibatkan memulai ulang plugin.
enforcementMsg	Pesan status diagnostik yang ditampilkan agen tamu jika ekstensi gagal diterapkan atau mengalami error penginstalan.
healthStatus	Status respons runtime plugin ekstensi yang diterapkan. Jika ekstensi belum diterapkan, nilai ini tidak ditentukan. Nilai yang memungkinkan mencakup: HEALTH_STATUS_UNSPECIFIED: Status respons tidak ditentukan. STARTING: Proses ekstensi dimulai. RUNNING: Proses ekstensi berjalan normal. STOPPING: Proses ekstensi dihentikan. STOPPED: Proses ekstensi dihentikan. CRASHED: Proses ekstensi dimulai, tetapi tiba-tiba berhenti berjalan.
healthMsg	Pesan diagnostik yang dilaporkan ekstensi tentang status responsivitasnya (misalnya, Plugin is running ok).

Langkah berikutnya

• Untuk mendiagnosis peluncuran yang gagal, memeriksa proses tamu yang berjalan, atau memeriksa log debug agen tamu, lihat Memecahkan masalah ekstensi VM.
• Untuk mengkueri peristiwa penerapan historis dan mengaudit data penginstalan atau error di Cloud Logging, lihat Melihat log ekstensi VM.
• Untuk membuat dasbor Cloud Monitoring dan menyiapkan pemberitahuan untuk kondisi agen, penggunaan CPU, dan penggunaan memori, lihat Memantau ekstensi VM.
• Untuk mengubah setelan konfigurasi, mengubah versi yang disematkan, atau menghapus agen yang di-deploy, lihat Mengelola ekstensi VM menggunakan kebijakan ekstensi.