Dokumen ini menjelaskan cara melakukan hal berikut setelah membuat permintaan perubahan ukuran di grup instance terkelola (MIG):
Setelah membuat permintaan perubahan ukuran di MIG, Anda dapat melakukan satu atau beberapa hal berikut:
Lihat permintaan pengubahan ukuran untuk memantau statusnya atau memecahkan masalahnya.
Batalkan permintaan pengubahan ukuran untuk menghentikan MIG membuat instance virtual machine (VM) dalam jumlah yang diminta.
Menghapus permintaan pengubahan ukuran saat Anda tidak lagi memerlukannya.
Sebelum memulai
- Jika Anda belum melakukannya, lihat cara kerja permintaan pengubahan ukuran.
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud.
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:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Untuk membatalkan atau menghapus permintaan perubahan ukuran di MIG:
compute.instanceGroupManagers.update
-
Untuk melihat daftar permintaan pengubahan ukuran di MIG:
compute.instanceGroupManagers.list
-
Untuk melihat detail permintaan pengubahan ukuran:
compute.instanceGroupManagers.get
Untuk ringkasan semua permintaan di MIG, lihat daftar permintaan pengubahan ukuran di MIG.
Untuk mengetahui detail lengkap permintaan tertentu, lihat detail permintaan pengubahan ukuran.
Di Konsol Google Cloud, buka halaman Instance groups.
Di kolom Name, klik nama MIG yang berisi permintaan perubahan ukuran.
Halaman ringkasan MIG akan terbuka.
Di baris Permintaan pengubahan ukuran, klik
Edit permintaan pengubahan ukuran.Panel Resize requests akan muncul. Jika kolom Details permintaan perubahan ukuran menampilkan nilai Quota exceeded atau ETA: indefinite, permintaan Anda mengalami error. Anda dapat mengklik nilai ini untuk mempelajari lebih lanjut.
Untuk mengetahui informasi selengkapnya tentang cara memecahkan masalah error, lihat Melihat detail permintaan pengubahan ukuran dalam dokumen ini.
Untuk melihat daftar permintaan pengubahan ukuran di MIG zona, gunakan perintah
instance-groups managed resize-requests list
.gcloud compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \ --zone=ZONE
Untuk melihat daftar permintaan pengubahan ukuran di MIG regional, gunakan perintah
beta instance-groups managed resize-requests list
.gcloud beta compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \ --region=REGION
INSTANCE_GROUP_NAME
: nama MIG dengan permintaan pengubahan ukuran yang diterima, berhasil, dibatalkan, atau gagal.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.Untuk melihat daftar permintaan pengubahan ukuran di MIG zona, kirim permintaan
GET
menggunakan metodeinstanceGroupManagerResizeRequests.list
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
Untuk melihat daftar permintaan pengubahan ukuran di MIG regional, kirim permintaan
GET
menggunakan metodebeta.regionInstanceGroupManagerResizeRequests.list
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
PROJECT_ID
: ID project tempat MIG dengan permintaan pengubahan ukuran yang diterima, berhasil, dibatalkan, atau gagal berada.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.INSTANCE_GROUP_NAME
: nama MIG yang ada dengan permintaan pengubahan ukuran yang diterima, berhasil, dibatalkan, atau gagal.QUOTA_EXCEEDED
: project Anda tidak memiliki kuota untuk resource yang diminta. Untuk meningkatkan kuota project, lihat artikel Meminta kuota yang lebih tinggi.ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS
: resource yang diminta sementara tidak tersedia. Compute Engine telah menjadwalkan pembuatan resource yang diminta dan berencana membuatnya saat tersedia. Jika kolommessage
berisiExpected time is indefinite
, Google merekomendasikan untuk membatalkan permintaan dan mencoba satu atau beberapa hal berikut:Buat permintaan pengubahan ukuran baru dengan jumlah VM yang diminta lebih rendah.
Gunakan jenis mesin yang berbeda di MIG, lalu buat permintaan perubahan ukuran baru. Untuk menggunakan jenis mesin yang berbeda, buat template instance baru, lalu gunakan template tersebut untuk membuat atau mengupdate MIG.
Buat permintaan perubahan ukuran di MIG yang berada di region atau zona yang berbeda.
Untuk melihat detail permintaan pengubahan ukuran di MIG zona, gunakan perintah
instance-groups managed resize-requests describe
.gcloud compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --zone=ZONE
Untuk melihat detail permintaan pengubahan ukuran di MIG regional, gunakan perintah
beta instance-groups managed resize-requests describe
.gcloud beta compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --region=REGION
INSTANCE_GROUP_NAME
: nama MIG.RESIZE_REQUEST_NAME
: nama permintaan perubahan ukuran yang ingin Anda lihat detailnya.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.Untuk melihat detail permintaan pengubahan ukuran di MIG zona, kirim permintaan
GET
menggunakan metodeinstanceGroupManagerResizeRequests.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME
Untuk melihat detail permintaan pengubahan ukuran di MIG regional, kirim permintaan
GET
menggunakan metodebeta.regionInstanceGroupManagerResizeRequests.get
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME
PROJECT_ID
: ID project tempat MIG zonal berada.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.INSTANCE_GROUP_NAME
: nama MIG tempat permintaan pengubahan ukuran berada.RESIZE_REQUEST_NAME
: nama permintaan perubahan ukuran yang ada yang ingin Anda lihat detailnya.Di Konsol Google Cloud, buka halaman Instance groups.
Di kolom Name, klik nama MIG yang berisi permintaan perubahan ukuran.
Halaman ringkasan MIG akan terbuka.
Di baris Permintaan pengubahan ukuran, klik
Edit permintaan pengubahan ukuran.Panel Resize requests akan muncul.
Pilih permintaan pengubahan ukuran yang ingin dibatalkan.
Klik
Batal, lalu klik Konfirmasi.Untuk membatalkan permintaan pengubahan ukuran di MIG zona, gunakan perintah
instance-groups managed resize-requests cancel
.gcloud compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \ --resize-requests=RESIZE_REQUEST_NAMES \ --zone=ZONE
Untuk membatalkan permintaan pengubahan ukuran di MIG regional, gunakan perintah
beta instance-groups managed resize-requests cancel
.gcloud beta compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \ --resize-requests=RESIZE_REQUEST_NAMES \ --region=REGION
INSTANCE_GROUP_NAME
: nama MIG dengan permintaan pengubahan ukuran yang diterima.RESIZE_REQUEST_NAMES
: daftar nama yang dipisahkan koma dari permintaan pengubahan ukuran yang diterima di MIG zona yang ditentukan. Misalnya, tentukanrequest-1,request-2
.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.Untuk membatalkan permintaan pengubahan ukuran di MIG zona, kirim permintaan
POST
menggunakan metodeinstanceGroupManagerResizeRequests.cancel
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel
Untuk membatalkan permintaan pengubahan ukuran di MIG regional, kirim permintaan
POST
menggunakan metodebeta.regionInstanceGroupManagerResizeRequests.cancel
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel
PROJECT_ID
: ID project tempat MIG zonal yang ada dengan permintaan pengubahan ukuran yang diterima berada.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.INSTANCE_GROUP_NAME
: nama MIG.RESIZE_REQUEST_NAME
: nama permintaan pengubahan ukuran yang akan dibatalkan.Berhasil (
SUCCEEDED
)Gagal (
FAILED
)Dibatalkan (
CANCELLED
)Di Konsol Google Cloud, buka halaman Instance groups.
Di kolom Name, klik nama MIG yang berisi permintaan perubahan ukuran.
Halaman ringkasan MIG akan terbuka.
Di baris Permintaan pengubahan ukuran, klik
Edit permintaan pengubahan ukuran.Panel Resize requests akan muncul.
Pilih permintaan pengubahan ukuran yang akan dihapus.
Klik
Hapus, lalu klik Konfirmasi.Untuk menghapus permintaan pengubahan ukuran di MIG zona, gunakan perintah
instance-groups managed resize-requests delete
.gcloud compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \ --resize-requests=RESIZE_REQUEST_NAMES \ --zone=ZONE
Untuk menghapus permintaan pengubahan ukuran di MIG regional, gunakan perintah
beta instance-groups managed resize-requests delete
.gcloud beta compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \ --resize-requests=RESIZE_REQUEST_NAMES \ --region=REGION
INSTANCE_GROUP_NAME
: nama MIG dengan permintaan pengubahan ukuran yang berhasil, gagal, atau dibatalkan.RESIZE_REQUEST_NAMES
: daftar nama permintaan perubahan ukuran yang dipisahkan koma untuk dihapus di MIG. Misalnya, tentukanrequest-1,request-2
.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.Untuk menghapus permintaan pengubahan ukuran di MIG zona, kirim permintaan
DELETE
menggunakan metodeinstanceGroupManagerResizeRequests.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME
Untuk menghapus permintaan pengubahan ukuran di MIG regional, kirim permintaan
DELETE
menggunakan metodebeta.regionInstanceGroupManagerResizeRequests.delete
.DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME
PROJECT_ID
: ID project tempat MIG zonal yang ada dengan permintaan perubahan ukuran yang berhasil, gagal, atau dibatalkan berada.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.INSTANCE_GROUP_NAME
: nama MIG.RESIZE_REQUEST_NAME
: nama permintaan pengubahan ukuran yang akan dihapus.- Pelajari cara melihat informasi tentang VM terkelola dalam MIG.
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 Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna melihat, membatalkan, atau menghapus permintaan pengubahan ukuran di MIG, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) di project. 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, membatalkan, atau menghapus permintaan perubahan ukuran di MIG. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk melihat, membatalkan, atau menghapus permintaan pengubahan ukuran di MIG:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Melihat permintaan pengubahan ukuran Anda
Untuk melihat informasi tentang permintaan pengubahan ukuran di MIG, gunakan salah satu metode berikut:
Melihat daftar permintaan pengubahan ukuran di MIG
Untuk melihat daftar semua permintaan pengubahan ukuran di MIG, pilih salah satu opsi berikut:
Untuk melihat daftar semua permintaan pengubahan ukuran di MIG regional, gunakan gcloud CLI atau REST API. Atau, untuk melihat daftar semua permintaan pengubahan ukuran di MIG zona, pilih salah satu opsi berikut:
Konsol
gcloud
Ganti kode berikut:
Outputnya mirip dengan berikut ini untuk MIG zona:
NAME: rr-01 LOCATION: us-central1-a SCOPE: zone RESIZE_BY: 5 STATE: SUCCEEDED REQUESTED_RUN_DURATION: P1D NAME: rr-02 LOCATION: us-central1-a SCOPE: zone RESIZE_BY: 10 STATE: ACCEPTED REQUESTED_RUN_DURATION: P3D
REST
Ganti kode berikut:
Output dari MIG zonal mirip dengan yang berikut ini:
{ "kind": "compute#instanceGroupManagerResizeRequestList", "id": "projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests", "items": [ { "kind": "compute#instanceGroupManagerResizeRequest", "id": "4247139565532196982", "creationTimestamp": "2024-01-08T07:51:53.034-08:00", "name": "rr-01", "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a", "count": 5, "resizeBy": 5, "requestedRunDuration": { "seconds": "86400", "nanos": 0 }, "state": "SUCCEEDED", "status": {}, "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-01", "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982" }, { "kind": "compute#instanceGroupManagerResizeRequest", "id": "8095866098849525652", "creationTimestamp": "2024-01-11T08:04:11.851-08:00", "name": "rr-02", "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a", "count": 10, "resizeBy": 10, "requestedRunDuration": { "seconds": "259200", "nanos": 0 }, "state": "ACCEPTED", "status": {}, "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-02", "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/8095866098849525652" } ], "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests" }
Melihat detail permintaan pengubahan ukuran
Anda dapat melihat detail permintaan pengubahan ukuran untuk meninjau konfigurasinya dan, jika perlu, memecahkan masalahnya jika permintaan belum berhasil.
Jika permintaan pengubahan ukuran yang diterima tidak berhasil, Anda dapat memecahkan masalahnya dengan memeriksa kolom
status.lastAttempt.error.errors.code
di detail permintaan. Kemungkinan kode error adalah sebagai berikut:Untuk melihat detail permintaan pengubahan ukuran, pilih salah satu opsi berikut:
gcloud
Ganti kode berikut:
Outputnya mirip dengan berikut ini untuk MIG zona:
creationTimestamp: '2024-09-23T02:27:09.575-07:00' id: '6386622402379156098' kind: compute#instanceGroupManagerResizeRequest name: example-request requestedRunDuration: nanos: 0 seconds: '86400' resizeBy: 10 selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/6386622402379156098 state: ACCEPTED status: lastAttempt: error: errors: - code: QUOTA_EXCEEDED message: Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1. - code: ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS message: There are currently not enough resources available to fulfill the request. Expected time is indefinite. - errorDetails: - errorInfo: - metadatas: - estimatedAvailabilityTime: '9999-12-31T23:59:59.999999999Z' zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
REST
Ganti kode berikut:
Outputnya mirip dengan hal berikut ini:
{ "kind": "compute#instanceGroupManagerResizeRequest", "id": "6386622402379156098", "creationTimestamp": "2024-09-23T02:27:09.575-07:00", "name": "example-request", "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a", "resizeBy": 10, "requestedRunDuration": { "seconds": "86400", "nanos": 0 }, "state": "SUCCEEDED", "status": { "lastAttempt": { "error": { "errors": [ { "code": "QUOTA_EXCEEDED", "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1." }, { "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS", "message": "There are currently not enough resources available to fulfill the request. Expected time is indefinite.", "errorDetails": [ { "errorInfo":{ "metadatas":{ "estimatedAvailabilityTime": "9999-12-31T23:59:59.999999999Z" } } } ] } ] } } }, "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request", "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/6386622402379156098" }
Membatalkan permintaan pengubahan ukuran di MIG
Anda dapat membatalkan permintaan pengubahan ukuran di MIG untuk menghentikan MIG agar tidak mencoba membuat jumlah VM yang diminta. Anda hanya dapat membatalkan permintaan perubahan ukuran yang disetujui (
ACCEPTED
). Setelah membatalkan permintaan pengubahan ukuran, Anda dapat menghapusnya atau membiarkan Compute Engine menghapusnya secara otomatis setelah 14 hari.Untuk membatalkan beberapa permintaan pengubahan ukuran secara bersamaan, gunakan konsol Google Cloud atau Google Cloud CLI. Jika tidak, untuk membatalkan satu permintaan perubahan ukuran, pilih salah satu opsi berikut:
Konsol
gcloud
Ganti kode berikut:
REST
Ganti kode berikut:
Menghapus permintaan perubahan ukuran di MIG
Secara default, Compute Engine otomatis menghapus permintaan pengubahan ukuran 14 hari setelah menetapkan status permintaan ke salah satu dari berikut:
Namun, Anda dapat segera menghapus permintaan pengubahan ukuran sebelum waktu tersebut, seperti yang dijelaskan di bagian ini.
Menghapus permintaan pengubahan ukuran yang berhasil tidak akan menghapus VM yang dibuat melalui permintaan tersebut. MIG akan otomatis menghapus VM tersebut di akhir durasi operasi yang diminta. Namun, jika tugas Anda telah selesai berjalan dan Anda tidak lagi memerlukan VM, hapus VM.
Untuk menghapus beberapa permintaan pengubahan ukuran secara bersamaan, gunakan konsol Google Cloud atau gcloud CLI. Jika tidak, untuk menghapus satu permintaan perubahan ukuran, pilih salah satu opsi berikut:
Konsol
gcloud
Ganti kode berikut:
REST
Ganti kode berikut:
Langkah selanjutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-22 UTC.
-