Membatalkan atau menghapus permintaan pemesanan untuk masa mendatang

---

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dokumen ini menjelaskan cara membatalkan atau menghapus permintaan pemesanan untuk masa mendatang.

Sebelum permintaan pemesanan untuk masa mendatang mencapai waktu penguncian, Anda dapat mencegah Compute Engine menyediakan resource yang diminta dengan melakukan salah satu hal berikut:

• Batalkan permintaan pemesanan untuk masa mendatang. Hal ini berguna untuk menyimpan permintaan yang dibatalkan sebagai referensi saat membuat permintaan baru. Namun, permintaan pemesanan untuk masa mendatang yang dibatalkan akan mencegah Anda membuat permintaan baru dengan properti yang cocok dengan permintaan yang dibatalkan di project Anda, atau di project yang digunakan bersama dengan permintaan tersebut, hingga Anda menghapusnya. Untuk mengetahui informasi selengkapnya, lihat Pembatasan pembuatan.

• Hapus permintaan pemesanan untuk masa mendatang. Hal ini berguna saat Anda tidak lagi memerlukan permintaan. Menghapus permintaan pemesanan untuk masa mendatang akan menghapusnya secara permanen dan menghapus batasan apa pun dalam membuat permintaan baru.

Setelah pemesanan untuk masa mendatang yang terpenuhi mencapai akhir periode pemesanannya, Anda dapat menghapusnya untuk menghapus batasan apa pun dalam membuat permintaan baru. Namun, menghapus pemesanan untuk masa mendatang yang terpenuhi tidak akan menghapus pemesanan yang dibuat otomatis. Untuk menghapus pemesanan yang dibuat otomatis setelah periode pemesanannya berakhir, lihat Menghapus 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

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  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.

  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 membatalkan atau menghapus permintaan pemesanan untuk masa mendatang, minta administrator untuk memberi Anda peran IAM Compute Future Reservation Admin (roles/compute.futureReservationAdmin) 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 membatalkan atau menghapus permintaan pemesanan untuk masa mendatang. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membatalkan atau menghapus permintaan pemesanan untuk masa mendatang:

• Untuk membatalkan pemesanan untuk masa mendatang: compute.futureReservations.cancel di project
• Untuk menghapus pemesanan untuk masa mendatang: compute.futureReservations.delete pada project

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

Membatalkan permintaan pemesanan untuk masa mendatang

Anda hanya dapat membatalkan pemesanan untuk masa mendatang dalam kasus berikut:

• Permintaan ini menunggu persetujuan atau telah ditolak.

• Permintaan disetujui, tetapi belum mencapai waktu penguncian.

Setelah membatalkan permintaan pemesanan untuk masa mendatang, Anda hanya dapat melihat detail permintaan atau menghapusnya.

Penting: Selama permintaan yang dibatalkan ada, Anda tidak dapat membuat permintaan baru dengan properti yang cocok dengan permintaan yang dibatalkan di project, atau di project mana pun yang dibagikan dengan permintaan yang dibatalkan. Untuk membuat permintaan baru dengan properti yang cocok dengan permintaan yang dibatalkan, hapus permintaan yang dibatalkan sebelum membuat permintaan baru.

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

gcloud

Untuk membatalkan permintaan pemesanan untuk masa mendatang, gunakan perintah gcloud beta compute future-reservations cancel.

gcloud beta compute future-reservations cancel 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.

REST

Untuk membatalkan permintaan pemesanan untuk masa mendatang, buat permintaan POST ke metode beta.futureReservations.cancel.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel

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.

Membatalkan permintaan pemesanan untuk masa mendatang

Anda hanya dapat menghapus permintaan pemesanan untuk masa mendatang dalam kasus berikut:

• Permintaan belum mencapai waktu penguncian dan tidak menunggu persetujuan.

• Permintaan telah dipenuhi dan periode pemesanannya telah berakhir.

Untuk menghapus permintaan pemesanan untuk masa mendatang yang menunggu persetujuan, Anda harus membatalkan permintaan sebelum menghapusnya.

Menghapus pemesanan untuk masa mendatang yang terpenuhi tidak akan menghapus pemesanan yang dibuat otomatis. Untuk menghapus pemesanan yang dibuat otomatis setelah periode pemesanannya berakhir, lihat Menghapus pemesanan.

Untuk menghapus beberapa permintaan pemesanan untuk masa mendatang secara bersamaan, gunakan Konsol Google Cloud. Jika tidak, untuk menghapus satu 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. Pilih setiap permintaan pemesanan untuk masa mendatang yang ingin Anda hapus.

4. Klik Hapus pemesanan.

5. Untuk mengonfirmasi, klik Hapus.

   Proses penghapusan permintaan pemesanan untuk masa mendatang dapat memerlukan waktu hingga satu menit.

gcloud

Untuk menghapus permintaan pemesanan untuk masa mendatang, gunakan perintah gcloud beta compute future-reservations delete.

gcloud beta compute future-reservations delete 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.

REST

Untuk menghapus permintaan pemesanan untuk masa mendatang, buat permintaan DELETE ke metode beta.futureReservations.delete.

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

Langkah berikutnya

• Pelajari cara melihat permintaan pemesanan untuk masa mendatang.