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 dipesan, Anda dapat merencanakan kapasitas yang dipesan untuk beban kerja Anda.

Cakupan dokumen ini terbatas pada beban kerja 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 Compute Engine yang dipesan ke reservasi. Kemudian, Anda dapat mulai menggunakan reservasi dengan membuat instance komputasi yang cocok dengan reservasi.
• 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. Kapasitas cadangan: 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. Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

   Konsol

   Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

   gcloud

   Di konsol Google Cloud , aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

   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.

   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 salah 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 Anda pesan.

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 Name, klik nama permintaan. Halaman yang memberikan detail permintaan pemesanan untuk masa mendatang akan terbuka.

gcloud

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

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 workload.
• 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 dipesan di project Anda dan memeriksa kapasitas yang dipesan yang tidak digunakan, lihat daftar reservasi Anda.
• Untuk meninjau properti dan ketersediaan semua VM yang dipesan untuk suatu reservasi, lihat detail reservasi.
• Untuk memahami cara blok dan sub-blok kapasitas untuk pemesanan diatur, 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 dicadangkan 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 instance komputasi mana yang ada dalam reservasi.
• Jumlah instance komputasi yang dipesan dan tersedia dalam reservasi.
• 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 reservasi.
• assuredCount: jumlah total VM yang dapat di-deploy menggunakan reservasi. Jika nilai ini kurang dari count, lihat cara memecahkan masalah VM yang tersedia untuk konsumsi lebih sedikit.
• inUseCount: jumlah VM yang sudah di-deploy dalam reservasi.
• instanceProperties: properti VM yang dapat di-deploy ke reservasi.

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 instance komputasi yang dapat di-deploy dalam reservasi.
• inUseCount: jumlah instance komputasi yang sudah di-deploy dalam reservasi.
• assuredCount: jumlah total instance komputasi yang dapat di-deploy menggunakan reservasi. Jika nilai ini kurang dari count, lihat cara memecahkan masalah lebih sedikit VM yang tersedia untuk digunakan.
• 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 pemesanan untuk membantu Anda memutuskan tempat membuat instance komputasi dalam blok dan sub-blok yang dipesan. Untuk mengetahui informasi tentang penempatan instance komputasi yang dipesan dan 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.
• Kondisi setiap blok, termasuk jumlah sub-blok yang sehat. (Hanya tersedia dengan menggunakan gcloud CLI atau REST.)
• Nama, blok, dan sub-blok dari semua instance komputasi 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: total jumlah instance komputasi yang dapat di-deploy di blok.
   • Digunakan: jumlah instance komputasi yang sudah di-deploy dalam 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 instance komputasi 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 instance komputasi yang dapat di-deploy dalam blok.
• healthInfo: informasi kesehatan untuk blok 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 instance komputasi yang sudah di-deploy dalam blok.
• name: nama blok.
• physicalTopology: lokasi fisik blok, yang juga muncul di topologi instance komputasi, sebagai berikut:
  • block: ID khusus organisasi dari blok.
  • cluster: nama global cluster.
  • instances: daftar nama dan lokasi fisik semua instance komputasi dalam blok sebagai berikut. (Kolom ini hanya muncul jika Anda menyertakan flag --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 instance komputasi 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 instance komputasi 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 instance komputasi yang dapat di-deploy dalam blok.
• inUseCount: jumlah instance komputasi yang sudah di-deploy di blok.
• physicalTopology: lokasi fisik blok, yang juga muncul di topologi instance komputasi, sebagai berikut:
  • cluster: nama global cluster.
  • block: ID khusus organisasi dari blok.
  • instances: daftar nama dan lokasi fisik semua instance komputasi 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 komputasi ini berada.
    • block: ID khusus organisasi dari blok tempat instance komputasi ini berada.
• reservationSubBlockCount: jumlah sub-blok dalam blok.
• reservationSubBlockInUseCount: jumlah sub-blok dalam blok dengan setidaknya satu instance komputasi yang sudah di-deploy.
• healthInfo: informasi kesehatan untuk blok sebagai berikut:
  • healthStatus: status respons keseluruhan blok.
  • healthySubBlockCount: jumlah sub-blok yang sehat dalam blok.
  • degradedSubBlockCount: jumlah sub-blok yang rusak 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 sehat dan jumlah interkoneksi akselerator yang sehat.

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 instance komputasi 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 dalam sub-blok.
  • healthStatus: status respons keseluruhan sub-blok.
  • healthyHostCount: jumlah mesin host yang sehat dalam sub-blok.
  • healthyInfraCount: jumlah interkoneksi akselerator yang berfungsi baik dalam sub-blok.
• inUseCount: jumlah instance komputasi yang sudah di-deploy di sub-blok.
• name: nama sub-blok.
• physicalTopology: lokasi fisik sub-blok, yang juga muncul di topologi instance komputasi, 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 instance komputasi yang dapat di-deploy di sub-blok.
• inUseCount: jumlah instance komputasi yang sudah di-deploy di sub-blok.
• physicalTopology: lokasi fisik sub-blok, yang juga muncul di topologi instance komputasi, 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 respons keseluruhan sub-blok.
  • healthyHostCount: jumlah mesin host yang sehat 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 instance dan cluster komputasi
• Melihat pemakaian reservasi