Melihat kapasitas yang dicadangkan

Dokumen ini menjelaskan cara melihat permintaan Anda untuk kapasitas yang dipesan dan kapasitas yang dipesan untuk cluster HPC dengan VM H4D dan kemampuan pengelolaan yang ditingkatkan. 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 cluster HPC dengan VM H4D dan kemampuan pengelolaan yang ditingkatkan, lihat Memilih opsi penggunaan dan mendapatkan 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, Compute Engine akan menambahkan instance virtual machine (VM) yang dipesan ke pemesanan. Selanjutnya, Anda dapat mulai menggunakan reservasi dengan membuat VM yang cocok dengan reservasi.

Sebelum memulai

  • Cadangkan kapasitas: Jika project Anda belum melakukannya, cadangkan kapasitas untuk instance H4D menggunakan salah satu opsi berikut:

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. 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. 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.

    2. Set a default region and zone.

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

Batasan

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

Melihat permintaan Anda untuk kapasitas yang dicadangkan

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

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:

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": "h4d-standard-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "8"
      },
      "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/us-central1-a/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "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 parameter kueri filter.

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": "h4d-standard-192"
    },
    "totalCount": "8"
  },
  "kind": "compute#futureReservation",
  "id": "7201773389437194422",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7201773389437194422",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "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": "GROUPED",
  "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 dikelola, 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 pemesanan 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:

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-west4-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "h4d-highmem-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
        },
        "totalCount": "8"
      },
      "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-west4-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-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": "GROUPED",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

Jika Anda ingin mempersempit 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 reservasi.

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: HIGHLY_AVAILABLE_CAPACITY
creationTimestamp: '2025-11-20T15:49:02.541-07:00'
deleteAtTime: '2026-01-31T07:00:00Z'
deploymentType: DENSE
id: '5555834036379788721'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '8'
  count: '8'
  inUseCount: '0'
  instanceProperties:
    machineType: h4d-highmem-192
    minCpuPlatform: Any CPU Platform
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.
  • 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 lebih sedikit VM yang tersedia untuk konsumsi.
  • 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 reservasi berada.
  • ZONE: zona tempat pemesanan berada.
  • RESERVATION_NAME: nama pemesanan.

Outputnya mirip dengan hal berikut ini:

{
  "specificReservation": {
    "instanceProperties": {
      "machineType": "h4d-highmem-192-lssd",
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        }
      ]
    },
    "count": "8",
    "inUseCount": "0",
    "assuredCount": "8"
  },
  "kind": "compute#reservation",
  "id": "5555834036379788721",
  "creationTimestamp": "2025-11-20T15:49:02.541-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": "LOCAL"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "schedulingType": "INDEPENDENT"
    },
    "reservationBlockCount": 1
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "HIGHLY_AVAILABLE_CAPACITY"
  },
  "schedulingType": "INDEPENDENT",
  "deleteAtTime": "2026-01-31T07: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 lebih sedikit VM yang tersedia untuk konsumsi.
  • name: nama pemesanan.

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 sudah di-deploy dan dicadangkan, lihat Melihat topologi cluster H4D.

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.
  • 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 reservasi, 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'
  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.
  • inUseCount: jumlah VM yang sudah di-deploy di blok.
  • name: nama blok.
  • physicalTopology: lokasi fisik blok, yang juga muncul di 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 minimal 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
  }
}

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 Melihat topologi cluster H4D, 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 minimal satu VM yang sudah di-deploy.

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.

gcloud

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

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'
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.
  • 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"
    }
  }
}

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.

Langkah berikutnya