Dokumen ini menjelaskan cara melihat kebijakan penempatan.
Melihat kebijakan penempatan berguna untuk melihat semua kebijakan penempatan yang ada dalam project, atau memverifikasi detail konfigurasi kebijakan penempatan tertentu.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
Select the tab for how you plan to use the samples on this page:
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.
-
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna melihat kebijakan penempatan,
minta administrator untuk memberi Anda
peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1
) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk melihat kebijakan penempatan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk melihat kebijakan penempatan:
-
Untuk melihat daftar kebijakan penempatan Anda:
compute.resourcePolicies.list
on the project -
Untuk melihat detail kebijakan penempatan:
compute.resourcePolicies.get
on the project
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Melihat kebijakan penempatan Anda
Untuk melihat kebijakan penempatan yang tersedia dalam project, pilih salah satu metode berikut yang dijelaskan dalam dokumen ini:
Untuk melihat semua kebijakan penempatan yang ada dalam project, lihat daftar kebijakan penempatan Anda.
Untuk melihat detail konfigurasi kebijakan penempatan, lihat detail kebijakan penempatan.
Melihat daftar kebijakan penempatan Anda
Untuk melihat daftar semua kebijakan penempatan di project Anda, pilih salah satu opsi berikut:
Untuk melihat daftar kebijakan penempatan, gunakan
perintah gcloud compute resource-policies list
dengan flag --filter
ditetapkan ke groupPlacementPolicy:*
.
gcloud compute resource-policies list \
--filter="groupPlacementPolicy:*"
Outputnya mirip dengan hal berikut ini:
NAME: example-compact-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00
NAME: example-spread-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-07:00
Untuk informasi selengkapnya tentang penggunaan ekspresi filter untuk mempersempit daftar resource Compute Engine, lihat perintah gcloud topic filters
.
Untuk melihat daftar kebijakan penempatan yang berlokasi di region tertentu, buat permintaan GET
ke metode resourcePolicies.list
.
Di URL permintaan, sertakan parameter kueri filter
dan tetapkan ke
groupPlacementPolicy%3A*
.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /regions/REGION /resourcePolicies?filter=groupPlacementPolicy%3A*
Ganti kode berikut:
PROJECT_ID
: ID project tempat Anda ingin melihat daftar kebijakan penempatan.REGION
: region tempat satu atau beberapa kebijakan penempatan berada.
Outputnya mirip dengan hal berikut ini:
{
"kind": "compute#resourcePolicyList",
"id": "projects/example-project/regions/us-central1/resourcePolicies",
"items": [
{
"kind": "compute#resourcePolicy",
"id": "5587673659722509355",
"creationTimestamp": "2024-05-09T02:09:24.588-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "example-compact-policy",
"groupPlacementPolicy": {
"collocation": "COLLOCATED"
},
"status": "READY"
},
{
"kind": "compute#resourcePolicy",
"id": "5970772604948130963",
"creationTimestamp": "2024-05-09T02:08:13.404-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "example-spread-policy",
"groupPlacementPolicy": {
"availabilityDomainCount": 5
},
"status": "READY"
}
],
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
"etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}
Untuk informasi selengkapnya tentang penggunaan ekspresi filter untuk mempersempit daftar
kebijakan resource menggunakan
enkode URL, lihat
parameter kueri filter
.
Melihat detail kebijakan penempatan
Untuk melihat detail kebijakan penempatan, pilih salah satu opsi berikut:
Untuk melihat detail kebijakan penempatan, gunakan
perintah gcloud compute resource-policies describe
.
gcloud compute resource-policies describe POLICY_NAME \
--region=REGION
Ganti kode berikut:
POLICY_NAME
: nama kebijakan penempatan yang ada.REGION
: region tempat kebijakan penempatan berada.
Outputnya mirip dengan hal berikut ini:
Jika Anda melihat detail kebijakan penempatan rapat:
creationTimestamp: '2024-05-09T02:09:24.588-07:00' groupPlacementPolicy: collocation: COLLOCATED id: '5587673659722509355' kind: compute#resourcePolicy name: example-compact-policy region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy status: READY
Jika Anda melihat detail kebijakan penempatan sebaran:
creationTimestamp: '2024-05-09T02:08:13.404-07:00' groupPlacementPolicy: availabilityDomainCount: 5 id: '5970772604948130963' kind: compute#resourcePolicy name: example-spread-policy region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy status: READY
Untuk melihat detail kebijakan penempatan, buat permintaan GET
ke
metode resourcePolicies.get
.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /regions/REGION /resourcePolicies/POLICY_NAME
Ganti kode berikut:
PROJECT_ID
: ID project tempat kebijakan penempatan yang ingin Anda lihat detailnya berada.REGION
: region tempat kebijakan penempatan berada.POLICY_NAME
: nama kebijakan penempatan yang ada.
Outputnya mirip dengan hal berikut ini:
Jika Anda melihat detail kebijakan penempatan rapat:
{ "kind": "compute#resourcePolicy", "id": "5587673659722509355", "creationTimestamp": "2024-05-09T02:09:24.588-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-compact-policy", "groupPlacementPolicy": { "collocation": "COLLOCATED" }, "status": "READY" }
Jika Anda melihat detail kebijakan penempatan sebaran:
{ "kind": "compute#resourcePolicy", "id": "5970772604948130963", "creationTimestamp": "2024-05-09T02:08:13.404-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-spread-policy", "groupPlacementPolicy": { "availabilityDomainCount": 5 }, "status": "READY" }
Apa langkah selanjutnya?
Pelajari cara mengganti, meniadakan, atau menghapus kebijakan penempatan.
Pelajari cara menerapkan kebijakan penempatan:
Pelajari cara memverifikasi lokasi VM yang menggunakan kebijakan penempatan rapat.