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
-
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
- 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.
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
-
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 metodeinstances.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 kolomresourcePolicies
.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 kolomresourcePolicies
.
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:
Hapus kebijakan penempatan.
Jika tidak, lakukan yang berikut ini:
Opsional: Tiadakan kebijakan penempatan di VM yang ingin Anda pertahankan.
Hapus setiap resource Compute Engine lain tempat kebijakan penempatan diterapkan dengan urutan berikut:
VM
Pemesanan
Template instance
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: