Melihat, membatalkan, atau menghapus permintaan perubahan ukuran di MIG


Dokumen ini menjelaskan cara melakukan hal berikut setelah membuat permintaan pengubahan 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

    1. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    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.

        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:

  • 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

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

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

    Buka Instance groups

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

    Halaman ringkasan MIG akan terbuka.

  3. 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, berarti permintaan Anda mengalami error. Anda dapat mengklik nilai ini untuk mempelajari lebih lanjut.

    Untuk informasi selengkapnya tentang cara memecahkan 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 perubahan 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 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:

  • 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 untuk membuatnya saat tersedia. Jika kolom message berisi Expected 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, pilih salah satu opsi berikut:

gcloud

Ganti kode berikut:

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

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 di 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 perubahan 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 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

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

    Buka Instance groups

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

    Halaman ringkasan MIG akan terbuka.

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

    Panel Resize requests akan muncul.

  4. Pilih permintaan pengubahan ukuran yang ingin dibatalkan.

  5. Klik Batal, 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 zona 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 dari berikut:

  • Berhasil (SUCCEEDED)

  • Gagal (FAILED)

  • Dibatalkan (CANCELLED)

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 eksekusi 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

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

    Buka Instance groups

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

    Halaman ringkasan MIG akan terbuka.

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

    Panel Resize requests 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 perubahan 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 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.

Langkah selanjutnya