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 dipenuhi 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 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 memberikan 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:

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

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 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:

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Pemesanan

  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