Melihat kapasitas yang dicadangkan

Dokumen ini menjelaskan cara melihat permintaan Anda untuk kapasitas yang dicadangkan dan kapasitas yang dicadangkan untuk AI Hypercomputer. Dengan melihat ketersediaan, properti, dan topologi permintaan dan kapasitas yang dicadangkan, Anda dapat merencanakan kapasitas yang dicadangkan untuk beban kerja Anda.

Cakupan dokumen ini terbatas pada workload yang menggunakan opsi kapasitas yang menyebutkan pemesanan untuk masa mendatang. Untuk mengetahui informasi selengkapnya tentang opsi kapasitas untuk AI Hypercomputer, lihat Ringkasan kapasitas.

Setelah Google Cloud menyetujui permintaan pemesanan untuk masa mendatang, Compute Engine akan otomatis membuat (membuat otomatis) pemesanan kosong untuk resource yang Anda minta. Kemudian, Anda dapat melihat reservasi untuk merencanakan workload. Kemudian, pada waktu mulai yang diminta, hal berikut akan terjadi:

• Compute Engine menambahkan instance virtual machine (VM) yang dicadangkan ke reservasi. Kemudian, Anda dapat mulai menggunakan reservasi dengan membuat VM yang cocok dengan reservasi tersebut.
• Anda dapat mengubah reservasi untuk mengizinkan tugas pelatihan atau prediksi Vertex AI menggunakannya. Untuk mengetahui petunjuknya, lihat Mengubah kebijakan berbagi reservasi.

Batasan

Anda hanya dapat melihat permintaan pemesanan bersama atau permintaan pemesanan untuk masa mendatang bersama di project tempat Google membuatnya.

Sebelum memulai

1. Cadangkan kapasitas: Jika project Anda belum melakukannya, cadangkan kapasitas untuk AI Hypercomputer menggunakan salah satu opsi berikut:
   • Pesan kapasitas melalui tim akun Anda
   • Membuat permintaan pemesanan untuk masa mendatang dalam mode kalender

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

   In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

   REST

   Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

   Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

   gcloud init

   Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

   Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

   Peran yang diperlukan

   Untuk mendapatkan izin yang diperlukan untuk melihat pemesanan, minta administrator Anda untuk memberi Anda peran IAM Compute Future Reservation User (roles/compute.futureReservationUser) 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 reservasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

   Izin yang diperlukan

   Izin berikut diperlukan untuk melihat pemesanan:

   • Untuk melihat detail permintaan pemesanan untuk masa mendatang: compute.futureReservations.get pada project
   • Untuk melihat detail pemesanan: compute.reservations.get pada project

   Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

   Melihat permintaan Anda untuk kapasitas yang dicadangkan

   Untuk melihat permintaan pemesanan untuk masa mendatang, gunakan satu atau beberapa metode berikut:

   • Untuk mendapatkan ringkasan semua permintaan pemesanan untuk masa mendatang dalam project Anda, lihat daftar permintaan pemesanan untuk masa mendatang.
   • Untuk melihat detail lengkap satu permintaan pemesanan untuk masa mendatang, lihat detail permintaan pemesanan untuk masa mendatang.

   Melihat daftar permintaan pemesanan untuk masa mendatang

   Anda dapat melihat daftar permintaan pemesanan untuk masa mendatang guna melihat periode pemesanan, status, dan zona permintaan Anda.

   Untuk melihat daftar permintaan pemesanan untuk masa mendatang, pilih salah satu opsi berikut:

   Konsol

   1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Pemesanan

   2. Klik tab Future reservations. Tabel mencantumkan setiap permintaan pemesanan untuk masa mendatang, dan setiap kolom tabel menjelaskan properti.
   3. Opsional: Untuk menyaring daftar permintaan, di kolom Filter, pilih properti yang ingin Anda gunakan untuk memfilter permintaan.

   gcloud

   Untuk melihat daftar permintaan pemesanan untuk masa mendatang, gunakan perintah gcloud compute future-reservations list:

   gcloud compute future-reservations list
   

   Outputnya mirip dengan contoh berikut:

   NAME: fr-01
   TOTAL_COUNT: 100
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-08-05T07:00:00Z
   PROCUREMENT_STATUS: FULFILLED
   ZONE: us-west4-b
   
   NAME: fr-02
   TOTAL_COUNT: 10
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-12-01T00:00:00Z
   PROCUREMENT_STATUS: PENDING_APPROVAL
   ZONE: us-west4-b
   

   Jika Anda ingin mempersempit daftar permintaan pemesanan untuk masa mendatang, gunakan perintah yang sama dengan flag --filter.

   REST

   Untuk melihat daftar permintaan pemesanan untuk masa mendatang, buat permintaan GET ke salah satu metode berikut:

   • Untuk melihat daftar permintaan di semua zona: metode futureReservations.aggregatedList
   • Untuk melihat daftar permintaan di zona tertentu: Metode futureReservations.list

   Misalnya, untuk melihat daftar permintaan di semua zona, buat permintaan GET sebagai berikut:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/futureReservations
   

   Ganti PROJECT_ID dengan ID project tempat permintaan berada.

   Output untuk daftar permintaan pemesanan untuk masa mendatang dalam satu zona mirip dengan berikut ini:

   {
     "id": "projects/example-project/aggregated/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       },
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/aggregated/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   Jika Anda ingin mempersempit daftar permintaan pemesanan untuk masa mendatang, buat permintaan yang sama dan, di URL permintaan, sertakan filter parameter kueri.

   Melihat detail permintaan pemesanan untuk masa mendatang

   Anda dapat melihat detail permintaan pemesanan untuk masa mendatang guna meninjau properti dan periode pemesanan resource yang dipesan.

   Untuk melihat detail permintaan pemesanan untuk masa mendatang, pilih salah satu opsi berikut:

   Konsol

   1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Pemesanan

   2. Klik tab Future reservations. Tabel mencantumkan setiap permintaan pemesanan untuk masa mendatang, dan setiap kolom tabel menjelaskan properti.
   3. Untuk melihat detail permintaan, di kolom Nama, klik nama permintaan. Halaman yang memberikan detail permintaan pemesanan untuk masa mendatang akan terbuka.

   gcloud

   Untuk melihat detail permintaan pemesanan untuk masa mendatang, gunakan perintah gcloud compute future-reservations describe:

   gcloud compute future-reservations describe FUTURE_RESERVATION_NAME \
       --zone=ZONE
   

   Ganti kode berikut:

   • FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang.
   • ZONE: zona tempat permintaan pemesanan untuk masa mendatang berada.

   Outputnya mirip dengan contoh berikut:

   autoCreatedReservationsDeleteTime: '2026-02-10T19:20:00Z'
   creationTimestamp: '2025-11-27T11:14:58.305-08:00'
   deploymentType: DENSE
   id: '7979651787097007552'
   kind: compute#futureReservation
   name: example-draft-request
   planningStatus: DRAFT
   reservationName: example-reservation
   schedulingType: INDEPENDENT
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552
   specificReservationRequired: true
   specificSkuProperties:
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 8
         acceleratorType: nvidia-h200-141gb
       localSsds:
       -   diskSizeGb: '375'
         interface: NVME
       ...
     machineType: a3-ultragpu-8g
   totalCount: '2'
   status:
     autoCreatedReservations:
     -   https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/reservations/example-reservation
     fulfilledCount: '2'
     lockTime: '2026-01-27T19:15:00Z'
     procurementStatus: DRAFTING
   timeWindow:
     endTime: '2026-02-10T19:20:00Z'
     startTime: '2026-01-27T19:20:00Z'
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b
   

   REST

   Untuk melihat detail permintaan pemesanan untuk masa mendatang, buat permintaan GET ke metode futureReservations.get:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
   

   Ganti kode berikut:

   • PROJECT_ID: ID project tempat permintaan pemesanan untuk masa mendatang berada.
   • ZONE: zona tempat permintaan pemesanan untuk masa mendatang berada.
   • FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang.

   Outputnya mirip dengan hal berikut ini:

   {
     "specificSkuProperties": {
       "instanceProperties": {
         "machineType": "a3-ultragpu-8g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-h200-141gb",
             "acceleratorCount": 8
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "375",
             "interface": "NVME"
           },
           ...
         ]
       },
       "totalCount": "2"
     },
     "kind": "compute#futureReservation",
     "id": "7979651787097007552",
     "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
     "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
     "name": "example-draft-request",
     "timeWindow": {
       "startTime": "2026-01-27T19:20:00Z",
       "endTime": "2026-02-10T19:20:00Z"
     },
     "status": {
       "procurementStatus": "DRAFTING",
       "lockTime": "2026-01-27T19:15:00Z"
     },
     "planningStatus": "DRAFT",
     "specificReservationRequired": true,
     "reservationName": "example-reservation",
     "deploymentType": "DENSE",
     "schedulingType": "INDEPENDENT",
     "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
   }
   

   Melihat kapasitas yang dipesan

   Lihat kapasitas yang dipesan saat Anda ingin melakukan satu atau beberapa hal berikut:

   • Identifikasi reservasi, blok, dan sub-blok yang ingin Anda gunakan untuk men-deploy beban kerja.
   • Pahami properti, penggunaan, dan topologi kapasitas yang dicadangkan.

   Untuk melihat kapasitas yang dipesan, gunakan satu atau beberapa metode berikut:

   • Untuk melihat ringkasan semua kapasitas yang dicadangkan di project Anda dan memeriksa kapasitas cadangan yang tidak digunakan, lihat daftar reservasi Anda.
   • Untuk meninjau properti dan ketersediaan semua VM yang dipesan untuk reservasi, lihat detail reservasi.
   • Untuk memahami cara blok dan sub-blok kapasitas untuk pemesanan diorganisir, seperti untuk integrasi dengan penjadwal atau alat perencanaan Anda, lihat topologi pemesanan.

   Melihat daftar pemesanan Anda

   Anda dapat melihat daftar reservasi di project untuk melihat semua kapasitas yang dipesan di project dan menelusuri reservasi yang akan digunakan untuk men-deploy workload.

   Untuk melihat daftar reservasi Anda, pilih salah satu opsi berikut:

   Konsol

   1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Pemesanan

      Di tab On-demand reservations (default), tabel mencantumkan setiap pemesanan, dan setiap kolom tabel menjelaskan properti.

   2. Opsional: Untuk menyaring daftar pemesanan, di kolom Filter, pilih properti yang ingin Anda gunakan untuk memfilter pemesanan.

   gcloud

   Untuk melihat daftar pemesanan, gunakan perintah gcloud compute reservations list:

   gcloud compute reservations list
   

   Outputnya mirip dengan hal berikut ini:

   NAME: r-01
   IN_USE_COUNT: 0
   COUNT: 5
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   
   NAME: r-02
   IN_USE_COUNT: 3
   COUNT: 10
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   

   Jika Anda ingin mempersempit daftar pemesanan, gunakan perintah yang sama dengan flag --filter.

   REST

   Untuk melihat daftar pemesanan Anda, buat permintaan GET ke salah satu metode berikut:

   • Untuk melihat daftar pemesanan Anda di semua zona: metode reservations.aggregatedList
   • Untuk melihat daftar pemesanan Anda dalam satu zona: metode reservations.list

   Misalnya, untuk melihat daftar pemesanan Anda di semua zona, buat permintaan GET sebagai berikut:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations
   

   Ganti PROJECT_ID dengan ID project tempat reservasi berada.

   Output untuk daftar reservasi dalam satu zona mirip dengan berikut ini:

   {
     "id": "projects/example-project/zones/europe-west1-b/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       }
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   Jika Anda ingin menyaring daftar reservasi, buat permintaan yang sama dan, di URL permintaan, sertakan parameter kueri filter.

   Melihat detail pemesanan

   Anda dapat melihat detail reservasi di project untuk memahami detail seperti berikut:

   • Jenis VM yang ada dalam reservasi.
   • Jumlah VM yang dicadangkan dan tersedia dalam pemesanan.
   • Kondisi reservasi, termasuk jumlah blok yang sehat. (Hanya tersedia dengan menggunakan gcloud CLI atau REST.)

   Jika Anda ingin memahami blok dan sub-blok pemesanan, lihat Melihat topologi pemesanan.

   Untuk melihat detail pemesanan, pilih salah satu opsi berikut:

   Konsol

   1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Pemesanan

   2. Di tabel Reservasi sesuai permintaan, di kolom Nama, klik nama reservasi yang ingin Anda lihat detailnya. Halaman yang memberikan detail pemesanan akan muncul.

   gcloud

   Untuk melihat detail pemesanan, gunakan gcloud compute reservations describe perintah:

   gcloud compute reservations describe RESERVATION_NAME \
       --zone=ZONE
   

   Ganti kode berikut:

   • RESERVATION_NAME: nama pemesanan.
   • ZONE: zona tempat pemesanan berada.

   Outputnya mirip dengan contoh berikut:

   advancedDeploymentControl:
     reservationOperationalMode: ALL_CAPACITY
   creationTimestamp: '2025-07-18T13:23:22.191-07:00'
   deleteAtTime: '2026-06-19T00:00:00Z'
   deploymentType: DENSE
   enableEmergentMaintenance: false
   id: '4298354039694234582'
   kind: compute#reservation
   name: example-res1
   reservationSharingPolicy:
     serviceShareType: DISALLOW_ALL
   resourceStatus:
     healthInfo:
       degradedBlockCount: 0
       healthStatus: HEALTHY
       healthyBlockCount: 1
     reservationBlockCount: 1
     reservationMaintenance:
       schedulingType: GROUPED
   schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/4298354039694234582
   shareSettings:
     shareType: LOCAL
   specificReservation:
     assuredCount: '18'
     count: '18'
     inUseCount: '2'
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 4
         acceleratorType: nvidia-gb200
       localSsds:
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       machineType: a4x-highgpu-4g
   specificReservationRequired: true
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   Output mencakup kolom berikut untuk pemesanan:

   • name: nama pemesanan.
   • healthInfo: informasi kesehatan untuk pemesanan sebagai berikut:
     • degradedBlockCount: jumlah blok yang mengalami penurunan kualitas dalam reservasi.
     • healthStatus: status kondisi keseluruhan pemesanan.
     • healthyBlockCount: jumlah blok yang sehat dalam reservasi.
   • reservationBlockCount: jumlah total blok dalam pemesanan.
   • assuredCount: jumlah total VM yang dapat di-deploy menggunakan reservasi. Jika nilai ini kurang dari count, lihat cara memecahkan masalah ketersediaan VM yang lebih sedikit untuk penggunaan.
   • inUseCount: jumlah VM yang sudah di-deploy dalam pemesanan.
   • instanceProperties: properti VM yang dapat di-deploy pemesanan.

   REST

   Untuk melihat detail pemesanan, buat permintaan GET ke reservations.get metode:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
   

   Ganti kode berikut:

   • PROJECT_ID: ID project tempat pemesanan berada.
   • ZONE: zona tempat pemesanan berada.
   • RESERVATION_NAME: nama pemesanan.

   Outputnya mirip dengan hal berikut ini:

   {
     "specificReservation": {
       "instanceProperties": {
         "machineType": "a4x-highgpu-4g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-gb200",
             "acceleratorCount": 4
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           }
         ]
       },
       "count": "36",
       "inUseCount": "35",
       "assuredCount": "33"
     },
     "kind": "compute#reservation",
     "id": "6823689647457870910",
     "creationTimestamp": "2025-08-04T13:40:50.496-07:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
     "name": "example-res1",
     "specificReservationRequired": true,
     "status": "READY",
     "shareSettings": {
       "shareType": "SPECIFIC_PROJECTS"
     },
     "resourceStatus": {
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "maintenanceStatus": "ONGOING"
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "reservationBlockCount": 1,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyBlockCount": 0,
         "degradedBlockCount": 1
       }
     },
     "reservationSharingPolicy": {
       "serviceShareType": "DISALLOW_ALL"
     },
     "deploymentType": "DENSE",
     "advancedDeploymentControl": {
       "reservationOperationalMode": "ALL_CAPACITY"
     },
     "enableEmergentMaintenance": false,
     "schedulingType": "GROUPED",
     "deleteAtTime": "2025-10-01T00:00:00Z"
   }
   

   Output mencakup kolom berikut untuk pemesanan:

   • instanceProperties: properti VM yang dapat di-deploy pemesanan.
   • inUseCount: jumlah VM yang sudah di-deploy dalam pemesanan.
   • assuredCount: jumlah total VM yang dapat di-deploy menggunakan reservasi. Jika nilai ini kurang dari count, lihat cara memecahkan masalah ketersediaan VM yang lebih sedikit untuk penggunaan.
   • name: nama pemesanan.
   • healthInfo: informasi kesehatan untuk pemesanan sebagai berikut:
     • healthStatus: status kondisi keseluruhan pemesanan.
     • healthyBlockCount: jumlah blok yang sehat dalam reservasi.
     • degradedBlockCount: jumlah blok yang mengalami penurunan kualitas dalam reservasi.

   Melihat topologi reservasi

   Anda dapat melihat informasi topologi mendetail dari reservasi untuk membantu Anda memutuskan tempat membuat VM dalam blok dan sub-blok yang dicadangkan. Untuk mengetahui informasi tentang penempatan VM yang dicadangkan yang sudah di-deploy, lihat Melihat topologi instance komputasi.

   Jika Anda ingin melihat detail lain tentang pemesanan, lihat melihat detail pemesanan.

   Melihat blok yang dicadangkan

   Untuk mencantumkan dan menjelaskan blok yang tersedia dalam reservasi, gunakan salah satu metode berikut. Tugas ini membantu Anda menentukan hal berikut:

   • Blok kapasitas mana yang ada dalam reservasi.
   • Berapa banyak kapasitas yang tersedia di setiap blok.
   • Kesehatan setiap blok, termasuk jumlah sub-blok yang sehat. (Hanya tersedia dengan menggunakan gcloud CLI atau REST.)
   • Nama, blok, dan sub-blok semua VM yang di-deploy dalam blok. (Hanya tersedia saat melihat blok tertentu menggunakan gcloud CLI atau REST.)

   Konsol

   1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Pemesanan

   2. Di tabel Reservasi sesuai permintaan, di kolom Nama, klik nama reservasi yang ingin Anda lihat detailnya. Halaman detail pemesanan akan terbuka.
   3. Di bagian Resource topology, Anda dapat melihat informasi tentang blok yang dicadangkan. Informasi ini mencakup hal berikut untuk setiap blok:
      • ID blok: nama blok.
      • Jumlah: jumlah total VM yang dapat di-deploy dalam blok.
      • Digunakan: jumlah VM yang sudah di-deploy di blok.

   gcloud

   Anda dapat melihat blok dalam reservasi menggunakan perintah berikut:

   • Untuk melihat semua blok yang tersedia dalam pemesanan, gunakan perintah gcloud compute reservations blocks list:

     gcloud compute reservations blocks list RESERVATION_NAME \
         --zone=ZONE
     

   • Untuk melihat blok tertentu dalam pemesanan, gunakan perintah gcloud compute reservations blocks describe. Untuk melihat nama dan topologi semua VM yang di-deploy dalam blok, tambahkan tanda --full-view=BLOCK_VIEW_FULL.

     gcloud compute reservations blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --full-view=BLOCK_VIEW_FULL
     

   Ganti kode berikut:

   • RESERVATION_NAME: nama pemesanan.
   • ZONE: zona tempat pemesanan berada.
   • BLOCK_NAME: nama blok.

   Output untuk setiap blok mirip dengan contoh berikut:

   resource:
     count: 36
     creationTimestamp: '2025-08-04T15:15:07.074-07:00'
     healthInfo:
       degradedSubBlockCount: 2
       healthStatus: DEGRADED
       healthySubBlockCount: 0
     id: '4360924059555106309'
     inUseCount: 35
     kind: compute#reservationBlock
     name: example-res1-block-0001
     physicalTopology:
       block: 1acd074d42cd3be9e4486b524db2e9ab
       cluster: us-central1-cluster-dnkc
       instances:
       -   instanceId: '5815586279631866288'
         physicalHostTopology:
           host: c229b308380a83e0ca345d4a0de05aa7
           subBlock: c02af6bdaeccacef571e0adbe79e8c28
         projectId: 'PROJECT_NUMBER'
       ...
       -   instanceId: '8389759878923049076'
         physicalHostTopology:
           host: '3ac534f00c20e6e0c87c3aaff2705be6'
           subBlock: 'c081876ba0aa2857d608eb30a5b2fa40'
         projectId: 'PROJECT_NUMBER'
     reservationMaintenance:
       instanceMaintenanceOngoingCount: 3
       instanceMaintenancePendingCount: 32
       maintenanceOngoingCount: 2
       maintenancePendingCount: 34
       schedulingType: GROUPED
       subblockInfraMaintenanceOngoingCount: 0
       subblockInfraMaintenancePendingCount: 0
       upcomingGroupMaintenance:
         canReschedule: false
         maintenanceReasons:
         -   PLANNED_UPDATE
         maintenanceStatus: ONGOING
         type: SCHEDULED
         windowEndTime: '2025-09-08T17:00:00.000-07:00'
         windowStartTime: '2025-09-08T13:00:00.000-07:00'
     reservationSubBlockCount: 2
     reservationSubBlockInUseCount: 2
     selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001
     selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309
     status: READY
     zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   Output mencakup kolom berikut untuk setiap blok:

   • count: jumlah total VM yang dapat di-deploy dalam blok.
   • healthInfo: informasi kesehatan untuk blokir sebagai berikut:
     • degradedSubBlockCount: jumlah sub-blok yang mengalami penurunan kualitas dalam blok.
     • healthStatus: status respons keseluruhan blok.
     • healthySubBlockCount: jumlah sub-blok yang sehat dalam blok.
   • inUseCount: jumlah VM yang sudah di-deploy di blok.
   • name: nama blok.
   • physicalTopology: lokasi fisik blok, yang juga muncul dalam topologi VM, sebagai berikut:
     • block: ID khusus organisasi dari blok.
     • cluster: nama global cluster.
     • instances: daftar nama dan lokasi fisik semua VM dalam blok sebagai berikut. (Kolom ini hanya muncul jika Anda menyertakan tanda --full-view=BLOCK_VIEW_FULL.)
       • instanceId: ID instance.
       • subBlock: ID khusus organisasi dari sub-blok tempat instance ini berada.
       • block: ID spesifik per organisasi dari blok tempat instance ini berada.
   • reservationSubBlockCount: jumlah sub-blok dalam blok.
   • reservationSubBlockInUseCount: jumlah sub-blok dalam blok dengan setidaknya satu VM yang sudah di-deploy.

   REST

   Anda dapat melihat blok dalam reservasi menggunakan metode berikut:

   • Untuk melihat semua blok yang tersedia dalam pemesanan, buat permintaan GET ke metode reservationBlocks.list:

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
     

   • Untuk melihat blok tertentu dalam pemesanan, buat permintaan GET ke metode reservationBlocks.get. Untuk melihat nama dan topologi semua VM yang di-deploy dalam blok, tambahkan parameter kueri ?view=FULL.

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL
     

   Ganti kode berikut:

   • PROJECT_ID: ID project tempat pemesanan berada.
   • ZONE: zona tempat pemesanan berada.
   • RESERVATION_NAME: nama pemesanan.
   • BLOCK_NAME: nama blok.

   Output untuk setiap blok mirip dengan berikut ini:

   {
     "resource": {
       "kind": "compute#reservationBlock",
       "id": "4360924059555106309",
       "creationTimestamp": "2025-08-04T15:15:07.074-07:00",
       "name": "example-res1-block-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309",
       "count": 36,
       "inUseCount": 35,
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "instances": [
           {
             "instanceId": "5815586279631866288",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c02af6bdaeccacef571e0adbe79e8c28",
               "host": "c229b308380a83e0ca345d4a0de05aa7"
             }
           },
           ...
           {
             "instanceId": "8389759878923049076",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c081876ba0aa2857d608eb30a5b2fa40",
               "host": "3ac534f00c20e6e0c87c3aaff2705be6"
             }
           }
         ]
       },
       "reservationSubBlockCount": 2,
       "reservationSubBlockInUseCount": 2,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthySubBlockCount": 0,
         "degradedSubBlockCount": 2
       }
     }
   }
   

   Output mencakup kolom berikut untuk setiap blok:

   • name: nama blok.
   • count: jumlah total VM yang dapat di-deploy dalam blok.
   • inUseCount: jumlah VM yang sudah di-deploy di blok.
   • physicalTopology: lokasi fisik blok, yang juga muncul di topologi VM, sebagai berikut:
     • cluster: nama global cluster.
     • block: ID khusus organisasi dari blok.
     • instances: daftar nama dan lokasi fisik semua VM dalam blok sebagai berikut. (Kolom ini hanya muncul saat Anda menyertakan parameter kueri ?view=FULL.)
       • instanceId: ID instance.
       • subBlock: ID khusus organisasi dari sub-blok tempat instance ini berada.
       • block: ID spesifik per organisasi dari blok tempat instance ini berada.
   • reservationSubBlockCount: jumlah sub-blok dalam blok.
   • reservationSubBlockInUseCount: jumlah sub-blok dalam blok dengan setidaknya satu VM yang sudah di-deploy.
   • healthInfo: informasi kesehatan untuk blokir sebagai berikut:
     • healthStatus: status respons keseluruhan blok.
     • healthySubBlockCount: jumlah sub-blok yang sehat dalam blok.
     • degradedSubBlockCount: jumlah sub-blok yang mengalami penurunan kualitas dalam blok.

   Melihat sub-blok yang dicadangkan

   Untuk mencantumkan dan menjelaskan sub-blok yang tersedia dalam blok pemesanan, gunakan Google Cloud CLI atau REST API. Tugas ini membantu Anda menentukan hal berikut:

   • Sub-blok kapasitas mana yang ada di blok yang dicadangkan.
   • Berapa banyak kapasitas yang tersedia di setiap sub-blok.
   • Kondisi setiap sub-blok, termasuk jumlah mesin host yang berfungsi dengan baik dan jumlah interkoneksi akselerator yang berfungsi dengan baik.

   gcloud

   Anda dapat melihat sub-blok dalam reservasi menggunakan perintah berikut:

   • Untuk melihat semua sub-blok yang tersedia dalam blok pemesanan, gunakan perintah gcloud compute reservations sub-blocks list:

     gcloud compute reservations sub-blocks list RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME
     

   • Untuk melihat sub-blok tertentu dalam blok pemesanan, gunakan perintah gcloud compute reservations sub-blocks describe:

     gcloud compute reservations sub-blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --sub-block-name=SUB-BLOCK_NAME
     

   Ganti kode berikut:

   • RESERVATION_NAME: nama pemesanan.
   • ZONE: zona tempat pemesanan berada.
   • BLOCK_NAME: nama blok.
   • SUB-BLOCK_NAME: nama sub-blok.

   Output untuk setiap sub-blok mirip dengan berikut ini:

   count: 18
   creationTimestamp: '2025-07-18T14:50:01.652-07:00'
   healthInfo:
     degradedHostCount: 0
     degradedInfraCount: 0
     healthStatus: HEALTHY
     healthyHostCount: 18
     healthyInfraCount: 1
   id: '6848013619223297894'
   inUseCount: 2
   kind: compute#reservationSubBlock
   name: example-res1-block-0001-subblock-0001
   physicalTopology:
     block: 2b6aa63faa2b60b7ecd3b87ec337f270
     cluster: us-central1-cluster-xvhj
     subBlock: 556a310b49a0b247bc109cc7f997cea2
   reservationSubBlockMaintenance:
     schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/6848013619223297894
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   Output mencakup kolom berikut untuk setiap sub-blok:

   • count: jumlah total VM yang dapat di-deploy di sub-blok.
   • healthInfo: informasi kesehatan untuk sub-blok sebagai berikut:
     • degradedHostCount: jumlah mesin host yang mengalami penurunan kualitas dalam sub-blok.
     • degradedInfraCount: jumlah interkoneksi akselerator yang mengalami penurunan kualitas di sub-blok.
     • healthStatus: status keseluruhan kondisi sub-blok.
     • healthyHostCount: jumlah mesin host yang berfungsi dengan baik dalam sub-blok.
     • healthyInfraCount: jumlah interkoneksi akselerator yang berfungsi baik dalam sub-blok.
   • inUseCount: jumlah VM yang sudah di-deploy di sub-blok.
   • name: nama sub-blok.
   • physicalTopology: lokasi fisik sub-blok, yang juga muncul di topologi VM, sebagai berikut:
     • block: ID khusus organisasi dari blok.
     • cluster: nama global cluster.
     • subblock: ID khusus organisasi dari sub-blok.

   REST

   Anda dapat melihat sub-blok dalam reservasi menggunakan metode berikut:

   • Untuk melihat semua sub-blok yang tersedia dalam blok pemesanan, buat permintaan GET ke metode reservationSubBlocks.list:

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
     

   • Untuk melihat sub-blok tertentu dalam blok pemesanan, buat permintaan GET ke reservationSubBlocks.get metode:

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME
     

   Ganti kode berikut:

   • PROJECT_ID: ID project tempat pemesanan berada.
   • ZONE: zona tempat pemesanan berada.
   • RESERVATION_NAME: nama pemesanan.
   • BLOCK_NAME: nama blok.
   • SUB-BLOCK_NAME: nama sub-blok.

   Output untuk setiap sub-blok mirip dengan berikut ini:

   {
     "resource": {
       "kind": "compute#reservationSubBlock",
       "id": "5679680646666817028",
       "creationTimestamp": "2025-08-04T15:15:07.625-07:00",
       "name": "example-res1-block-0001-subblock-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/5679680646666817028",
       "count": 18,
       "inUseCount": 18,
       "reservationSubBlockMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 16,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 15
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "subBlock": "c081876ba0aa2857d608eb30a5b2fa40"
       },
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyHostCount": 16,
         "degradedHostCount": 2,
         "healthyInfraCount": 1,
         "degradedInfraCount": 0
       }
     }
   }
   

   Output mencakup kolom berikut untuk setiap sub-blok:

   • name: nama sub-blok.
   • count: jumlah total VM yang dapat di-deploy di sub-blok.
   • inUseCount: jumlah VM yang sudah di-deploy di sub-blok.
   • physicalTopology: lokasi fisik sub-blok, yang juga muncul di topologi VM, sebagai berikut:
     • cluster: nama global cluster.
     • block: ID khusus organisasi dari blok.
     • subblock: ID khusus organisasi dari sub-blok.
   • healthInfo: informasi kesehatan untuk sub-blok sebagai berikut:
     • healthStatus: status keseluruhan kondisi sub-blok.
     • healthyHostCount: jumlah mesin host yang berfungsi dengan baik dalam sub-blok.
     • degradedHostCount: jumlah mesin host yang mengalami penurunan kualitas dalam sub-blok.
     • healthyInfraCount: jumlah interkoneksi akselerator yang berfungsi baik dalam sub-blok.
     • degradedInfraCount: jumlah interkoneksi akselerator yang mengalami penurunan kualitas di sub-blok.

   Langkah berikutnya

   • Ringkasan pembuatan VM dan cluster
   • Melihat pemakaian reservasi
   Kirim masukan