Membatalkan atau menghapus permintaan pemesanan untuk masa mendatang

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 dibagikan oleh permintaan tersebut, hingga Anda menghapusnya. Untuk mengetahui informasi selengkapnya, lihat Pembatasan pembuatan.

• Menghapus permintaan pemesanan untuk masa mendatang. Hal ini berguna jika Anda tidak lagi memerlukan permintaan. Menghapus permintaan pemesanan untuk masa mendatang secara permanen akan menghapusnya dan menghapus batasan apa pun pada pembuatan permintaan baru.

Setelah pemesanan untuk masa mendatang yang dipenuhi mencapai akhir periode pemesanannya, Anda dapat menghapusnya untuk menghapus batasan dalam membuat permintaan baru. Namun, menghapus pemesanan untuk masa mendatang yang telah 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 yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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. Menginstal Google Cloud CLI. Setelah penginstalan, lakukan 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, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

  Menginstal Google Cloud CLI. Setelah penginstalan, lakukan 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 membatalkan atau menghapus permintaan pemesanan untuk masa mendatang, minta administrator Anda 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 pemesanan untuk masa mendatang. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

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

Membatalkan permintaan pemesanan untuk masa mendatang

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

• Permintaan menunggu persetujuan atau telah ditolak.

• Permintaan disetujui, tetapi statusnya belum berubah menjadi PROCURING.

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

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

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

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

Membatalkan permintaan pemesanan untuk masa mendatang

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

• Permintaan belum mencapai waktu pengunciannya (PROCURING) 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 telah dipenuhi 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 konsolGoogle Cloud . Atau, untuk menghapus satu permintaan pemesanan untuk masa mendatang, pilih salah satu opsi berikut:

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

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

Langkah berikutnya

• Pelajari cara melihat permintaan pemesanan untuk masa mendatang.