Mengubah pemesanan

Dokumen ini menjelaskan cara mengubah pemesanan di Compute Engine. Untuk mengubah pemesanan yang dilampirkan ke komitmen, lihat Mengganti pemesanan 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 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 konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init
  • 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, lalu login ke gcloud CLI dengan identitas gabungan Anda.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk 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 yang telah ditetapkan 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 konsumsi 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 pemesanan baru dengan update yang Anda pilih, lalu menghapus pemesanan asli jika Anda tidak lagi membutuhkannya.

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 dipesan dalam pemesanan, 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 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 dipesan 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 dipesan dalam pemesanan, buat permintaan POST ke metode reservations.resize.

POST https://compute./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 dipesan.

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 pemesanan, sebelum memulai perubahan, 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 reservasi yang ditargetkan secara khusus, Anda harus menghentikan, menangguhkan, atau menghapus instance komputasi apa pun yang menggunakan reservasi di setiap project konsumen yang menggunakan reservasi 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 reservasi project tunggal menjadi reservasi bersama, buat permintaan sebagai berikut. Dalam 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 kepada 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./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./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 pemesanan 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 instance komputasi yang cocok dapat menggunakannya (konfigurasi default), maka project konsumen yang baru ditambahkan mungkin akan segera 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 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 kepada maksimal 100 project konsumen.

      3. Klik Select.

  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 hentikan izin, 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 yang dipisahkan koma untuk ID project 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 pemesanan bersama yang ada.

    • ZONE: zona tempat pemesanan bersama berada.

    • CONSUMER_PROJECT_IDS: daftar yang dipisahkan koma untuk ID project yang akan diajak 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. Untuk mengizinkan project 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. Dalam 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./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 pemesanan 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. Dalam 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./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 pemesanan 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 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 tugas Vertex AI yang menggunakannya. Jika tidak, akan terjadi error.

Untuk mengubah kebijakan berbagi untuk pemesanan 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 Berbagi pemesanan, lakukan salah satu tindakan berikut:

    • Agar tugas Vertex AI dapat menggunakan pemesanan, 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 pemesanan: 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./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 pemesanan: 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 On-demand reservations (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 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 untuk 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 pemesanan harus dihapus atau menentukan durasi pemesanan harus ada sebelum dihapus.

Untuk mengaktifkan opsi hapus otomatis atau mengubah kapan pemesanan harus dihapus, 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./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 pemesanan 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./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 pemesanan 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./compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

Ganti kode berikut:

  • PROJECT_ID: ID project tempat pemesanan berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan yang ada.

Langkah berikutnya