Melihat permintaan pemesanan untuk masa mendatang

Dokumen ini menjelaskan cara melihat permintaan pemesanan untuk masa mendatang.

Untuk melihat pemesanan lainnya, termasuk yang dibuat otomatis untuk pemesanan untuk masa mendatang guna menyediakan resource yang dipesan, lihat Melihat pemesanan.

Sebelum memulai

Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol

Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
gcloud
1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
  gcloud init
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
2. Menetapkan region dan zona default.
REST

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna melihat permintaan reservasi pada masa mendatang, minta administrator untuk memberi Anda peran IAM Compute Future Reservasi Viewer (roles/compute.futureReservationViewer) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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 yang telah ditetapkan sebelumnya.

Melihat permintaan pemesanan untuk masa mendatang

Untuk melihat permintaan pemesanan untuk masa mendatang dalam project yang ditentukan, pilih salah satu metode berikut:

Lihat daftar permintaan pemesanan untuk masa mendatang.

Bagian ini menjelaskan cara melihat daftar semua permintaan pemesanan untuk masa mendatang yang masih berbentuk draf atau telah dikirimkan dalam project tertentu. Anda juga dapat menggunakan filter untuk mempersempit hasil berdasarkan satu atau beberapa atribut.
Lihat detail permintaan pemesanan untuk masa mendatang.

Bagian ini menjelaskan cara melihat detail permintaan pemesanan untuk masa mendatang, seperti project yang dibagikan kepada pemesanan untuk masa mendatang atau waktu mulai periode pemesanannya.

Melihat daftar permintaan pemesanan untuk masa mendatang

Anda dapat melihat daftar permintaan reservasi mendatang dalam project tertentu menggunakan Konsol Google Cloud, gcloud CLI, dan REST.

Konsol

Untuk melihat daftar permintaan pemesanan untuk masa mendatang, ikuti langkah-langkah berikut:

Di Konsol Google Cloud, buka halaman Reservations.

Buka Reservations
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.
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 \
    --project=PROJECT_ID

Ganti PROJECT_ID dengan ID project tempat satu atau beberapa permintaan pemesanan untuk masa mendatang berada. Jika Anda menghapus tanda --project, ID project saat ini akan digunakan.

Outputnya mirip dengan hal berikut ini:

NAME          TOTAL_COUNT    START_TIME             END_TIME               PROCUREMENT_STATUS   ZONE
fr-04         100            2025-07-20T07:00:00Z   2025-08-05T07:00:00Z   FULFILLED            us-east1-a
fr-05         10             2025-11-15T00:00:00Z   2025-12-01T00:00:00Z   PENDING_APPROVAL     us-west1-c

Secara opsional, Anda dapat menentukan flag --filter untuk melihat daftar pemesanan untuk masa mendatang yang difilter berdasarkan ekspresi filter.

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

Ganti kode berikut:

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:
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
```
PROJECT_ID: Opsional. ID project tempat satu atau beberapa permintaan pemesanan untuk masa mendatang berada. Jika Anda menghilangkan flag --project, ID project saat ini akan digunakan.

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-04-11T18: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": {
        "startTime": "2025-07-20T07:00:00Z",
        "endTime": "2025-08-05T07:00:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-05-04T07:00:00Z",
        "fulfilledCount": "100"
      },
      "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"
}

Secara opsional, Anda dapat menentukan parameter kueri filter untuk melihat daftar pemesanan untuk masa mendatang yang difilter berdasarkan ekspresi 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:
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10%20AND%20zone=us-central1-a
```
Perhatikan bahwa ekspresi filter yang dienkode ke URL mewakili ekspresi filter yang didekode berikut:
```
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
```

Melihat detail permintaan pemesanan untuk masa mendatang

Anda dapat melihat detail permintaan reservasi pada masa mendatang menggunakan Google Cloud Console, gcloud CLI, dan REST.

Konsol

Untuk melihat detail permintaan pemesanan untuk masa mendatang, ikuti langkah-langkah berikut:

Di Konsol Google Cloud, buka halaman Reservations.

Buka Reservations
Klik tab Future reservations.
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 \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti kode berikut:

FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang yang ada.
PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang berada. Jika Anda menghilangkan flag --project, ID project saat ini akan digunakan.
ZONE: zona tempat permintaan pemesanan untuk masa mendatang berada.

Outputnya mirip dengan hal berikut ini:

creationTimestamp: '2025-07-19T12:44:11.855-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
namePrefix: test-fr
selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  projects:
  - 'project-02'
  shareType: SPECIFIC_PROJECTS
specificSkuProperties:
  instanceProperties:
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-64
    minCpuPlatform: Intel Skylake
  totalCount: '800'
planningStatus: SUBMITTED
status:
  lockTime: '2025-08-25T00:00:00Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-12-10T00:00:00Z'
  startTime: '2025-11-10T00:00:00Z'
zone: https://www.googleapis.com/compute/beta/projects/project-01/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/reservations/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:

{
  "creationTimestamp": "2025-04-11T18:16:45.274-07:00",
  "id": "743865190848184978",
  "name": "fr-01",
  "namePrefix": "test-fr",
  "kind": "compute#futureReservation",
  "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",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-1"
    },
    "totalCount": "100"
  },
  "planningStatus": "SUBMITTED",
  "timeWindow": {
    "endTime": "2025-08-05T07:00:00Z",
    "startTime": "2025-07-20T07:00:00Z"
  },
  "status": {
    "fulfilledCount": "100"
    "lockTime": "2025-05-04T07:00:00Z",
    "procurementStatus": "FULFILLED",
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a"
}

Langkah selanjutnya

Pelajari cara mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang.
Setelah mencapai waktu mulai periode pemesanan, pelajari cara menggunakan pemesanan yang dibuat otomatis.
Setelah periode pemesanan Anda berakhir, pelajari cara melakukan hal berikut:
- Mengubah pemesanan yang dibuat otomatis.
- Menghapus pemesanan yang dibuat otomatis.