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 pengunciannya, Anda dapat mencegah Compute Engine menyediakan resource yang diminta dengan melakukan salah satu hal berikut:

• Membatalkan permintaan pemesanan untuk masa mendatang. Tindakan 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 pada pembuatan.

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

Setelah pemesanan untuk masa mendatang yang terpenuhi mencapai akhir periode pemesanannya, Anda dapat menghapusnya untuk menghapus batasan apa pun pada pembuatan 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

• Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

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

  Konsol

  Saat menggunakan Google Cloud konsol untuk mengakses Google Cloud layanan dan API, Anda tidak perlu menyiapkan autentikasi.

  gcloud

  1. Instal Google Cloud CLI. Setelah penginstalan, 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 .

     Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
• Tetapkan 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.

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 memberikan peran IAM Admin Pemesanan untuk Masa Mendatang Compute (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, perluas 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 permintaan pemesanan untuk masa mendatang dalam kasus berikut:

• Permintaan sedang 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.

Penting: Selama permintaan yang dibatalkan ada, permintaan tersebut akan mencegah Anda membuat permintaan baru dengan properti yang cocok dengan permintaan yang dibatalkan di project Anda, atau di project mana pun yang dibagikan oleh 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 compute future-reservations cancel.

gcloud 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 POST permintaan ke futureReservations.cancel metode.

POST https://compute.googleapis.com/compute/v1/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.

Menghapus 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 tersebut 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 Google Cloud konsol. Jika tidak, untuk menghapus satu permintaan pemesanan untuk masa mendatang, pilih salah satu opsi berikut:

Konsol

1. Di Google Cloud konsol, buka halaman Reservations.

   Buka Reservations

2. Klik tab Future reservations.

3. Pilih setiap permintaan pemesanan untuk masa mendatang yang ingin Anda hapus.

4. Klik Hapus reservasi.

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

gcloud 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 futureReservations.delete.

DELETE https://compute.googleapis.com/compute/v1/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.