Dokumen ini menjelaskan cara melakukan hal berikut setelah membuat permintaan pengubahan ukuran dalam grup instance terkelola (MIG):
Setelah Anda membuat permintaan pengubahan ukuran di MIG, Anda dapat melakukan satu atau beberapa hal berikut:
Lihat permintaan pengubahan ukuran untuk memantau statusnya atau memecahkan masalahnya.
Membatalkan permintaan pengubahan ukuran untuk menghentikan MIG membuat instance virtual machine (VM) dalam jumlah yang diminta.
Hapus permintaan pengubahan ukuran jika 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 yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API.
Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Untuk membatalkan atau menghapus permintaan pengubahan 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 dalam MIG, lihat daftar permintaan pengubahan ukuran dalam 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 pengubahan ukuran.
Halaman ringkasan MIG akan terbuka.
Di baris Permintaan pengubahan ukuran, klik
Edit permintaan pengubahan ukuran.Panel Permintaan perubahan ukuran akan muncul. Jika kolom Detail permintaan pengubahan ukuran menampilkan nilai Kuota terlampaui atau Perkiraan waktu penyelesaian: tidak terbatas, berarti permintaan Anda mengalami error. Anda dapat mengklik nilai ini untuk mempelajari lebih lanjut.
Untuk mengetahui informasi selengkapnya tentang pemecahan 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 Anda, lihat Meminta penyesuaian kuota.ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS
: resource yang diminta tidak tersedia untuk sementara. Compute Engine telah menjadwalkan pembuatan resource yang diminta dan berencana membuatnya saat resource tersebut tersedia. Jika kolommessage
berisiExpected time is indefinite
, maka 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 pengubahan ukuran baru. Untuk menggunakan jenis mesin yang berbeda, buat template instance baru, lalu gunakan template tersebut untuk membuat atau mengupdate MIG.
Buat permintaan pengubahan 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 pengubahan ukuran yang ingin Anda lihat detailnya.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.Untuk melihat detail permintaan pengubahan ukuran dalam 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 pengubahan 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 pengubahan ukuran.
Halaman ringkasan MIG akan terbuka.
Di baris Permintaan pengubahan ukuran, klik
Edit permintaan pengubahan ukuran.Panel Permintaan perubahan ukuran akan muncul.
Pilih permintaan pengubahan ukuran yang ingin dibatalkan.
Klik
Batalkan, 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 zonal 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 pengubahan ukuran.
Halaman ringkasan MIG akan terbuka.
Di baris Permintaan pengubahan ukuran, klik
Edit permintaan pengubahan ukuran.Panel Permintaan perubahan ukuran 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 pengubahan 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 pengubahan 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.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk 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 pengubahan 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 perubahan ukuran di MIG:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Melihat permintaan pengubahan ukuran
Untuk melihat informasi tentang permintaan pengubahan ukuran dalam MIG, gunakan salah satu metode berikut:
Melihat daftar permintaan pengubahan ukuran di MIG
Untuk melihat daftar semua permintaan pengubahan ukuran dalam 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 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 memecahkannya 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 pengubahan 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 perubahan ukuran secara bersamaan, gunakan Google Cloud konsol atau Google Cloud CLI. Jika tidak, untuk membatalkan satu permintaan pengubahan 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 status berikut:
Namun, Anda dapat segera menghapus permintaan pengubahan ukuran sebelum itu, 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 berjalan 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 konsolGoogle 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 berikutnya
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 2025-07-09 UTC.
-