Melihat, membatalkan, atau menghapus permintaan perubahan ukuran di MIG

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

    1. 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.

    2. Set a default region and zone.

      3. 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:

  • 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

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

  1. Di konsol Google Cloud , buka halaman Instance groups.

    Buka Instance groups

  2. Di kolom Name, klik nama MIG yang berisi permintaan pengubahan ukuran.

    Halaman ringkasan MIG akan terbuka.

  3. 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.

gcloud

Ganti kode berikut:

  • 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.

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

  • Untuk melihat daftar permintaan pengubahan ukuran di MIG zona, kirim permintaan GET menggunakan metode instanceGroupManagerResizeRequests.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 metode beta.regionInstanceGroupManagerResizeRequests.list.

    GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests

Ganti kode berikut:

  • 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.

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:

  • 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 kolom message berisi Expected 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, pilih salah satu opsi berikut:

gcloud

Ganti kode berikut:

  • 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.

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

  • Untuk melihat detail permintaan pengubahan ukuran dalam MIG zona, kirim permintaan GET menggunakan metode instanceGroupManagerResizeRequests.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 metode beta.regionInstanceGroupManagerResizeRequests.get.

    GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Ganti kode berikut:

  • 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.

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

  1. Di konsol Google Cloud , buka halaman Instance groups.

    Buka Instance groups

  2. Di kolom Name, klik nama MIG yang berisi permintaan pengubahan ukuran.

    Halaman ringkasan MIG akan terbuka.

  3. Di baris Permintaan pengubahan ukuran, klik Edit permintaan pengubahan ukuran.

    Panel Permintaan perubahan ukuran akan muncul.

  4. Pilih permintaan pengubahan ukuran yang ingin dibatalkan.

  5. Klik Batalkan, lalu klik Konfirmasi.

gcloud

Ganti kode berikut:

  • 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, tentukan request-1,request-2.

  • ZONE: zona tempat MIG berada.

  • REGION: region tempat MIG berada.

REST

  • Untuk membatalkan permintaan pengubahan ukuran di MIG zona, kirim permintaan POST menggunakan metode instanceGroupManagerResizeRequests.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 metode beta.regionInstanceGroupManagerResizeRequests.cancel.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel

Ganti kode berikut:

  • 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.

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:

  • Berhasil (SUCCEEDED)

  • Gagal (FAILED)

  • Dibatalkan (CANCELLED)

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

  1. Di konsol Google Cloud , buka halaman Instance groups.

    Buka Instance groups

  2. Di kolom Name, klik nama MIG yang berisi permintaan pengubahan ukuran.

    Halaman ringkasan MIG akan terbuka.

  3. Di baris Permintaan pengubahan ukuran, klik Edit permintaan pengubahan ukuran.

    Panel Permintaan perubahan ukuran akan muncul.

  4. Pilih permintaan pengubahan ukuran yang akan dihapus.

  5. Klik Hapus, lalu klik Konfirmasi.

gcloud

Ganti kode berikut:

  • 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, tentukan request-1,request-2.

  • ZONE: zona tempat MIG berada.

  • REGION: region tempat MIG berada.

REST

  • Untuk menghapus permintaan pengubahan ukuran di MIG zona, kirim permintaan DELETE menggunakan metode instanceGroupManagerResizeRequests.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 metode beta.regionInstanceGroupManagerResizeRequests.delete.

    DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Ganti kode berikut:

  • 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.

Langkah berikutnya