Mengganti, meniadakan, atau menghapus kebijakan penempatan

Dokumen ini menjelaskan cara mengelola kebijakan penempatan. Secara khusus:

Perbarui properti instance virtual machine (VM) yang menentukan kebijakan penempatan untuk melakukan salah satu hal berikut:
- Mengganti kebijakan penempatan dengan kebijakan penempatan lain yang sudah ada.
- Meniadakan kebijakan penempatan.
Menghapus kebijakan penempatan yang tidak diperlukan lagi.

Sebelum memulai

Tinjau batasan untuk kebijakan penempatan.
Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
gcloud
1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
  gcloud init
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
2. Menetapkan region dan zona default.
REST

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

Peran yang diperlukan

Agar mendapatkan izin yang diperlukan untuk mengganti, meniadakan, atau menghapus kebijakan penempatan, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk mengganti, meniadakan, atau menghapus kebijakan penempatan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengganti, meniadakan, atau menghapus kebijakan penempatan:

Untuk mengupdate properti VM: compute.instances.update pada project
Untuk menghapus kebijakan penempatan: compute.resourcePolicies.delete pada project

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran yang telah ditetapkan sebelumnya.

Mengganti kebijakan penempatan di VM

Anda dapat mengganti kebijakan penempatan yang ditentukan dalam VM dengan kebijakan penempatan lain menggunakan gcloud CLI dan REST.

gcloud

Untuk mengganti kebijakan penempatan di VM dengan kebijakan penempatan lain, ikuti langkah-langkah berikut:

Untuk mengekspor properti VM yang ada, gunakan perintah gcloud compute instances export.
```
gcloud compute instances export VM_NAME \
    --destination=FILE_PATH \
    --zone=ZONE
```
Ganti kode berikut:
- VM_NAME: nama VM yang ada, yang menentukan kebijakan penempatan.
- FILE_PATH: jalur tempat Anda ingin menyimpan file konfigurasi VM.
- ZONE: zona tempat VM berada.
Di editor teks pilihan Anda, buka file konfigurasi VM.
Untuk mengganti kebijakan penempatan dengan kebijakan lain yang sudah ada, ganti nilai di kolom resourcePolicies dengan kebijakan penempatan lain.
```
...
resourcePolicies:
- https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy
...
```
Anda juga dapat mengubah properti lain dari VM. Untuk mengetahui informasi selengkapnya, lihat Properti yang dapat Anda update.
Ikuti langkah-langkah selanjutnya di bagian Mengupdate properti VM.

REST

Untuk mengganti kebijakan penempatan di VM dengan kebijakan penempatan lain, ikuti langkah-langkah berikut:

Untuk mengekspor properti VM yang ada, buat permintaan GET ke metode instances.get.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
```
Ganti kode berikut:
- PROJECT_ID: ID project tempat VM berada.
- ZONE: zona tempat VM berada.
- VM_NAME: nama VM yang ada, yang menentukan kebijakan penempatan.
Untuk mengganti kebijakan penempatan dengan kebijakan lain yang sudah ada, ganti nilai di kolom resourcePolicies dengan kebijakan penempatan lain.
```
{
...
"resourcePolicies": [
  "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy"
],
...
}
```
Anda juga dapat mengubah properti lain dari VM. Untuk mengetahui informasi selengkapnya, lihat Properti yang dapat Anda update.
Ikuti langkah-langkah selanjutnya di bagian Mengupdate properti VM.

Meniadakan kebijakan penempatan di VM

Anda dapat menghapus kebijakan penempatan yang diterapkan ke VM menggunakan gcloud CLI dan REST.

gcloud

Untuk meniadakan kebijakan penempatan di VM, gunakan perintah gcloud compute instances remove-resource-policies.

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

Ganti kode berikut:

VM_NAME: nama VM yang ada, yang menentukan kebijakan penempatan.
POLICY_NAME: nama kebijakan penempatan yang diterapkan ke VM. Untuk memverifikasi nama kebijakan penempatan, lihat detail VM dan lihat kolom resourcePolicies.
ZONE: zona tempat VM berada.

REST

Untuk meniadakan kebijakan penempatan di VM, buat permintaan POST ke metode instances.removeResourcePolicies.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Ganti kode berikut:

PROJECT_ID: ID project tempat VM berada.
ZONE: zona tempat VM berada.
VM_NAME: nama VM yang ada, yang menentukan kebijakan penempatan.
REGION: region tempat kebijakan penempatan berada.
POLICY_NAME: nama kebijakan penempatan yang diterapkan ke VM. Untuk memverifikasi nama kebijakan penempatan, lihat detail VM dan lihat kolom resourcePolicies.

Menghapus kebijakan penempatan

Anda hanya dapat menghapus kebijakan penempatan jika tidak sedang diterapkan ke resource Compute Engine apa pun. Jika tidak, penghapusan kebijakan penempatan akan gagal. Jika Anda ingin menghapus kebijakan penempatan yang diterapkan ke resource Compute Engine, lakukan salah satu hal berikut:

Jika kebijakan ini hanya diterapkan ke VM dan Anda ingin mempertahankan VM, lakukan hal berikut:
1. Meniadakan kebijakan penempatan di VM.
2. Hapus kebijakan penempatan.
Jika tidak, lakukan yang berikut ini:
1. Opsional: Tiadakan kebijakan penempatan di VM yang ingin Anda pertahankan.
2. Hapus setiap resource Compute Engine lain tempat kebijakan penempatan diterapkan dengan urutan berikut:
  1. VM
  2. Pemesanan
  3. Template instance
3. Hapus kebijakan penempatan.

Anda dapat menghapus kebijakan penempatan menggunakan gcloud CLI dan REST.

gcloud

Untuk menghapus kebijakan penempatan, gunakan perintah gcloud compute resource-policies delete.

gcloud compute resource-policies delete POLICY_NAME \
    --region=REGION

Ganti kode berikut:

POLICY_NAME: nama kebijakan penempatan yang ada.
REGION: region tempat kebijakan penempatan berada.

REST

Untuk menghapus kebijakan penempatan, buat permintaan DELETE ke metode resourcePolicies.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

Ganti kode berikut:

PROJECT_ID: ID project tempat kebijakan penempatan berada.
REGION: region tempat kebijakan penempatan berada.
POLICY_NAME: nama kebijakan penempatan yang ada.

Apa langkah selanjutnya?

Pelajari cara melihat kebijakan penempatan.
Pelajari cara melakukan hal berikut dengan VM yang menentukan kebijakan penempatan:
- Melihat status VM.
- Menghubungkan ke VM.