Mengelola ekstensi VM menggunakan kebijakan ekstensi

VM Extension Manager menggunakan kebijakan ekstensi untuk mengelola ekstensi VM Anda dalam skala besar. Untuk mengetahui informasi selengkapnya, lihat Tentang VM Extension Manager. Dokumen ini menjelaskan cara memperbarui dan menghapus kebijakan ekstensi VM global dan zona di level project, atau di level folder dan organisasi (tersedia dalam Pratinjau). Untuk melihat kebijakan ekstensi, ekstensi dan versi VM, serta status ekstensi runtime pada instance VM, lihat Melihat detail dan status ekstensi VM. Untuk mendiagnosis masalah penginstalan atau runtime, lihat Memecahkan masalah ekstensi VM.

Batasan pengelolaan kebijakan

Anda hanya dapat memperbarui dan menghapus kebijakan ekstensi VM cakupan folder dan cakupan organisasi menggunakan Google Cloud CLI atau Compute Engine REST API. Anda tidak dapat mengelola kebijakan cakupan folder atau cakupan organisasi di konsolGoogle Cloud .

Mengubah ekstensi dengan memperbarui kebijakan ekstensi VM

Saat Anda mengupdate kebijakan, VM Extension Manager akan meluncurkan perubahan ke semua VM yang berlaku, biasanya dalam waktu satu menit. Jika Anda mengubah label penyertaan, ekstensi mungkin diinstal pada VM baru atau di-uninstal dari VM yang ada berdasarkan apakah ekstensi tersebut cocok dengan label yang diperbarui.

Mengubah ekstensi VM 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.

Izin IAM yang diperlukan

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

Peran yang telah ditetapkan ini berisi izin compute.orgVmExtensionPolicies.update, yang diperlukan untuk memperbarui kebijakan ekstensi cakupan organisasi.

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

Untuk memperbarui kebijakan ekstensi global cakupan organisasi, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute global-vm-extension-policies update dengan flag --organization untuk mengubah kebijakan ekstensi VM global yang ada dan tercakup dalam organisasi. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai pengganti lengkap. Setiap kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk memperbarui kebijakan ekstensi VM global cakupan organisasi, jalankan perintah berikut:

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• DESCRIPTION: deskripsi opsional untuk kebijakan.
• EXTENSION_NAME_1,EXTENSION_NAME_2: daftar ekstensi yang dipisahkan koma untuk ditambahkan ke kebijakan. Anda harus menentukan setidaknya satu ekstensi. Anda dapat menentukan salah satu ekstensi yang didukung berikut:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah versi ekstensi. Jika Anda tidak menentukan versi untuk ekstensi, VM Extension Manager akan menggunakan versi terbaru yang tersedia dan otomatis mengupgradenya saat versi baru tersedia.
  Catatan: Untuk ops-agent, VM Extension Manager mendukung penginstalan versi 2.58.0 atau yang lebih baru. Untuk google-cloud-sap-extension dan google-cloud-workload-extension, VM Extension Manager hanya mendukung versi terbaru.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah jalur ke file konfigurasi untuk ekstensi tersebut. File ini terletak di VM tempat Anda menjalankan perintah gcloud, bukan di VM tempat Anda menginstal ekstensi.

  Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file—misalnya, EXTENSION_NAME_1="CONFIG_1". Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.

• KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM di semua project dan zona turunan di bawah organisasi.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.
• ROLLOUT_PLAN: tentukan slow_rollout atau fast_rollout. Jika Anda perlu menggunakan rencana peluncuran kustom, tentukan flag --rollout-custom-plan, bukan --rollout-predefined-plan, menggunakan format berikut:

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ganti kode berikut:

  • ORGANIZATION_ID: organisasi tempat rencana peluncuran ditentukan.
  • ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan.

  Jika Anda tidak menentukan flag rencana peluncuran, VM Extension Manager akan menggunakan slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: menentukan perilaku saat VM Extension Manager mendeteksi konflik antara kebijakan zona dan kebijakan global. Anda dapat menentukan salah satu perilaku konflik berikut:
  • "" (string kosong): kebijakan global tidak menimpa kebijakan zona yang bertentangan dan memiliki nama yang sama. Perilaku konflik ini adalah default.
  • overwrite: kebijakan global akan menimpa kebijakan zona yang memiliki nama yang sama, lalu pengelola kebijakan global akan mengelola peluncuran kebijakan di zona tersebut.

  Untuk mengetahui informasi selengkapnya, lihat flag --rollout-conflict-behavior.

• RETRY_UUID: UUID yang mengidentifikasi upaya percobaan ulang untuk peluncuran update kebijakan. UUID ini memungkinkan Anda mencoba kembali update tanpa perubahan. Error akan terjadi jika Anda menetapkan flag ini dan kebijakan diubah. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

Contoh: Memperbarui kebijakan global cakupan organisasi

Perintah berikut memperbarui kebijakan prod-frontend-policy di organisasi 123456789 untuk menambahkan ekstensi google-cloud-workload-extension dan melepas pin ops-agent sehingga melacak versi terbaru menggunakan rencana peluncuran cepat:

gcloud preview compute global-vm-extension-policies update prod-frontend-policy \
  --organization=organizations/123456789 \
  --description="Updated policy: ops-agent + workload extension, unpinned" \
  --extensions=ops-agent,google-cloud-workload-extension \
  --config=ops-agent="updated-monitoring-config" \
  --inclusion-labels="env=prod,workload=frontend" \
  --priority=100 \
  --rollout-predefined-plan=fast_rollout

REST

Untuk memperbarui kebijakan ekstensi global cakupan organisasi, buat permintaan PATCH ke metode organizationGlobalVmExtensionPolicies.update. Saat memperbarui kebijakan menggunakan REST, Anda hanya perlu memberikan kolom yang ingin diperbarui. Kolom apa pun yang Anda hilangkan akan mempertahankan nilai yang ada.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• DESCRIPTION: deskripsi kebijakan ekstensi VM.
• EXTENSION_NAME: nama ekstensi yang akan diupdate, digunakan sebagai kunci dalam peta extensionPolicies. Untuk mengupdate beberapa ekstensi, sertakan beberapa entri dalam peta extensionPolicies.
• EXTENSION_NAME_VERSION: versi ekstensi VM.
• EXTENSION_NAME_CONFIG: setelan konfigurasi untuk ekstensi VM, sebagai string inline.
• KEY_1:VALUE_1, KEY_2:VALUE_2: key-value pair yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Untuk menentukan beberapa pemilih, sertakan beberapa objek dalam array instanceSelectors, masing-masing dengan kolom labelSelector. Dalam hal ini, VM Extension Manager menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghapus instanceSelectors, kebijakan akan menargetkan semua VM di semua project dan zona turunan dalam organisasi.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.
• ROLLOUT_CONFLICT_BEHAVIOR: menentukan perilaku saat VM Extension Manager mendeteksi konflik antara kebijakan zona dan kebijakan global. Anda dapat menentukan salah satu perilaku konflik berikut:
  • "" (string kosong): kebijakan global tidak menimpa kebijakan zona yang bertentangan dan memiliki nama yang sama. Perilaku konflik ini adalah default.
  • overwrite: kebijakan global akan menimpa kebijakan zona yang memiliki nama yang sama, lalu pengelola kebijakan global akan mengelola peluncuran kebijakan di zona tersebut.

  Untuk mengetahui informasi selengkapnya, lihat flag --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan. Untuk menggunakan rencana peluncuran yang telah ditentukan, ganti kolom name dengan predefinedRolloutPlan dan tentukan salah satu nilai berikut:
  • SLOW_ROLLOUT: meluncurkan kebijakan selama lima hari. Paket yang telah ditetapkan ini adalah rencana peluncuran default jika Anda tidak menentukan paket.
  • FAST_ROLLOUT: meluncurkan kebijakan segera ke semua zona.
• RETRY_UUID: UUID yang mengidentifikasi upaya percobaan ulang untuk peluncuran update kebijakan.

Mengubah ekstensi VM 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.

Izin IAM yang diperlukan

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

Peran bawaan ini berisi izin compute.folderVmExtensionPolicies.update, yang diperlukan untuk memperbarui kebijakan ekstensi cakupan folder.

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

Untuk memperbarui kebijakan ekstensi global cakupan folder, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute global-vm-extension-policies update dengan flag --folder untuk mengubah kebijakan ekstensi VM global yang ada dan tercakup dalam folder. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai pengganti lengkap. Setiap kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk memperbarui kebijakan ekstensi VM global cakupan folder, jalankan perintah berikut:

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• FOLDER_ID: ID folder Google Cloud Anda.
• DESCRIPTION: deskripsi opsional untuk kebijakan.
• EXTENSION_NAME_1,EXTENSION_NAME_2: daftar ekstensi yang dipisahkan koma untuk ditambahkan ke kebijakan. Anda harus menentukan setidaknya satu ekstensi. Anda dapat menentukan salah satu ekstensi yang didukung berikut:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah versi ekstensi. Jika Anda tidak menentukan versi untuk ekstensi, VM Extension Manager akan menggunakan versi terbaru yang tersedia dan otomatis mengupgradenya saat versi baru tersedia.
  Catatan: Untuk ops-agent, VM Extension Manager mendukung penginstalan versi 2.58.0 atau yang lebih baru. Untuk google-cloud-sap-extension dan google-cloud-workload-extension, VM Extension Manager hanya mendukung versi terbaru.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah jalur ke file konfigurasi untuk ekstensi tersebut. File ini terletak di VM tempat Anda menjalankan perintah gcloud, bukan di VM tempat Anda menginstal ekstensi.

  Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file—misalnya, EXTENSION_NAME_1="CONFIG_1". Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.

• KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM di semua project dan zona turunan dalam folder.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.
• ROLLOUT_PLAN: tentukan slow_rollout atau fast_rollout. Jika Anda perlu menggunakan rencana peluncuran kustom, tentukan flag --rollout-custom-plan, bukan --rollout-predefined-plan, menggunakan format berikut:

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ganti kode berikut:

  • FOLDER_ID: folder tempat rencana peluncuran ditentukan.
  • ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan.

  Jika Anda tidak menentukan flag rencana peluncuran, VM Extension Manager akan menggunakan slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: menentukan perilaku saat VM Extension Manager mendeteksi konflik antara kebijakan zona dan kebijakan global. Anda dapat menentukan salah satu perilaku konflik berikut:
  • "" (string kosong): kebijakan global tidak menimpa kebijakan zona yang bertentangan dan memiliki nama yang sama. Perilaku konflik ini adalah default.
  • overwrite: kebijakan global akan menimpa kebijakan zona yang memiliki nama yang sama, lalu pengelola kebijakan global akan mengelola peluncuran kebijakan di zona tersebut.

  Untuk mengetahui informasi selengkapnya, lihat flag --rollout-conflict-behavior.

• RETRY_UUID: UUID yang mengidentifikasi upaya percobaan ulang untuk peluncuran update kebijakan. UUID ini memungkinkan Anda mencoba kembali update tanpa perubahan. Error akan terjadi jika Anda menetapkan flag ini dan kebijakan diubah. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

REST

Untuk memperbarui kebijakan ekstensi global cakupan folder, buat permintaan PATCH ke metode folderGlobalVmExtensionPolicies.update. Saat memperbarui kebijakan menggunakan REST, Anda hanya perlu memberikan kolom yang ingin diperbarui. Kolom apa pun yang Anda hilangkan akan mempertahankan nilai yang ada.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• DESCRIPTION: deskripsi kebijakan ekstensi VM.
• EXTENSION_NAME: nama ekstensi yang akan diupdate, digunakan sebagai kunci dalam peta extensionPolicies. Untuk mengupdate beberapa ekstensi, sertakan beberapa entri dalam peta extensionPolicies.
• EXTENSION_NAME_VERSION: versi ekstensi VM.
• EXTENSION_NAME_CONFIG: setelan konfigurasi untuk ekstensi VM, sebagai string inline.
• KEY_1:VALUE_1, KEY_2:VALUE_2: key-value pair yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Untuk menentukan beberapa pemilih, sertakan beberapa objek dalam array instanceSelectors, masing-masing dengan kolom labelSelector. Dalam hal ini, VM Extension Manager menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan instanceSelectors, kebijakan akan menargetkan semua VM di semua project dan zona turunan dalam folder.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.
• ROLLOUT_CONFLICT_BEHAVIOR: menentukan perilaku saat VM Extension Manager mendeteksi konflik antara kebijakan zona dan kebijakan global. Anda dapat menentukan salah satu perilaku konflik berikut:
  • "" (string kosong): kebijakan global tidak menimpa kebijakan zona yang bertentangan dan memiliki nama yang sama. Perilaku konflik ini adalah default.
  • overwrite: kebijakan global akan menimpa kebijakan zona yang memiliki nama yang sama, lalu pengelola kebijakan global akan mengelola peluncuran kebijakan di zona tersebut.

  Untuk mengetahui informasi selengkapnya, lihat flag --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan. Untuk menggunakan rencana peluncuran yang telah ditentukan, ganti kolom name dengan predefinedRolloutPlan dan tentukan salah satu nilai berikut:
  • SLOW_ROLLOUT: meluncurkan kebijakan selama lima hari. Paket yang telah ditetapkan ini adalah rencana peluncuran default jika Anda tidak menentukan paket.
  • FAST_ROLLOUT: meluncurkan kebijakan segera ke semua zona.
• RETRY_UUID: UUID yang mengidentifikasi upaya percobaan ulang untuk peluncuran update kebijakan.

Mengubah ekstensi VM di semua zona dalam project

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk memperbarui kebijakan ekstensi cakupan project, minta administrator untuk memberi Anda peran IAM 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 compute.vmExtensionPolicies.update, yang diperlukan untuk memperbarui kebijakan ekstensi cakupan project.

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

Untuk memperbarui kebijakan ekstensi global cakupan project, pilih salah satu opsi berikut:

Konsol

Untuk memperbarui kebijakan ekstensi VM global cakupan project di konsol Google Cloud , selesaikan langkah-langkah berikut:

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

   Buka VM extension policies

2. Klik Kebijakan global, lalu pilih kebijakan yang ingin Anda edit.
3. Klik Edit.
4. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antar-kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1.000.
5. Di bagian Manage extensions, lakukan hal berikut:
   • Untuk menambahkan ekstensi lainnya, klik Tambahkan ekstensi, lalu pilih ekstensi dan versi.
   • Untuk menghapus ekstensi yang dikelola oleh kebijakan ini, klik tombol Hapus di samping nama ekstensi.
6. Jika Anda ingin menerapkan label, tambahkan label untuk VM target di bagian Target VM instances.
7. Klik Simpan.

Catatan: Konsol Google Cloud tidak mendukung pengeditan peluncuran. Untuk mengedit peluncuran, gunakan gcloud CLI atau REST API.

gcloud

Gunakan perintah gcloud compute global-vm-extension-policies update untuk mengubah kebijakan ekstensi VM global yang sudah ada dan tercakup dalam project. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai pengganti lengkap. Setiap kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk memperbarui kebijakan ekstensi VM global cakupan project, jalankan perintah berikut:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• PROJECT_ID: Project ID Google Cloud Anda.
• DESCRIPTION: deskripsi opsional untuk kebijakan.
• EXTENSION_NAME_1,EXTENSION_NAME_2: daftar ekstensi yang dipisahkan koma untuk ditambahkan ke kebijakan. Anda harus menentukan setidaknya satu ekstensi. Anda dapat menentukan salah satu ekstensi yang didukung berikut:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah versi ekstensi. Jika Anda tidak menentukan versi untuk ekstensi, VM Extension Manager akan menggunakan versi terbaru yang tersedia dan otomatis mengupgradenya saat versi baru tersedia.
  Catatan: Untuk ops-agent, VM Extension Manager mendukung penginstalan versi 2.58.0 atau yang lebih baru. Untuk google-cloud-sap-extension dan google-cloud-workload-extension, VM Extension Manager hanya mendukung versi terbaru.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah jalur ke file konfigurasi untuk ekstensi tersebut. File ini terletak di VM tempat Anda menjalankan perintah gcloud, bukan di VM tempat Anda menginstal ekstensi.

  Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file—misalnya, EXTENSION_NAME_1="CONFIG_1". Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.

• KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghapus flag ini, kebijakan akan menargetkan semua VM di semua zona dalam project.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.
• ROLLOUT_PLAN: tentukan slow_rollout atau fast_rollout. Jika Anda perlu menggunakan rencana peluncuran kustom, tentukan flag --rollout-custom-plan, bukan --rollout-predefined-plan, menggunakan format berikut:

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ganti kode berikut:

  • PROJECT_NUMBER: project tempat rencana peluncuran ditentukan.
  • ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan.

  Jika Anda tidak menentukan flag rencana peluncuran, VM Extension Manager akan menggunakan slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: menentukan perilaku saat VM Extension Manager mendeteksi konflik antara kebijakan zona dan kebijakan global. Anda dapat menentukan salah satu perilaku konflik berikut:
  • "" (string kosong): kebijakan global tidak menimpa kebijakan zona yang bertentangan dan memiliki nama yang sama. Perilaku konflik ini adalah default.
  • overwrite: kebijakan global akan menimpa kebijakan zona yang memiliki nama yang sama, lalu pengelola kebijakan global akan mengelola peluncuran kebijakan di zona tersebut.

  Untuk mengetahui informasi selengkapnya, lihat flag --rollout-conflict-behavior.

• RETRY_UUID: UUID yang mengidentifikasi upaya percobaan ulang untuk peluncuran update kebijakan. UUID ini memungkinkan Anda mencoba kembali update tanpa perubahan. Error akan terjadi jika Anda menetapkan flag ini dan kebijakan diubah. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

REST

Untuk memperbarui kebijakan ekstensi global cakupan project, buat permintaan PATCH ke metode globalVmExtensionPolicies.update. Saat memperbarui kebijakan menggunakan REST, Anda hanya perlu memberikan kolom yang ingin diperbarui. Kolom apa pun yang Anda hilangkan akan mempertahankan nilai yang ada.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Ganti kode berikut:

• PROJECT_ID: Project ID Google Cloud Anda.
• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• DESCRIPTION: deskripsi kebijakan ekstensi VM.
• EXTENSION_NAME: nama ekstensi yang akan diupdate, digunakan sebagai kunci dalam peta extensionPolicies. Untuk mengupdate beberapa ekstensi, sertakan beberapa entri dalam peta extensionPolicies.
• EXTENSION_NAME_VERSION: versi ekstensi VM.
• EXTENSION_NAME_CONFIG: setelan konfigurasi untuk ekstensi VM, sebagai string inline.
• KEY_1:VALUE_1, KEY_2:VALUE_2: key-value pair yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Untuk menentukan beberapa pemilih, sertakan beberapa objek dalam array instanceSelectors, masing-masing dengan kolom labelSelector. Dalam hal ini, VM Extension Manager menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghapus instanceSelectors, kebijakan akan menargetkan semua VM di semua zona dalam project.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.
• ROLLOUT_CONFLICT_BEHAVIOR: menentukan perilaku saat VM Extension Manager mendeteksi konflik antara kebijakan zona dan kebijakan global. Anda dapat menentukan salah satu perilaku konflik berikut:
  • "" (string kosong): kebijakan global tidak menimpa kebijakan zona yang bertentangan dan memiliki nama yang sama. Perilaku konflik ini adalah default.
  • overwrite: kebijakan global akan menimpa kebijakan zona yang memiliki nama yang sama, lalu pengelola kebijakan global akan mengelola peluncuran kebijakan di zona tersebut.

  Untuk mengetahui informasi selengkapnya, lihat flag --rollout-conflict-behavior.

• PROJECT_NUMBER: project tempat rencana peluncuran kustom ditentukan.
• ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan. Untuk menggunakan rencana peluncuran yang telah ditentukan, ganti kolom name dengan predefinedRolloutPlan dan tentukan salah satu nilai berikut:
  • SLOW_ROLLOUT: meluncurkan kebijakan selama lima hari. Paket yang telah ditetapkan ini adalah rencana peluncuran default jika Anda tidak menentukan paket.
  • FAST_ROLLOUT: meluncurkan kebijakan segera ke semua zona.
• RETRY_UUID: UUID yang mengidentifikasi upaya percobaan ulang untuk peluncuran update kebijakan.

Mengubah ekstensi VM di 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.

Izin IAM yang diperlukan

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

Peran yang telah ditetapkan ini berisi izin compute.orgVmExtensionPolicies.update, yang diperlukan untuk memperbarui kebijakan ekstensi cakupan organisasi.

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

Untuk memperbarui kebijakan ekstensi zona lingkup organisasi, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute zone-vm-extension-policies update dengan flag --organization untuk mengubah kebijakan ekstensi VM zona yang ada dalam cakupan organisasi. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan tersebut akan bertindak sebagai pengganti lengkap. Bidang opsional yang Anda hilangkan akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk memperbarui kebijakan ekstensi VM zona cakupan organisasi, jalankan perintah berikut:

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan diterapkan.
• DESCRIPTION: deskripsi opsional untuk kebijakan.
• EXTENSION_NAME_1,EXTENSION_NAME_2: daftar ekstensi yang dipisahkan koma untuk ditambahkan ke kebijakan. Anda harus menentukan setidaknya satu ekstensi. Anda dapat menentukan salah satu ekstensi yang didukung berikut:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah versi ekstensi. Jika Anda tidak menentukan versi untuk ekstensi, VM Extension Manager akan menggunakan versi terbaru yang tersedia dan otomatis mengupgradenya saat versi baru tersedia.
  Catatan: Untuk ops-agent, VM Extension Manager mendukung penginstalan versi 2.58.0 atau yang lebih baru. Untuk google-cloud-sap-extension dan google-cloud-workload-extension, VM Extension Manager hanya mendukung versi terbaru.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah jalur ke file konfigurasi untuk ekstensi tersebut. File ini terletak di VM tempat Anda menjalankan perintah gcloud, bukan di VM tempat Anda menginstal ekstensi.

  Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file—misalnya, EXTENSION_NAME_1="CONFIG_1". Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.

• KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM di zona yang ditentukan di semua project turunan dalam organisasi.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.

REST

Untuk memperbarui kebijakan ekstensi zona cakupan organisasi, buat permintaan PATCH ke metode organizationZoneVmExtensionPolicies.update. Saat memperbarui kebijakan menggunakan REST, Anda hanya perlu memberikan kolom yang ingin diperbarui. Kolom apa pun yang Anda hilangkan akan mempertahankan nilai yang ada.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Ganti kode berikut:

• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.
• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• DESCRIPTION: deskripsi kebijakan ekstensi VM.
• EXTENSION_NAME: nama ekstensi yang akan diupdate, digunakan sebagai kunci dalam peta extensionPolicies. Untuk mengupdate beberapa ekstensi, sertakan beberapa entri dalam peta extensionPolicies.
• EXTENSION_NAME_VERSION: versi ekstensi VM.
• EXTENSION_NAME_CONFIG: setelan konfigurasi untuk ekstensi VM, sebagai string inline.
• KEY_1:VALUE_1, KEY_2:VALUE_2: key-value pair yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Untuk menentukan beberapa pemilih, sertakan beberapa objek dalam array instanceSelectors, masing-masing dengan kolom labelSelector. Dalam hal ini, VM Extension Manager menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghapus instanceSelectors, kebijakan akan menargetkan semua VM di zona yang ditentukan di semua project turunan dalam organisasi.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.

Mengubah ekstensi VM di 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.

Izin IAM yang diperlukan

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

Peran bawaan ini berisi izin compute.folderVmExtensionPolicies.update, yang diperlukan untuk memperbarui kebijakan ekstensi cakupan folder.

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

Untuk memperbarui kebijakan ekstensi zona cakupan folder, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute zone-vm-extension-policies update dengan flag --folder untuk mengubah kebijakan ekstensi VM zona yang ada dan tercakup dalam folder. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan tersebut akan bertindak sebagai pengganti lengkap. Bidang opsional yang Anda hilangkan akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk memperbarui kebijakan ekstensi VM zona cakupan folder, jalankan perintah berikut:

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan diterapkan.
• DESCRIPTION: deskripsi opsional untuk kebijakan.
• EXTENSION_NAME_1,EXTENSION_NAME_2: daftar ekstensi yang dipisahkan koma untuk ditambahkan ke kebijakan. Anda harus menentukan setidaknya satu ekstensi. Anda dapat menentukan salah satu ekstensi yang didukung berikut:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah versi ekstensi. Jika Anda tidak menentukan versi untuk ekstensi, VM Extension Manager akan menggunakan versi terbaru yang tersedia dan otomatis mengupgradenya saat versi baru tersedia.
  Catatan: Untuk ops-agent, VM Extension Manager mendukung penginstalan versi 2.58.0 atau yang lebih baru. Untuk google-cloud-sap-extension dan google-cloud-workload-extension, VM Extension Manager hanya mendukung versi terbaru.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah jalur ke file konfigurasi untuk ekstensi tersebut. File ini terletak di VM tempat Anda menjalankan perintah gcloud, bukan di VM tempat Anda menginstal ekstensi.

  Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file—misalnya, EXTENSION_NAME_1="CONFIG_1". Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.

• KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM di zona yang ditentukan di semua project turunan dalam folder.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.

REST

Untuk memperbarui kebijakan ekstensi zona cakupan folder, buat permintaan PATCH ke metode folderZoneVmExtensionPolicies.update. Saat memperbarui kebijakan menggunakan REST, Anda hanya perlu memberikan kolom yang ingin diperbarui. Kolom apa pun yang Anda hilangkan akan mempertahankan nilai yang ada.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Ganti kode berikut:

• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.
• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• DESCRIPTION: deskripsi kebijakan ekstensi VM.
• EXTENSION_NAME: nama ekstensi yang akan diupdate, digunakan sebagai kunci dalam peta extensionPolicies. Untuk mengupdate beberapa ekstensi, sertakan beberapa entri dalam peta extensionPolicies.
• EXTENSION_NAME_VERSION: versi ekstensi VM.
• EXTENSION_NAME_CONFIG: setelan konfigurasi untuk ekstensi VM, sebagai string inline.
• KEY_1:VALUE_1, KEY_2:VALUE_2: key-value pair yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Untuk menentukan beberapa pemilih, sertakan beberapa objek dalam array instanceSelectors, masing-masing dengan kolom labelSelector. Dalam hal ini, VM Extension Manager menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghapus instanceSelectors, kebijakan akan menargetkan semua VM di zona yang ditentukan di semua project turunan dalam folder.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.

Mengubah ekstensi VM di zona dalam project

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk memperbarui kebijakan ekstensi cakupan project, minta administrator untuk memberi Anda peran IAM 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 compute.vmExtensionPolicies.update, yang diperlukan untuk memperbarui kebijakan ekstensi cakupan project.

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

Untuk memperbarui kebijakan ekstensi zona cakupan project, pilih salah satu opsi berikut:

Konsol

Untuk memperbarui kebijakan ekstensi VM zona cakupan project di konsol Google Cloud , selesaikan langkah-langkah berikut:

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

   Buka VM extension policies

2. Pilih kebijakan yang ingin Anda perbarui.
3. Klik Edit.
4. Ubah Description, Priority, Extensions, atau Target VM instances.
5. Klik Simpan.

gcloud

Gunakan perintah gcloud compute zone-vm-extension-policies update untuk mengubah kebijakan ekstensi VM zona yang ada dalam cakupan project. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan tersebut akan bertindak sebagai pengganti lengkap. Bidang opsional yang Anda hilangkan akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk memperbarui kebijakan ekstensi VM zona cakupan project, jalankan perintah berikut:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• PROJECT_ID: Project ID Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan diterapkan.
• DESCRIPTION: deskripsi opsional untuk kebijakan.
• EXTENSION_NAME_1,EXTENSION_NAME_2: daftar ekstensi yang dipisahkan koma untuk ditambahkan ke kebijakan. Anda harus menentukan setidaknya satu ekstensi. Anda dapat menentukan salah satu ekstensi yang didukung berikut:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah versi ekstensi. Jika Anda tidak menentukan versi untuk ekstensi, VM Extension Manager akan menggunakan versi terbaru yang tersedia dan otomatis mengupgradenya saat versi baru tersedia.
  Catatan: Untuk ops-agent, VM Extension Manager mendukung penginstalan versi 2.58.0 atau yang lebih baru. Untuk google-cloud-sap-extension dan google-cloud-workload-extension, VM Extension Manager hanya mendukung versi terbaru.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: daftar key-value pair yang dipisahkan koma, dengan kunci adalah nama ekstensi dan nilai adalah jalur ke file konfigurasi untuk ekstensi tersebut. File ini terletak di VM tempat Anda menjalankan perintah gcloud, bukan di VM tempat Anda menginstal ekstensi.

  Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file—misalnya, EXTENSION_NAME_1="CONFIG_1". Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.

• KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM di zona yang ditentukan dalam project Anda.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.

REST

Untuk memperbarui kebijakan ekstensi zona cakupan project, buat permintaan PATCH ke metode zoneVmExtensionPolicies.update. Saat memperbarui kebijakan menggunakan REST, Anda hanya perlu memberikan kolom yang ingin diperbarui. Kolom apa pun yang Anda hilangkan akan mempertahankan nilai yang ada.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Ganti kode berikut:

• PROJECT_ID: Project ID Google Cloud Anda.
• ZONE: Google Cloud zona tempat kebijakan ekstensi VM berada.
• POLICY_NAME: nama kebijakan ekstensi VM yang akan diupdate.
• DESCRIPTION: deskripsi kebijakan ekstensi VM.
• EXTENSION_NAME: nama ekstensi yang akan diupdate, digunakan sebagai kunci dalam peta extensionPolicies. Untuk mengupdate beberapa ekstensi, sertakan beberapa entri dalam peta extensionPolicies.
• EXTENSION_NAME_VERSION: versi ekstensi VM.
• EXTENSION_NAME_CONFIG: setelan konfigurasi untuk ekstensi VM, sebagai string inline.
• KEY_1:VALUE_1, KEY_2:VALUE_2: key-value pair yang menentukan label penyertaan untuk pemilih. VM harus memiliki semua label yang ditentukan dalam pemilih yang akan ditargetkan. Untuk menentukan beberapa pemilih, sertakan beberapa objek dalam array instanceSelectors, masing-masing dengan kolom labelSelector. Dalam hal ini, VM Extension Manager menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan instanceSelectors, kebijakan akan menargetkan semua VM di zona yang ditentukan dalam project Anda.
• PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Jika beberapa kebijakan memiliki prioritas yang sama, VM Extension Manager akan menerapkan kebijakan yang paling baru diupdate ke VM.

Meng-uninstal ekstensi dengan menghapus kebijakan ekstensi VM

Saat Anda menghapus kebijakan, VM Extension Manager akan meng-uninstal ekstensi dari VM mana pun yang dikelola oleh kebijakan tersebut. Namun, jika kebijakan aktif lain dengan prioritas lebih rendah berlaku untuk VM dan mendeklarasikan ekstensi yang sama, ekstensi tersebut akan tetap diinstal di VM tersebut berdasarkan kebijakan dengan prioritas lebih rendah.

VM Extension Manager menghapus ekstensi dari semua VM yang dapat diakses dalam waktu satu menit setelah penghapusan kebijakan. Jika VM tidak dapat diakses karena agen tamu dihapus atau VM dihapus, VM Extension Manager akan melewati penghapusan ekstensi. Jika VM tersebut tersedia kembali, VM Extension Manager akan menghapus ekstensi pada saat itu.

Meng-uninstal ekstensi VM 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.

Izin IAM yang diperlukan

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

Peran yang telah ditetapkan ini berisi izin compute.orgVmExtensionPolicies.delete, yang diperlukan untuk menghapus kebijakan ekstensi cakupan organisasi.

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

Untuk menghapus kebijakan ekstensi global cakupan organisasi, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute global-vm-extension-policies delete dengan flag --organization untuk menghapus kebijakan ekstensi VM global khusus organisasi yang ada:

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ROLLOUT_PLAN: tentukan slow_rollout atau fast_rollout. Jika Anda perlu menggunakan rencana peluncuran kustom, tentukan flag --rollout-custom-plan, bukan --rollout-predefined-plan, menggunakan format berikut:

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ganti kode berikut:

  • ORGANIZATION_ID: organisasi tempat rencana peluncuran ditentukan.
  • ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan.

  Jika Anda tidak menentukan flag rencana peluncuran, VM Extension Manager akan menggunakan slow_rollout.

• RETRY_UUID: UUID untuk mencoba kembali menghapus kebijakan ekstensi. Tetapkan kolom ini hanya saat mencoba ulang permintaan penghapusan untuk kebijakan yang ada dan dalam status DELETING. Menetapkan kolom ini saat kebijakan tidak dalam status DELETING akan menyebabkan error. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

REST

Untuk menghapus kebijakan ekstensi global cakupan organisasi, buat permintaan POST ke metode organizationGlobalVmExtensionPolicies.delete.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ROLLOUT_PLAN: tentukan SLOW_ROLLOUT atau FAST_ROLLOUT. Untuk menggunakan rencana peluncuran kustom, ganti predefinedRolloutPlan dengan "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID: UUID untuk mencoba kembali menghapus kebijakan ekstensi. Tetapkan kolom ini hanya saat mencoba ulang permintaan penghapusan untuk kebijakan yang ada dan dalam status DELETING. Menetapkan kolom ini saat kebijakan tidak dalam status DELETING akan menyebabkan error. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

Meng-uninstal ekstensi VM 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.

Izin IAM yang diperlukan

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

Peran bawaan ini berisi izin compute.folderVmExtensionPolicies.delete, yang diperlukan untuk menghapus kebijakan ekstensi cakupan folder.

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

Untuk menghapus kebijakan ekstensi global cakupan folder, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute global-vm-extension-policies delete dengan flag --folder untuk menghapus kebijakan ekstensi VM global yang ada dan tercakup dalam folder:

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
• FOLDER_ID: ID folder Google Cloud Anda.
• ROLLOUT_PLAN: tentukan slow_rollout atau fast_rollout. Jika Anda perlu menggunakan rencana peluncuran kustom, tentukan flag --rollout-custom-plan, bukan --rollout-predefined-plan, menggunakan format berikut:

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ganti kode berikut:

  • FOLDER_ID: folder tempat rencana peluncuran ditentukan.
  • ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan.

  Jika Anda tidak menentukan flag rencana peluncuran, VM Extension Manager akan menggunakan slow_rollout.

• RETRY_UUID: UUID untuk mencoba kembali menghapus kebijakan ekstensi. Tetapkan kolom ini hanya saat mencoba ulang permintaan penghapusan untuk kebijakan yang ada dan dalam status DELETING. Menetapkan kolom ini saat kebijakan tidak dalam status DELETING akan menyebabkan error. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

REST

Untuk menghapus kebijakan ekstensi global cakupan folder, buat permintaan POST ke metode folderGlobalVmExtensionPolicies.delete.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
• FOLDER_ID: ID folder Google Cloud Anda.
• ROLLOUT_PLAN: tentukan SLOW_ROLLOUT atau FAST_ROLLOUT. Untuk menggunakan rencana peluncuran kustom, ganti predefinedRolloutPlan dengan "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID: UUID untuk mencoba kembali menghapus kebijakan ekstensi. Tetapkan kolom ini hanya saat mencoba ulang permintaan penghapusan untuk kebijakan yang ada dan dalam status DELETING. Menetapkan kolom ini saat kebijakan tidak dalam status DELETING akan menyebabkan error. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

Meng-uninstal ekstensi VM di semua zona dalam project

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menghapus kebijakan ekstensi cakupan project, minta administrator untuk memberi Anda peran IAM 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 compute.vmExtensionPolicies.delete, yang diperlukan untuk menghapus kebijakan ekstensi cakupan project.

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

Untuk menghapus kebijakan ekstensi global cakupan project, pilih salah satu opsi berikut:

Konsol

Untuk menghapus kebijakan ekstensi VM global cakupan project di 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, lalu pilih kebijakan yang ingin Anda hapus.
3. Klik Hapus.
4. Dalam dialog konfirmasi, masukkan nama kebijakan, lalu klik Delete.

gcloud

Gunakan perintah gcloud compute global-vm-extension-policies delete untuk menghapus kebijakan ekstensi VM global yang ada dan tercakup dalam project:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
• PROJECT_ID: ID project Google Cloud Anda.
• ROLLOUT_PLAN: tentukan slow_rollout atau fast_rollout. Jika Anda perlu menggunakan rencana peluncuran kustom, tentukan flag --rollout-custom-plan, bukan --rollout-predefined-plan, menggunakan format berikut:

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Ganti kode berikut:

  • PROJECT_NUMBER: project tempat rencana peluncuran ditentukan.
  • ROLLOUT_PLAN_NAME: nama rencana peluncuran kustom yang Anda tentukan.

  Jika Anda tidak menentukan flag rencana peluncuran, VM Extension Manager akan menggunakan slow_rollout.

• RETRY_UUID: UUID untuk mencoba kembali menghapus kebijakan ekstensi. Tetapkan kolom ini hanya saat mencoba ulang permintaan penghapusan untuk kebijakan yang ada dan dalam status DELETING. Menetapkan kolom ini saat kebijakan tidak dalam status DELETING akan menyebabkan error. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

REST

Untuk menghapus kebijakan ekstensi global cakupan project, buat permintaan POST ke metode globalVmExtensionPolicies.delete.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Ganti kode berikut:

• POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda hapus.
• PROJECT_ID: Project ID Google Cloud Anda.
• ROLLOUT_PLAN: tentukan SLOW_ROLLOUT atau FAST_ROLLOUT. Untuk menggunakan rencana peluncuran kustom, ganti predefinedRolloutPlan dengan "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID: UUID untuk mencoba kembali menghapus kebijakan ekstensi. Tetapkan kolom ini hanya saat mencoba ulang permintaan penghapusan untuk kebijakan yang ada dan dalam status DELETING. Menetapkan kolom ini saat kebijakan tidak dalam status DELETING akan menyebabkan error. Untuk mengetahui informasi selengkapnya, lihat Mencoba kembali peluncuran.

Meng-uninstal ekstensi VM di 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.

Izin IAM yang diperlukan

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

Peran yang telah ditetapkan ini berisi izin compute.orgVmExtensionPolicies.delete, yang diperlukan untuk menghapus kebijakan ekstensi cakupan organisasi.

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

Untuk menghapus kebijakan ekstensi zona yang tercakup dalam organisasi, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute zone-vm-extension-policies delete dengan flag --organization untuk menghapus kebijakan ekstensi VM zona yang ada dan tercakup dalam organisasi:

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

Ganti kode berikut:

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

REST

Untuk menghapus kebijakan ekstensi zona cakupan organisasi, buat permintaan DELETE ke metode organizationZoneVmExtensionPolicies.delete.

DELETE 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 hapus.
• ORGANIZATION_ID: ID organisasi Google Cloud Anda.
• ZONE: zona Google Cloud tempat kebijakan berada.

Meng-uninstal ekstensi VM di 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.

Izin IAM yang diperlukan

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

Peran bawaan ini berisi izin compute.folderVmExtensionPolicies.delete, yang diperlukan untuk menghapus kebijakan ekstensi cakupan folder.

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

Untuk menghapus kebijakan ekstensi zona cakupan folder, pilih salah satu opsi berikut:

gcloud

Gunakan perintah gcloud preview compute zone-vm-extension-policies delete dengan flag --folder untuk menghapus kebijakan ekstensi VM zona yang ada dan tercakup dalam folder:

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

Ganti kode berikut:

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

REST

Untuk menghapus kebijakan ekstensi zona cakupan folder, buat permintaan DELETE ke metode folderZoneVmExtensionPolicies.delete.

DELETE 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 hapus.
• FOLDER_ID: ID folder Google Cloud Anda.
• ZONE: zona Google Cloud tempat kebijakan berada.

Meng-uninstal ekstensi VM di zona dalam project

Izin IAM yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menghapus kebijakan ekstensi cakupan project, minta administrator untuk memberi Anda peran IAM 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 compute.vmExtensionPolicies.delete, yang diperlukan untuk menghapus kebijakan ekstensi cakupan project.

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

Untuk menghapus kebijakan ekstensi zona cakupan project, pilih salah satu opsi berikut:

Konsol

Untuk menghapus kebijakan ekstensi VM zona cakupan project di konsol Google Cloud , selesaikan langkah-langkah berikut:

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

   Buka VM extension policies

2. Pilih kebijakan yang ingin Anda hapus.
3. Klik Hapus.
4. Pada dialog konfirmasi, klik Delete.

gcloud

Gunakan perintah gcloud compute zone-vm-extension-policies delete untuk menghapus kebijakan ekstensi VM zona yang tercakup dalam project yang ada:

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

Ganti kode berikut:

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

REST

Untuk menghapus kebijakan ekstensi zona cakupan project, buat permintaan DELETE ke metode zoneVmExtensionPolicies.delete.

DELETE 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 hapus.
• PROJECT_ID: Project ID Google Cloud Anda.
• ZONE: zona Google Cloud tempat kebijakan berada.

Langkah berikutnya

• Untuk memeriksa progres peluncuran dan status respons ekstensi, lihat Melihat detail dan status ekstensi VM.
• Untuk mendiagnosis peluncuran yang gagal, memeriksa proses tamu yang berjalan, atau memeriksa log debug agen tamu, lihat Memecahkan masalah ekstensi VM.
• Untuk membuat dasbor Cloud Monitoring dan menyiapkan pemberitahuan untuk kondisi agen, penggunaan CPU, dan penggunaan memori, lihat Memantau ekstensi VM.
• Untuk mengkueri peristiwa penerapan historis dan mengaudit data penginstalan atau error di Cloud Logging, lihat Melihat log ekstensi VM.