Melihat permintaan pemesanan untuk masa mendatang

Dokumen ini menjelaskan cara melihat permintaan pemesanan untuk masa mendatang.

Melihat permintaan pemesanan untuk masa mendatang berguna untuk mendapatkan ringkasan semua permintaan pemesanan untuk masa mendatang dalam project Anda, dan untuk meninjau detail konfigurasi permintaan pemesanan untuk masa mendatang. Jika ingin melihat permintaan pemesanan untuk masa mendatang bersama, Anda hanya dapat melihatnya menggunakan project pemilik.

Untuk melihat pemesanan yang dibuat otomatis yang disediakan untuk pemesanan untuk masa mendatang, lihat Melihat pemesanan.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

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

      gcloud init
    2. Set a default region and zone.

      3. REST

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

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

        gcloud init

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat permintaan pemesanan untuk masa mendatang, minta administrator untuk memberi Anda peran IAM Compute Future Reservation Viewer (roles/compute.futureReservationViewer) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk melihat permintaan pemesanan untuk masa mendatang. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat permintaan pemesanan untuk masa mendatang:

  • Untuk melihat daftar pemesanan untuk masa mendatang: compute.futureReservations.list pada project
  • Untuk melihat detail pemesanan untuk masa mendatang: compute.futureReservations.get pada project

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

Melihat permintaan pemesanan untuk masa mendatang

Berdasarkan detail yang ingin Anda lihat dalam permintaan reservasi untuk masa mendatang, gunakan salah satu metode berikut:

Melihat daftar permintaan pemesanan untuk masa mendatang

Saat melihat daftar permintaan pemesanan untuk masa mendatang, Anda dapat menggunakan ekspresi filter untuk mempersempit hasil. Untuk ekspresi filter yang lebih canggih, gunakan gcloud CLI atau REST.

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

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Future reservations.

    Dalam tabel, setiap baris menjelaskan permintaan pemesanan untuk masa mendatang dan setiap kolom mendeskripsikan properti. Misalnya, kolom Total count menjelaskan kapasitas yang dipesan untuk setiap permintaan pemesanan untuk masa mendatang.

  3. Opsional: Untuk memfilter permintaan pemesanan untuk masa mendatang yang ditampilkan dalam tabel, lakukan salah satu atau kedua hal berikut:

    • Di kolom Filter , masukkan ekspresi filter.

      Misalnya, untuk hanya melihat permintaan pemesanan untuk masa mendatang yang dibuat di zona us-central1-a atau yang mencadangkan lebih dari 10 resource, tentukan ekspresi berikut:

      Zone:us-central1-a OR Total Count>10

    • Klik Column display options, lalu pilih nilai yang Anda inginkan untuk memfilter tabel.

gcloud

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

gcloud beta compute future-reservations list

Outputnya mirip dengan hal berikut ini:

NAME: fr-04
TOTAL_COUNT: 100
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-east1-a

NAME: fr-05
TOTAL_COUNT: 10
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west1-c

Atau, untuk memfilter permintaan pemesanan untuk masa mendatang berdasarkan ekspresi filter, sertakan flag --filter.

gcloud beta compute future-reservations list \
    --filter="FILTER_EXPRESSION"

Ganti FILTER_EXPRESSION dengan ekspresi filter.

Misalnya, untuk hanya melihat pemesanan untuk masa mendatang yang dibuat di zona us-central1-a, menentukan jenis mesin n2-standard-4, dan memiliki jumlah total lebih besar dari 10, tentukan ekspresi filter berikut:

zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

REST

Untuk melihat daftar permintaan pemesanan untuk masa mendatang, buat permintaan GET ke metode beta.futureResevations.list.

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

Ganti kode berikut:

  • PROJECT_ID: ID project tempat satu atau beberapa permintaan pemesanan untuk masa mendatang berada.

  • ZONE: zona tempat satu atau beberapa permintaan pemesanan untuk masa mendatang berada.

Outputnya mirip dengan hal berikut ini:

{
  "id": "projects/my-project/zones/us-east1-a/futureReservations",
  "items": [
    {
      "id": "743865190848184978",
      "creationTimestamp": "2025-03-23T18:16:45.274-07:00",
      "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base",
      "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978",
      "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a",
      "name": "fr-base",
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "n1-standard-1"
        },
        "totalCount": "100"
      },
      "planningStatus": "SUBMITTED",
      "timeWindow": {
        "endTime": "2025-05-02T01:00:00Z",
        "startTime": "2025-04-30T17:30:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-03-30T07:00:00Z",
        "existingMatchingUsageInfo": {
          "count": "3",
          "timestamp": "2025-03-30T01:00:00Z"
        }
      },
      "kind": "compute#futureReservation"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

Atau, untuk memfilter permintaan pemesanan untuk masa mendatang berdasarkan ekspresi filter, sertakan parameter kueri filter.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION

Ganti kode berikut:

  • PROJECT_ID: ID project tempat satu atau beberapa permintaan pemesanan untuk masa mendatang berada.

  • FILTER_EXPRESSION: ekspresi filter yang menggunakan encoding URL.

    Misalnya, untuk hanya melihat pemesanan untuk masa mendatang yang dibuat di zona us-central1-a, mencadangkan jenis mesin n2-standard-4, dan memiliki jumlah total lebih dari sepuluh, tentukan ekspresi filter berikut:

    zone=us-central1-a%20AND%20specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10

    Perhatikan bahwa ekspresi filter yang dienkode ke URL mewakili ekspresi filter yang didekode berikut:

    zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

Melihat detail permintaan pemesanan untuk masa mendatang

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

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Future reservations.

  3. Di kolom Name, klik nama permintaan pemesanan untuk masa mendatang yang ingin Anda lihat detailnya.

    Halaman Future reservations yang berisi detail permintaan pemesanan untuk masa mendatang akan terbuka.

gcloud

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

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

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang yang ada.

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

Outputnya mirip dengan hal berikut ini:

autoCreatedReservationsDeleteTime: '2025-05-02T01:00:00Z'
creationTimestamp: '2025-03-23T10:08:31.613-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
planningStatus: SUBMITTED
selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  shareType: LOCAL
specificSkuProperties:
  instanceProperties:
    machineType: n1-standard-64
  totalCount: '800'
status:
  existingMatchingUsageInfo:
    count: '3'
    timestamp: '2025-03-30T01:00:00Z'
  lockTime: '2025-03-30T17:09:59.297799Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-05-02T01:00:00Z'
  startTime: '2025-04-30T17:30:00Z'
zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a

REST

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

GET https://compute.googleapis.com/compute/beta/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.

  • FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang yang ada.

Outputnya mirip dengan hal berikut ini:

{
  "autoCreatedReservationsDeleteTime": "2025-05-02T01:00:00Z",
  "creationTimestamp": "2025-03-23T10:08:31.613-07:00",
  "id": "5212276518668495076",
  "kind": "compute#futureReservation",
  "name": "fr-01",
  "planningStatus": "SUBMITTED",
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01",
  "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-64"
    },
    "totalCount": "800"
  },
  "status": {
    "lockTime": "2025-03-30T17:09:59.297799Z",
    "procurementStatus": "APPROVED",
    "existingMatchingUsageInfo": {
      "count": "3",
      "timestamp": "2025-03-30T01:00:00Z"
    }
  },
  "timeWindow": {
    "endTime": "2025-05-02T01:00:00Z",
    "startTime": "2025-04-30T17:30:00Z"
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a"
}

Menentukan jumlah VM yang disediakan

Setelah membuat permintaan pemesanan untuk masa mendatang, Anda dapat melihat jumlah VM yang berjalan dan pemesanan yang tidak digunakan di project Anda, atau project yang dibagikan dengan permintaan pemesanan untuk masa mendatang, yang cocok dengan properti VM yang ditentukan dalam permintaan Anda. Dengan mengurangi jumlah ini dari jumlah total yang ditentukan dalam permintaan, Anda dapat menentukan jumlah VM yang akan disediakan Compute Engine setelah permintaan Anda disetujui dan mencapai waktu mulainya.

Untuk menentukan jumlah VM yang disediakan untuk beberapa permintaan pemesanan mendatang secara bersamaan, gunakan konsol Google Cloud. Atau, untuk menentukan jumlah VM yang disediakan untuk satu permintaan, pilih salah satu opsi berikut:

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Future reservations.

  3. Untuk setiap permintaan pemesanan untuk masa mendatang, Anda dapat menentukan hal berikut:

    • Di kolom Total count, jumlah total permintaan.

    • Di kolom Matching count, jumlah VM yang berjalan dan pemesanan yang properti VM-nya cocok dengan permintaan.

    Dengan mengurangi nilai di kolom Matching count dari nilai di kolom Total count, Anda dapat menentukan jumlah VM yang akan disediakan Compute Engine untuk permintaan pemesanan mendatang pada waktu mulainya. Jika Anda melihat peringatan di kolom Jumlah pencocokan, hal ini disebabkan oleh salah satu hal berikut:

    • Nilai Jumlah pencocokan adalah nol. Dalam hal ini, tidak ada VM atau pemesanan yang berjalan yang cocok di project Anda.

    • Nilai Jumlah pencocokan sama dengan Jumlah total. Dalam hal ini, Compute Engine tidak akan menyediakan VM yang direservasi untuk permintaan pemesanan untuk masa mendatang .

    Jika Anda mengubah permintaan pemesanan untuk masa mendatang, atau membuat VM atau pemesanan baru dengan properti VM yang cocok dengan permintaan, Compute Engine akan memperbarui nilai di kolom Jumlah yang cocok dalam waktu 30 menit. Untuk memverifikasi kapan kolom Jumlah pencocokan terakhir diperbarui, lihat detail permintaan, lalu periksa nilai di baris Waktu evaluasi penggunaan pencocokan terakhir.

  4. Opsional: Untuk mengubah jumlah VM yang direservasi dalam permintaan pemesanan untuk masa mendatang, ubah permintaan pemesanan untuk masa mendatang.

gcloud

  1. Lihat detail permintaan pemesanan untuk masa mendatang.

  2. Dalam output, kurangi nilai kolom existingMatchingUsageInfo dari kolom totalCount. Jika nilai existingMatchingUsageInfo.count sama dengan totalCount, Compute Engine tidak akan menyediakan VM yang direservasi untuk permintaan pemesanan untuk masa mendatang.

    Jika Anda mengubah permintaan pemesanan untuk masa mendatang, atau membuat VM atau pemesanan baru dengan properti VM yang cocok dengan permintaan, Compute Engine akan memperbarui kolom existingMatchingUsageInfo dalam waktu 30 menit. Untuk memverifikasi kapan kolom terakhir diperbarui, periksa nilai kolom existingMatchingUsageInfo.timestamp.

  3. Opsional: Untuk mengubah jumlah VM yang direservasi dalam permintaan pemesanan untuk masa mendatang, ubah permintaan pemesanan untuk masa mendatang.

REST

  1. Lihat detail permintaan pemesanan untuk masa mendatang.

  2. Dalam output, kurangi nilai kolom existingMatchingUsageInfo dari kolom totalCount. Jika nilai existingMatchingUsageInfo.count sama dengan totalCount, Compute Engine tidak akan menyediakan VM yang direservasi untuk permintaan pemesanan untuk masa mendatang.

    Jika Anda mengubah permintaan pemesanan untuk masa mendatang, atau membuat VM atau pemesanan baru dengan properti VM yang cocok dengan permintaan, Compute Engine akan memperbarui kolom existingMatchingUsageInfo dalam waktu 30 menit. Untuk memverifikasi kapan kolom terakhir diperbarui, periksa nilai kolom existingMatchingUsageInfo.timestamp.

  3. Opsional: Untuk mengubah jumlah VM yang direservasi dalam permintaan pemesanan untuk masa mendatang, ubah permintaan pemesanan untuk masa mendatang.

Langkah selanjutnya