Mengubah pemesanan

Dokumen ini menjelaskan cara mengubah pemesanan di Compute Engine. Untuk mengubah reservasi yang dilampirkan ke komitmen, lihat Mengganti reservasi yang dilampirkan ke komitmen.

Ubah pemesanan saat kebutuhan kapasitas Anda berubah, atau saat Anda ingin memperbarui workload mana yang dapat menggunakan kapasitas yang dipesan.

Batasan

Saat Anda mengubah pemesanan, batasan berikut berlaku:

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel 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 konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal 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.

  • 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 guna mengubah pemesanan, minta administrator untuk memberi Anda peran IAM Compute Admin (roles/compute.admin) 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 mengubah pemesanan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengubah pemesanan:

  • Untuk mengubah opsi hapus otomatis dalam pemesanan, jenis pemakaian atau jenis berbagi dalam pemesanan, atau apakah tugas Vertex AI dapat menggunakan pemesanan instance komputasi dengan GPU terpasang: compute.reservations.update pada project
  • Untuk mengubah jumlah instance Compute Engine dalam pemesanan: compute.reservations.resize pada project

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

Mengubah pemesanan

Berdasarkan properti yang ingin Anda ubah dalam pemesanan, gunakan salah satu metode berikut. Jika Anda ingin mengubah properti yang tidak disebutkan dalam daftar berikut, Anda harus membuat reservasi baru dengan pembaruan yang Anda pilih, lalu menghapus reservasi asli jika Anda tidak lagi memerlukannya.

Mengubah jumlah instance komputasi yang dipesan dalam pemesanan

Anda dapat menambah atau mengurangi jumlah instance komputasi yang dipesan dalam pemesanan. Namun, sebelum Anda mengubah jumlah instance komputasi, pertimbangkan hal berikut untuk menghindari error:

  • Untuk meningkatkan jumlah instance komputasi dalam reservasi apa pun, pastikan Anda dapat memenuhi kondisi berikut:

  • Untuk mengurangi jumlah instance komputasi dalam pemesanan yang ditargetkan secara khusus, pastikan jumlah instance komputasi yang menggunakan pemesanan tidak melebihi jumlah baru yang lebih kecil. Jika ya, lakukan salah satu hal berikut dengan instance komputasi yang melebihi jumlah baru:

    • Menghapus instance komputasi

    • Menghentikan atau menangguhkan instance komputasi

Untuk mengubah jumlah instance komputasi yang dicadangkan dalam reservasi, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Reservations

  2. Di tab pemesanan on-demand (default), di kolom Name, klik nama pemesanan yang ingin Anda ubah. Halaman yang memberikan detail pemesanan akan terbuka.

  3. Klik Edit.

  4. Di kolom Number of VM instances, masukkan jumlah instance komputasi terbaru yang akan dipesan.

  5. Untuk mengonfirmasi, klik Save.

gcloud

Untuk mengubah jumlah instance komputasi yang dicadangkan dalam pemesanan, gunakan perintah gcloud compute reservations update.

gcloud compute reservations update RESERVATION_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: nama pemesanan.

  • NUMBER_OF_VMS: jumlah baru instance komputasi yang akan dipesan.

  • ZONE: zona tempat pemesanan berada.

REST

Untuk mengubah jumlah instance komputasi yang dicadangkan dalam pemesanan, buat permintaan POST ke metode reservations.resize.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize

{
  "specificSkuCount": "NUMBER_OF_VMS"
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat pemesanan berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan.

  • NUMBER_OF_VMS: jumlah baru instance komputasi yang akan dicadangkan.

Mengubah jenis berbagi untuk pemesanan

Anda dapat mengonversi reservasi project tunggal menjadi pemesanan bersama, atau pemesanan bersama menjadi reservasi project tunggal. Saat mengubah jenis berbagi untuk pemesanan, Anda dapat membagikan resource yang dipesan ke maksimal 100 project di organisasi Anda atau membatasi akses hanya untuk project pemilik.

Untuk membantu menghindari error saat Anda mengubah jenis berbagi untuk reservasi, sebelum Anda memulai modifikasi, pertimbangkan hal berikut:

  • Untuk mengonversi reservasi project tunggal menjadi reservasi bersama, periksa hal berikut:

  • Untuk mengonversi pemesanan bersama menjadi pemesanan project tunggal, periksa hal berikut:

    • Instance komputasi konsumen: untuk mengubah pemesanan yang ditargetkan secara khusus, Anda harus menghentikan, menangguhkan, atau menghapus instance komputasi apa pun yang menggunakan pemesanan di setiap project konsumen yang menggunakan pemesanan bersama tersebut. Persyaratan ini tidak berlaku untuk instance komputasi dalam project pemilik.

Untuk mengubah jenis berbagi untuk pemesanan, pilih salah satu opsi berikut:

gcloud

Untuk mengubah jenis berbagi untuk pemesanan, gunakan perintah gcloud compute reservations update.

Berdasarkan cara Anda ingin mengubah pemesanan, sertakan salah satu flag berikut:

  • Untuk mengonversi reservasi project tunggal menjadi reservasi bersama, sertakan flag --add-share-with dan --share-setting=projects:

    gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --share-setting=projects \
    --zone=ZONE

  • Untuk mengonversi pemesanan bersama menjadi pemesanan project tunggal, sertakan flag --share-setting=local:

    gcloud compute reservations update RESERVATION_NAME \
    --share-setting=local \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: nama pemesanan yang ingin Anda ubah.

  • CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma untuk berbagi pemesanan—misalnya, project-1,project-2. Anda dapat membagikan pemesanan ke maksimal 100 project yang berada dalam organisasi yang sama dengan project pemilik.

  • ZONE: zona tempat pemesanan berada.

REST

Untuk mengubah jenis berbagi untuk pemesanan, buat permintaan PATCH ke metode reservations.update.

Berdasarkan cara Anda ingin mengubah pemesanan, buat salah satu permintaan berikut:

  • Untuk mengonversi pemesanan satu project menjadi pemesanan bersama, buat permintaan sebagai berikut. Di URL permintaan, sertakan parameter kueri paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER untuk setiap project yang ingin Anda izinkan menggunakan pemesanan bersama ini.

    Misalnya, untuk membagikan pemesanan ke dua project, buat permintaan sebagai berikut. Anda dapat membagikan pemesanan ke maksimal 100 project yang berada dalam organisasi yang sama dengan project pemilik.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}

  • Untuk mengonversi pemesanan bersama menjadi pemesanan project tunggal, buat permintaan sebagai berikut:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.shareType

{
  "name": "RESERVATION_NAME",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat pemesanan berada (project pemilik).

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama reservasi yang ingin Anda ubah.

  • CONSUMER_PROJECT_ID_OR_NUMBER_1 dan CONSUMER_PROJECT_ID_OR_NUMBER_2: ID atau nomor dari dua project yang ingin Anda gunakan dalam pemesanan bersama.

Mengubah project konsumen dalam pemesanan bersama

Untuk menghindari error saat Anda mengubah project konsumen yang dapat menggunakan pemesanan bersama, pertimbangkan hal berikut:

  • Penghapusan project: Anda dapat melarang project konsumen menggunakan pemesanan bersama hanya jika tidak ada instance komputasi dalam project tersebut yang menggunakan pemesanan. Untuk menghentikan instance komputasi menggunakan pemesanan, hentikan, tangguhkan, atau hapus instance komputasi.

  • Penambahan project: Anda dapat mengizinkan project konsumen untuk menggunakan pemesanan bersama hanya jika project ini berada dalam organisasi yang sama dengan project pemilik. Untuk memigrasikan project ke organisasi project pemilik, lihat Memigrasikan project di antara resource organisasi.

Setelah Anda mengubah project konsumen untuk pemesanan bersama, konsumsi pemesanan mungkin berubah. Misalnya, jika Anda mengonfigurasi pemesanan agar dapat digunakan oleh instance komputasi yang cocok (konfigurasi default), maka project konsumen yang baru ditambahkan dapat langsung mulai menggunakan pemesanan. Untuk mempelajari lebih lanjut pemesanan yang cocok yang digunakan project terlebih dahulu, lihat urutan penggunaan pemesanan.

Untuk mengubah project konsumen yang dapat menggunakan pemesanan bersama, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Reservations

  2. Di tab On-demand reservations (default), di kolom Name, klik nama pemesanan on-demand yang ingin Anda deskripsikan.

    Halaman detail pemesanan akan terbuka.

  3. Klik Edit.

  4. Di bagian Selected projects, lakukan salah satu langkah berikut:

    • Untuk berhenti berbagi pemesanan dengan project konsumen tertentu, klik Delete.

    • Untuk mulai berbagi pemesanan dengan satu atau beberapa project tertentu, lakukan hal berikut:

      1. Klik Add projects.

      2. Pilih kotak centang untuk setiap project dari organisasi project pemilik yang Anda izinkan menggunakan pemesanan bersama ini. Anda dapat membagikan pemesanan bersama dengan hingga 100 project konsumen.

      3. Klik Pilih.

  5. Untuk mengonfirmasi perubahan, klik Save.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Saat mengubah project konsumen untuk pemesanan bersama, Anda harus menentukan daftar ID project yang dipisahkan koma yang ingin Anda izinkan, atau berhenti mengizinkan, untuk menggunakan pemesanan bersama. Semua project konsumen harus berada dalam organisasi yang sama dengan project pemilik. Jangan menentukan project pemilik; secara default, project pemilik dari pemesanan bersama selalu dapat menggunakannya.

Untuk mengubah project konsumen untuk pemesanan bersama, lakukan salah satu hal berikut:

  • Untuk mengizinkan satu atau beberapa project menggunakan pemesanan bersama, gunakan perintah gcloud compute reservations update dengan flag --add-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama pemesanan bersama yang ada.

    • CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma untuk berbagi pemesanan—misalnya, project-1,project-2. Anda dapat membagikan pemesanan bersama dengan maksimal 100 project konsumen.

    • ZONE: zona tempat pemesanan bersama berada.

  • Untuk berhenti mengizinkan satu atau beberapa project menggunakan pemesanan bersama, gunakan perintah gcloud compute reservations update dengan flag --remove-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama pemesanan bersama yang ada.

    • CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma yang tidak lagi Anda izinkan menggunakan pemesanan bersama ini—misalnya, project-1,project-2.

    • ZONE: zona tempat pemesanan bersama berada.

  • Untuk mengganti daftar project yang dapat menggunakan pemesanan bersama, gunakan perintah gcloud beta compute reservations update dengan flag --share-with.

    gcloud beta compute reservations update RESERVATION_NAME \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • ZONE: zona tempat pemesanan bersama berada.

    • CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma untuk berbagi pemesanan—misalnya, project-1,project-2. Anda dapat membagikan pemesanan bersama dengan maksimal 100 project konsumen.

REST

Saat mengubah project konsumen untuk pemesanan bersama, Anda harus menentukan project yang ingin ditambahkan atau dihapus. Agar project dapat menggunakan pemesanan, tentukan project ID atau nomor project. Untuk melarang project menggunakan pemesanan, Anda harus menentukan nomor project. Semua project konsumen harus berada dalam organisasi yang sama dengan project pemilik. Jangan tentukan project pemilik; secara default, project pemilik dari pemesanan bersama selalu dapat menggunakannya.

Untuk mengubah project konsumen untuk pemesanan bersama, lakukan salah satu hal berikut:

  • Untuk mengizinkan satu atau beberapa project menggunakan pemesanan bersama, buat permintaan PATCH ke metode reservations.update. Di URL permintaan, sertakan parameter kueri paths=shareSettings.projectMap.PROJECT_ID_OR_NUMBER untuk setiap project yang ingin Anda izinkan menggunakan pemesanan bersama ini.

    Misalnya, untuk mengizinkan dua project menggunakan pemesanan bersama, buat permintaan PATCH sebagai berikut. Anda dapat membagikan pemesanan bersama dengan maksimal 100 project konsumen.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_OR_NUMBER_1": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_1"
      },
      "CONSUMER_PROJECT_ID_OR_NUMBER_2": {
        "projectId": "CONSUMER_PROJECT_ID_OR_NUMBER_2"
      }
    }
  }
}

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat pemesanan bersama berada (project pemilik).

    • ZONE: zona tempat pemesanan bersama berada.

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • CONSUMER_PROJECT_ID_OR_NUMBER_1 dan CONSUMER_PROJECT_ID_OR_NUMBER_2: ID atau nomor dari dua project yang ingin Anda gunakan dalam pemesanan bersama.

  • Untuk berhenti mengizinkan satu atau beberapa project menggunakan pemesanan bersama, buat permintaan PATCH ke metode reservations.update. Di URL permintaan, sertakan parameter kueri paths=shareSettings.projectMap.PROJECT_NUMBER untuk setiap project yang tidak lagi Anda izinkan menggunakan pemesanan bersama ini. Selain itu, Anda harus menghapus kolom shareSetting dari isi permintaan.

    Misalnya, untuk berhenti mengizinkan dua project menggunakan pemesanan bersama, buat permintaan PATCH sebagai berikut:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_NUMBER_2

{
  "name": "RESERVATION_NAME"
}

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat pemesanan bersama berada (project pemilik).

    • ZONE: zona tempat pemesanan bersama berada.

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • CONSUMER_PROJECT_NUMBER_1 dan CONSUMER_PROJECT_NUMBER_2: nomor dari dua project yang tidak lagi Anda izinkan menggunakan pemesanan bersama.

Mengubah kebijakan berbagi pemesanan

Saat Anda mengubah kebijakan berbagi pemesanan instance komputasi GPU, Anda mengontrol apakah tugas pelatihan atau prediksi Vertex AI menggunakan pemesanan tersebut.

Sebelum Anda melarang tugas Vertex AI menggunakan reservasi, hentikan semua tugas Vertex AI yang menggunakannya. Jika tidak, akan terjadi error.

Untuk mengubah kebijakan berbagi untuk reservasi instance GPU, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Reservations

  2. Di tab pemesanan on-demand (default), di kolom Name, klik nama pemesanan instance GPU yang ingin Anda ubah. Halaman yang memberikan detail pemesanan akan muncul.

  3. Di baris Berbagi dengan layanan Google Cloud lainnya, klik Edit setelan berbagi layanan.

  4. Di panel Reservation sharing, lakukan salah satu tindakan berikut:

    • Agar tugas Vertex AI dapat menggunakan reservasi, pilih Share reservation.

    • Agar tugas Vertex AI tidak menggunakan pemesanan, pilih Don't share reservation.

  5. Klik Simpan.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Untuk mengubah kebijakan berbagi untuk pemesanan instance GPU, gunakan perintah gcloud compute reservations update dengan flag --reservation-sharing-policy.

gcloud compute reservations update RESERVATION_NAME \
    --reservation-sharing-policy=SHARING_POLICY \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: nama pemesanan yang ada.

  • SHARING_POLICY: kebijakan berbagi pemesanan. Tentukan salah satu nilai berikut:

    • Agar tugas Vertex AI dapat menggunakan reservasi: ALLOW_ALL

    • Untuk melarang tugas Vertex AI menggunakan pemesanan: DISALLOW_ALL

  • ZONE: zona tempat pemesanan berada

REST

Untuk mengubah kebijakan berbagi untuk pemesanan instance GPU, buat permintaan PATCH ke metode reservations.update. Dalam URL permintaan, sertakan parameter kueri paths yang ditetapkan ke reservationSharingPolicy.serviceShareType.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType

{
  "name": "RESERVATION_NAME",
  "reservationSharingPolicy": {
    "serviceShareType": "SHARING_POLICY"
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat pemesanan berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan yang ada.

  • SHARING_POLICY: kebijakan berbagi pemesanan. Tentukan salah satu nilai berikut:

    • Agar tugas Vertex AI dapat menggunakan reservasi: ALLOW_ALL

    • Untuk melarang tugas Vertex AI menggunakan pemesanan: DISALLOW_ALL

Mengubah penghapusan otomatis pemesanan

Anda dapat mengubah kapan Compute Engine otomatis menghapus pemesanan yang ada dengan melakukan salah satu tindakan berikut:

  • Aktifkan opsi hapus otomatis atau ubah waktu penghapusan otomatis pemesanan.

  • Menonaktifkan opsi hapus otomatis.

Untuk mengubah penghapusan otomatis pemesanan, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Reservations

  2. Di tab pemesanan on-demand (default), di kolom Name, klik nama pemesanan yang ingin Anda ubah.

    Halaman detail pemesanan akan terbuka.

  3. Di baris Waktu hapus otomatis, klik Edit waktu hapus otomatis.

  4. Di panel Update reservation, lakukan salah satu hal berikut:

    • Untuk menghapus pemesanan pada tanggal dan waktu tertentu, lakukan hal berikut:

      1. Jika opsi hapus otomatis belum diaktifkan, klik tombol Enable auto-delete ke posisi aktif.

      2. Di kolom Waktu hapus otomatis, masukkan tanggal dan waktu saat Compute Engine otomatis menghapus pemesanan.

    • Jika tidak, klik tombol Aktifkan hapus otomatis ke posisi nonaktif.

  5. Klik Kirim.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Saat mengaktifkan opsi hapus otomatis dalam pemesanan, Anda dapat menentukan tanggal dan waktu kapan pemesanan harus dihapus atau menentukan durasi setelah pemesanan harus dihapus.

Untuk mengaktifkan opsi hapus otomatis atau mengubah waktu penghapusan pemesanan, lakukan salah satu tindakan berikut:

  • Untuk menghapus pemesanan pada tanggal dan waktu tertentu, gunakan perintah gcloud beta compute reservations update dengan flag --delete-at-time.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AT_TIME: tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • ZONE: zona tempat pemesanan berada.

  • Untuk menghapus pemesanan setelah durasi tertentu, gunakan perintah gcloud beta compute reservations update dengan flag --delete-after-duration.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AFTER_DURATION: durasi dalam hari, jam, menit, atau detik sebelum pemesanan dihapus secara otomatis. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s selama 1 hari, 2 jam, 3 menit, dan 4 detik.

    • ZONE: zona tempat pemesanan berada.

Untuk menonaktifkan opsi hapus otomatis, gunakan perintah gcloud beta compute reservations update dengan flag --disable-auto-delete.

gcloud beta compute reservations update RESERVATION_NAME \
    --disable-auto-delete \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: nama pemesanan yang ada.

  • ZONE: zona tempat pemesanan berada.

REST

Saat mengaktifkan opsi hapus otomatis dalam pemesanan, Anda dapat menentukan tanggal dan waktu saat pemesanan harus dihapus atau menentukan durasi keberadaan pemesanan sebelum dihapus.

Untuk mengaktifkan opsi hapus otomatis atau mengubah waktu penghapusan pemesanan, lakukan salah satu tindakan berikut:

  • Untuk menghapus pemesanan pada tanggal dan waktu tertentu, buat permintaan PATCH ke metode beta.reservations.update. Dalam URL permintaan, sertakan parameter kueri paths yang ditetapkan ke deleteAtTime.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime

{
  "name": "RESERVATION_NAME",
  "deleteAtTime": "DELETE_AT_TIME"
}

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat reservasi berada.

    • ZONE: zona tempat pemesanan berada.

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AT_TIME: tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

  • Untuk menghapus pemesanan setelah durasi tertentu, buat permintaan PATCH ke metode beta.reservations.update. Dalam URL permintaan, sertakan parameter kueri paths yang ditetapkan ke deleteAfterDuration.seconds.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds

{
  "name": "RESERVATION_NAME",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  }
}

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat reservasi berada.

    • ZONE: zona tempat pemesanan berada.

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AFTER_DURATION: durasi dalam detik sebelum pemesanan dihapus secara otomatis. Misalnya, tentukan 86400 untuk 86.400 detik (1 hari).

Untuk menonaktifkan opsi hapus otomatis, buat permintaan PATCH ke metode beta.reservations.update. Dalam permintaan, tentukan parameter kueri paths=deleteAtTime&paths=deleteAfterDuration dan hapus isi permintaan.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

Ganti kode berikut:

  • PROJECT_ID: ID project tempat reservasi berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan yang ada.

Langkah berikutnya