Melihat, membatalkan, atau menghapus permintaan perubahan ukuran di MIG

Dokumen ini menjelaskan cara melakukan hal berikut setelah membuat permintaan perubahan ukuran dalam grup instance terkelola (MIG):

Lihat permintaan perubahan ukuran dalam MIG untuk memantau statusnya atau memecahkan masalahnya.
Batalkan permintaan perubahan ukuran untuk menghentikan MIG membuat instance virtual machine (VM) dalam jumlah yang diminta.
Hapus permintaan perubahan ukuran.

Sebelum memulai

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:
Konsol

Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
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

Untuk mendapatkan izin yang diperlukan untuk melihat, membatalkan, atau menghapus permintaan perubahan 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.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk melihat, membatalkan, atau menghapus permintaan perubahan ukuran di MIG. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat, membatalkan, atau menghapus permintaan ubah ukuran di MIG:

Untuk membatalkan atau menghapus permintaan perubahan ukuran di MIG: compute.instanceGroupManagers.update
Untuk melihat daftar permintaan perubahan ukuran di MIG: compute.instanceGroupManagers.list
Untuk melihat detail permintaan perubahan ukuran: compute.instanceGroupManagers.get

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Melihat permintaan perubahan ukuran

Berdasarkan detail yang ingin Anda lihat dalam permintaan perubahan ukuran, gunakan salah satu metode berikut:

Untuk melihat detail dan status konfigurasi semua permintaan perubahan ukuran di MIG, lihat daftar permintaan perubahan ukuran di MIG.
Untuk melihat detail konfigurasi, status, dan pesan error dalam permintaan perubahan ukuran, lihat detail permintaan perubahan ukuran.

Melihat daftar permintaan perubahan ukuran di MIG

Anda dapat melihat daftar semua permintaan perubahan ukuran dalam MIG beserta detailnya, seperti status, jumlah VM yang diminta, dan durasi berjalannya VM.

Konsol

Untuk melihat daftar semua permintaan perubahan ukuran di MIG, lakukan langkah berikut:

Di Konsol Google Cloud, buka halaman Instance groups.

Buka Instance groups
Di kolom Name, klik nama MIG yang berisi permintaan perubahan ukuran.

Halaman detail MIG akan terbuka.
Di baris Resize requests, klik Edit resize requests.

Panel Resize requests akan muncul.

gcloud

Untuk melihat daftar semua permintaan perubahan ukuran di MIG, gunakan perintah beta instance-groups managed resize-requests list.

gcloud beta compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \
    --zone=ZONE

Ganti kode berikut:

INSTANCE_GROUP_NAME: nama MIG zona yang ada dengan permintaan perubahan ukuran yang diterima, berhasil, dibatalkan, atau gagal.
ZONE: zona tempat MIG berada.

Outputnya mirip dengan hal berikut ini:

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

Untuk melihat daftar semua permintaan perubahan ukuran di MIG zona, buat permintaan GET ke metode beta.instanceGroupManagerResizeRequests.list.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests

Ganti kode berikut:

PROJECT_ID: ID project tempat MIG zona yang sudah ada dengan permintaan perubahan ukuran yang diterima, berhasil, dibatalkan, atau gagal.
ZONE: zona tempat MIG berada.
INSTANCE_GROUP_NAME: nama MIG zona yang ada dengan permintaan perubahan ukuran yang diterima, berhasil, dibatalkan, atau gagal.

Outputnya mirip dengan hal 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/beta/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/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-01",
      "selfLinkWithId": "https://www.googleapis.com/compute/beta/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/beta/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/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-02",
      "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/8095866098849525652"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests"
}

Melihat detail permintaan perubahan ukuran

Anda dapat melihat detail permintaan perubahan ukuran untuk meninjau konfigurasinya dan, secara opsional, memecahkan masalahnya jika permintaan belum berhasil.

Untuk memahami alasan permintaan perubahan ukuran (ACCEPTED) tidak berhasil, periksa kolom lastAttempt.error.errors.code terakhir, yang dapat ditetapkan Compute Engine ke salah satu nilai berikut:

ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS: resource yang diminta tidak tersedia untuk sementara.
QUOTA_EXCEEDED: project Anda tidak memiliki kuota untuk resource yang diminta. Untuk meningkatkan kuota project, lihat artikel Meminta kuota yang lebih tinggi.

gcloud

Untuk melihat detail permintaan perubahan ukuran di MIG zona, 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 \
    --zone=ZONE

Ganti kode berikut:

INSTANCE_GROUP_NAME: nama MIG zona yang ada tempat permintaan perubahan ukuran berada.
RESIZE_REQUEST_NAME: nama permintaan pengubahan ukuran yang ada yang ingin Anda lihat detailnya.
ZONE: zona tempat MIG berada.

Outputnya mirip dengan hal berikut ini:

count: 10
creationTimestamp: '2024-01-10T07:51:53.034-08:00'
id: '4247139565532196982'
kind: compute#instanceGroupManagerResizeRequest
name: example-request
requestedRunDuration:
  nanos: 0
  seconds: '6000'
resizeBy: 10
selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982
state: ACCEPTED
status:
  lastAttempt:
    error:
      errors:
      - code: ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS
        message: There are currently not enough resources available to fulfill the request.
      - code: QUOTA_EXCEEDED
        message: Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1.
zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a

REST

Untuk melihat detail permintaan perubahan ukuran di MIG, buat permintaan GET ke metode beta.instanceGroupManagerResizeRequests.get.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Ganti kode berikut:

PROJECT_ID: ID project tempat MIG zona berada.
ZONE: zona tempat MIG berada.
INSTANCE_GROUP_NAME: nama MIG zona yang ada tempat permintaan perubahan ukuran berada.
RESIZE_REQUEST_NAME: nama permintaan pengubahan ukuran yang ada yang ingin Anda lihat detailnya.

Outputnya mirip dengan hal berikut ini:

{
  "kind": "compute#instanceGroupManagerResizeRequest",
  "id": "4247139565532196982",
  "creationTimestamp": "2024-01-10T07:51:53.034-08:00",
  "name": "example-request",
  "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a",
  "count": 10,
  "resizeBy": 10,
  "requestedRunDuration": {
    "seconds": "6000",
    "nanos": 0
  },
  "state": "ACCEPTED",
  "status": {
    "lastAttempt": {
      "error": {
        "errors": [
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "There are currently not enough resources available to fulfill the request.",
          },
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          }
        ]
      }
    }
  },
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982"
}

Membatalkan permintaan perubahan ukuran di MIG

Anda dapat membatalkan permintaan pengubahan ukuran dalam MIG untuk menghentikan MIG mencoba membuat VM dalam jumlah yang diminta. Anda hanya dapat membatalkan permintaan perubahan ukuran yang diterima (ACCEPTED). Setelah membatalkan permintaan perubahan ukuran, Anda dapat menghapusnya atau membiarkan Compute Engine menghapusnya secara otomatis setelah 14 hari.

Untuk membatalkan lebih dari satu permintaan perubahan ukuran sekaligus, gunakan Google Cloud Console atau gcloud CLI.

Konsol

Untuk membatalkan permintaan perubahan ukuran di MIG zona, lakukan hal berikut:

Di Konsol Google Cloud, buka halaman Instance groups.

Buka Instance groups
Di kolom Name, klik nama MIG yang berisi permintaan perubahan ukuran.

Halaman detail MIG akan terbuka.
Di baris Resize requests, klik Edit resize requests.

Panel Resize requests akan muncul.
Pilih permintaan pengubahan ukuran yang akan dibatalkan.
Klik Batal, lalu klik Konfirmasi.

gcloud

Untuk membatalkan permintaan perubahan ukuran di MIG zona, 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 \
    --zone=ZONE

Ganti kode berikut:

INSTANCE_GROUP_NAME: nama MIG zona yang ada dengan permintaan perubahan ukuran yang diterima.
RESIZE_REQUEST_NAMES: daftar nama yang dipisahkan koma untuk permintaan perubahan ukuran yang diterima di MIG zona yang ditentukan. Misalnya, tentukan request-1,request-2.
ZONE: zona tempat MIG berada.

REST

Untuk membatalkan permintaan perubahan ukuran di MIG zona, buat permintaan POST ke metode beta.instanceGroupManagerResizeRequests.cancel.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel

Ganti kode berikut:

PROJECT_ID: ID project tempat MIG zona yang ada dengan permintaan perubahan ukuran yang diterima berada.
ZONE: zona tempat MIG berada.
INSTANCE_GROUP_NAME: nama MIG.
RESIZE_REQUEST_NAME: nama permintaan perubahan ukuran yang akan dibatalkan.

Menghapus permintaan perubahan ukuran di MIG

Secara default, Compute Engine otomatis menghapus permintaan perubahan ukuran 14 hari setelah status permintaan ditetapkan ke salah satu dari berikut ini:

Berhasil (SUCCEEDED)
Gagal (FAILED)
Dibatalkan (CANCELLED)

Namun, Anda dapat segera menghapus permintaan perubahan ukuran sebelum tanggal tersebut, seperti yang dijelaskan di bagian ini.

Menghapus permintaan perubahan 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 telah selesai berjalan dan Anda tidak lagi memerlukan VM, hapus VM.

Untuk menghapus lebih dari satu permintaan perubahan ukuran sekaligus, gunakan Google Cloud Console atau gcloud CLI.

Konsol

Untuk menghapus permintaan pengubahan ukuran di MIG zona, lakukan hal berikut:

Di Konsol Google Cloud, buka halaman Instance groups.

Buka Instance groups
Di kolom Name, klik nama MIG yang berisi permintaan perubahan ukuran.

Halaman detail MIG akan terbuka.
Di baris Resize requests, klik Edit resize requests.

Panel Resize requests akan muncul.
Pilih permintaan ubah ukuran yang akan dihapus.
Klik Hapus, lalu klik Konfirmasi.

gcloud

Untuk menghapus permintaan perubahan ukuran di MIG zona, 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 \
    --zone=ZONE

Ganti kode berikut:

INSTANCE_GROUP_NAME: nama MIG zona yang ada dengan permintaan perubahan ukuran yang berhasil, gagal, atau dibatalkan.
RESIZE_REQUEST_NAMES: daftar nama yang dipisahkan koma dari permintaan perubahan ukuran yang akan dihapus di MIG. Misalnya, tentukan request-1,request-2.
ZONE: zona tempat MIG berada.

REST

Untuk menghapus permintaan perubahan ukuran di MIG zona, buat permintaan DELETE ke metode beta.instanceGroupManagerResizeRequests.delete.

DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Ganti kode berikut:

PROJECT_ID: ID project tempat MIG zona yang ada dengan permintaan perubahan ukuran yang berhasil, gagal, atau dibatalkan.
ZONE: zona tempat MIG berada.
INSTANCE_GROUP_NAME: nama MIG.
RESIZE_REQUEST_NAME: nama permintaan ubah ukuran yang akan dihapus.

Langkah selanjutnya

Pelajari cara melihat informasi tentang VM terkelola dalam MIG.