Membatalkan atau menghapus permintaan reservasi di 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 reservasi di masa mendatang.

Sebelum permintaan reservasi mendatang mencapai waktu kunci, Anda dapat mencegah Compute Engine menyediakan resource yang diminta dengan melakukan salah satu hal berikut:

• Membatalkan permintaan reservasi mendatang. Hal ini berguna untuk menjaga membatalkan permintaan referensi saat membuat permintaan baru. Namun, permintaan reservasi mendatang yang dibatalkan mencegah Anda membuat permintaan baru dengan properti yang cocok dengan permintaan yang dibatalkan di project Anda, atau di project yang diajak berbagi permintaan, sampai Anda menghapusnya. Untuk selengkapnya informasi, lihat Batasan pembuatan.

• Hapus permintaan reservasi mendatang. Hal ini berguna saat Anda tidak lagi memerlukan permintaan. Menghapus permintaan pemesanan untuk masa mendatang akan menghapusnya secara permanen dan menghapus semua batasan pembuatan 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 reservasi yang dibuat otomatis setelah periode reservasinya berakhir, lihat Menghapus reservasi.

Sebelum memulai

• Jika Anda belum melakukannya, siapkan autentikasi. Authentication adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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.

  Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

  gcloud init

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 bawaan ini berisi izin yang diperlukan untuk membatalkan atau menghapus permintaan reservasi di 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 reservasi mendatang dalam kasus berikut:

• Permintaan tersebut sedang menunggu persetujuan atau telah ditolak.

• Permintaan disetujui, tetapi belum mencapai waktu kunci.

Setelah membatalkan permintaan reservasi di masa mendatang, Anda hanya dapat melihat detail permintaan atau hapus.

Penting: Selama ada permintaan yang dibatalkan, Anda tidak akan dapat membuat permintaan baru dengan properti yang cocok dengan permintaan yang dibatalkan dalam project Anda, atau dalam project mana pun yang menerima permintaan yang dibatalkan. Untuk membuat permintaan baru dengan properti yang sesuai dengan permintaan yang dibatalkan, hapus permintaan yang dibatalkan sebelum membuat yang baru satu.

Untuk membatalkan permintaan reservasi pada 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 masa depan permintaan reservasi.

Membatalkan permintaan pemesanan untuk masa mendatang

Anda hanya dapat menghapus permintaan reservasi mendatang dalam kasus berikut:

• Permintaan belum mencapai waktu kunci dan tidak menunggu persetujuan.

• Permintaan terpenuhi dan periode reservasinya telah berakhir.

Untuk menghapus permintaan reservasi pada 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 reservasi mendatang secara bersamaan, gunakan Konsol Google Cloud Anda. Jika tidak, untuk menghapus satu permintaan reservasi di 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 reservasi 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.