Mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang


Dokumen ini menjelaskan cara mengelola permintaan pemesanan untuk masa mendatang. Secara khusus:

  • Mengubah draf atau permintaan pemesanan untuk masa mendatang yang dikirimkan untuk mengubah satu atau beberapa propertinya.

  • Membatalkan permintaan pemesanan untuk masa mendatang agar Google Cloud tidak meninjaunya atau menghentikan pemesanan untuk masa mendatang yang disetujui agar tidak memasuki waktu penguncian.

  • Menghapus pemesanan untuk masa mendatang sebelum memasuki waktu penguncian yang diperlukan atau setelah akhir periode pemesanannya.

Jika Anda ingin mengelola pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang yang terpenuhi setelah akhir periode pemesanannya, lihat hal berikut:

Sebelum memulai

  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

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

    Konsol

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

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init
    2. Menetapkan 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 initialize dengan menjalankan perintah berikut:

      gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengubah, membatalkan, atau menghapus permintaan reservasi mendatang, minta administrator untuk memberi Anda peran IAM Compute Future Reservasi Admin (roles/compute.futureReservationAdmin) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk mengubah, 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 mengubah, 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
  • Untuk mengubah pemesanan untuk masa mendatang: compute.futureReservations.update pada project

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran yang telah ditetapkan sebelumnya.

Pembatasan

Selain pembatasan umum untuk pemesanan untuk masa mendatang, saat Anda mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang, pembatasan berikut akan berlaku:

  • Anda hanya dapat mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang dari dalam project tempat permintaan pemesanan untuk masa mendatang dibuat. Hal ini memungkinkan Anda membagikan permintaan reservasi mendatang ke project lain, tetapi pengguna yang hanya memiliki izin untuk project lain tidak dapat mengubah permintaan reservasi mendatang.

  • Anda hanya dapat mengubah, membatalkan, atau menghapus permintaan reservasi mendatang jika status pengadaannya memungkinkannya. Untuk mengetahui detailnya, lihat tabel berikut.

    Status pengadaan Batal Hapus Mengubah
    Pembuatan draf (DRAFTING)
    Menunggu persetujuan (PENDING_APPROVAL)
    Disetujui (APPROVED)
    Ditolak (DECLINED)
    Dibatalkan (CANCELED)
    Pengadaan (PROCURING)
    Penyediaan (PROVISIONING)
    Terpenuhi (FULFILLED) *
    Terpenuhi sebagian (FAILED_PARTIALLY_FULFILLED) *
    Gagal (FAILED) *

    * Anda dapat menghapus reservasi mendatang yang telah terpenuhi, sebagian terpenuhi, atau gagal hanya setelah waktunya berakhir.

Mengubah permintaan pemesanan untuk masa mendatang

Anda dapat mengubah permintaan reservasi di masa mendatang sebelum mencapai status pengadaan Penyediaan (PROVISIONING) selama tidak dibatalkan atau menunggu persetujuan. Saat mengubah permintaan pemesanan untuk masa mendatang, Anda tidak dapat mengubah properti berikut:

  • Untuk pemesanan untuk masa mendatang:

    • Nama pemesanan untuk masa mendatang.

    • Project tempat permintaan pemesanan untuk masa mendatang dibuat.

    • Zona tempat pemesanan untuk masa mendatang berada.

  • Untuk permintaan pemesanan untuk masa mendatang yang dibuat dengan menentukan template instance:

    • Anda tidak dapat mengganti properti VM yang ditentukan dalam template instance.

    • Anda tidak dapat mengganti template instance yang digunakan untuk membuat permintaan pemesanan untuk masa mendatang dengan template lain.

Untuk mengubah salah satu properti ini, Anda harus membuat permintaan pemesanan untuk masa mendatang yang baru dengan update yang diinginkan.

Jika Anda ingin mengubah properti lain, pilih salah satu metode berikut:

Mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak.

Jika mengubah draf permintaan pemesanan untuk masa mendatang, Anda dapat menyimpan perubahan atau mengirimkan permintaan pemesanan untuk masa mendatang yang telah diperbarui ke Google Cloud untuk ditinjau. Jika mengubah permintaan pemesanan untuk masa mendatang yang ditolak, Anda harus mengirimkan permintaan tersebut untuk ditinjau.

Untuk mengubah properti draf atau permintaan pemesanan untuk masa mendatang yang ditolak, pilih salah satu metode berikut:

Ubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance.

Untuk permintaan reservasi pada masa mendatang yang dibuat dengan menentukan template instance dengan status pengadaan Draf (DRAFTING) atau Ditolak (DECLINED), Anda dapat mengubah properti berikut:

  • Hapus otomatis

  • Deskripsi

  • Awalan nama

  • Setelan berbagi

  • Waktu mulai dan waktu berakhirnya periode pemesanan

  • Jumlah total (Jumlah VM)

Anda dapat mengubah draf atau menolak permintaan reservasi mendatang yang dibuat dengan menentukan template instance menggunakan Konsol Google Cloud, gcloud CLI, dan REST.

Konsol

Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance, ikuti langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Pemesanan untuk masa mendatang.

  3. Di kolom Nama, klik nama permintaan pemesanan untuk masa mendatang yang ingin Anda ubah.

    Halaman detail permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.

  4. Untuk mengubah permintaan pemesanan untuk masa mendatang, klik Edit atau Edit draf.

    Halaman untuk mengedit permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.

  5. Lakukan satu atau beberapa hal berikut:

    • Di kolom Awalan, masukkan awalan nama baru.

    • Di kolom Deskripsi, masukkan deskripsi baru.

    • Ubah Waktu mulai atau Waktu berakhir untuk permintaan pemesanan untuk masa mendatang Anda. Pastikan hal berikut:

      • Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau.

      • Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

      • Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.

    • Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.

      Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.

    • DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

      Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

    • Di bagian Hapus otomatis pemesanan yang dibuat secara otomatis, Anda dapat mengaktifkan atau menonaktifkan penghapusan otomatis pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang Anda.

      Opsional. Jika mengaktifkan opsi hapus otomatis, Anda dapat menentukan tanggal dan waktu saat Compute Engine menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhir periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhir periode reservasi.

  6. Bergantung pada status pengadaan untuk permintaan reservasi di masa mendatang yang Anda ubah, lakukan salah satu hal berikut:

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

      • Untuk menyimpan perubahan, klik Simpan draf.

      • Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau, klik Kirim.

    • Untuk permintaan pemesanan untuk masa mendatang yang ditolak, Anda hanya dapat mengirimkannya untuk ditinjau dengan mengklik Kirim.

      Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.

gcloud

Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance, gunakan perintah gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak.
  • DESCRIPTION: Opsional. Deskripsi baru untuk permintaan pemesanan untuk masa mendatang.
  • NAME_PREFIX: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah permintaan pemesanan untuk masa mendatang untuk satu project menjadi permintaan pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk permintaan pemesanan untuk masa mendatang. Jika Anda menghapus flag --project, nilainya akan ditetapkan ke ID project saat ini.
  • SHARE_SETTING: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:

    • Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan projects. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda --share-with. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.

    • Jika tidak, tentukan local.

  • CONSUMER_PROJECT_IDS: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukan project-1,project-2. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang ini dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.

  • START_TIME: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ganti kode berikut:

    • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda --end-time dengan tanda --duration=END_DURATION, dengan END_DURATION adalah durasi periode reservasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

    Perhatian: Pastikan Anda memiliki kuota yang cukup untuk resource yang ingin Anda pesan. Jika tidak, Google Cloud akan menolak permintaan pemesanan untuk masa mendatang Anda.

  • ZONE: zona tempat permintaan pemesanan untuk masa mendatang.

Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:

  • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

      Ganti AUTO_CREATED_RESERVATIONS_DELETE_TIME dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s untuk 1 hari, 2 jam, 3 menit, dan 4 detik.

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus pemesanan yang dibuat otomatis, tentukan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03 dan berada di zona us-central1-a. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:

  • Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.

  • Menonaktifkan opsi hapus otomatis.

  • Pesan 100 VM.

  • Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.

Untuk mengubah fr-03, jalankan perintah berikut:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance, buat permintaan PATCH ke metode beta.futureReservations.update. Di parameter kueri updateMask, tentukan setiap kolom yang ingin diperbarui. Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask dan hapus kolom tersebut dari isi permintaan.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

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 draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak. Anda tidak dapat mengubah nama permintaan reservasi pada masa mendatang.

  • UPDATE_FIELDS: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaan PATCH ini. Anda harus mengenkode setiap koma sebagai %2C. Misalnya, jika Anda ingin memperbarui kolom autoDeleteAutoCreatedReservations, totalCount, dan endTime dalam permintaan reservasi mendatang, tentukan hal berikut:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opsional. Jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk permintaan reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ganti DELETE_TIME dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ganti kode berikut:

      • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

      • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

      • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

      Mengganti DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 untuk 604.800 detik (7 hari).

  • DESCRIPTION: Opsional. Untuk memperbarui deskripsi untuk permintaan reservasi mendatang, lakukan salah satu hal berikut:

    • Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.

    • Untuk menghapus deskripsi, hapus kolom description dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • NAME_PREFIX: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.

  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • SHARE_TYPE: Opsional. Untuk mengubah jenis berbagi permintaan reservasi mendatang, tentukan salah satu nilai berikut:

    • Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan SPECIFIC_PROJECTS. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolom projects. Jika tidak, modifikasi permintaan reservasi mendatang akan gagal.

    • Jika tidak, tentukan LOCAL. Selain itu, Anda harus menghapus kolom projects dari isi permintaan dan menentukannya dalam UPDATE_FIELDS. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatan. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

  • START_TIME: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolom endTime dengan kolom duration untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:

    "duration": {
      "seconds": "END_DURATION"
    }
    

    Ganti END_DURATION dengan durasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03 dan berada di zona us-central1-a. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:

  • Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.

  • Menonaktifkan opsi hapus otomatis.

  • Pesan 100 VM.

  • Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.

Untuk mengubah fr-03, buat permintaan PATCH berikut:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Setelah Anda mengirimkan permintaan reservasi mendatang ke Google Cloud untuk ditinjau, lihat detailnya untuk memantau status pengadaan.

Mengubah pemesanan untuk masa mendatang versi draf atau yang ditolak dengan menentukan properti secara langsung

Untuk permintaan reservasi pada masa mendatang yang dibuat oleh properti secara langsung dengan status pengadaan yang ditetapkan ke Draf (DRAFTING) atau Ditolak (DECLINED), Anda dapat mengubah properti berikut:

  • Hapus otomatis

  • Deskripsi

  • Awalan nama

  • GPU

  • SSD lokal dan jenis antarmuka disk

  • Seri mesin dan jenis mesin

  • Platform CPU minimal

  • Setelan berbagi

  • Waktu mulai dan waktu berakhirnya periode pemesanan

  • Jumlah total (Jumlah VM)

Anda dapat mengubah draf atau menolak permintaan reservasi mendatang yang dibuat dengan menentukan properti secara langsung menggunakan konsol Google Cloud, gcloud CLI, dan REST.

Konsol

Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan properti secara langsung, ikuti langkah-langkah berikut .

  1. Di konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Pemesanan untuk masa mendatang.

  3. Di kolom Nama, klik nama permintaan pemesanan untuk masa mendatang yang ingin Anda ubah.

    Halaman detail permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.

  4. Untuk mengubah permintaan pemesanan untuk masa mendatang, klik Edit atau Edit draf.

    Halaman untuk mengedit permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.

  5. Lakukan satu atau beberapa hal berikut:

    • Di kolom Awalan, masukkan awalan nama baru.

    • Di kolom Deskripsi, masukkan deskripsi baru.

    • Ubah Waktu mulai atau Waktu berakhir untuk permintaan pemesanan untuk masa mendatang Anda. Pastikan hal berikut:

      • Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau.

      • Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

      • Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.

    • Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.

      Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.

    • DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

      Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

    • Di bagian Konfigurasi mesin, Anda dapat mengubah hal berikut:

      • Seri mesin dan jenis mesin yang digunakan di VM yang dipesan.

      • GPU yang akan dipasang ke VM yang dipesan.

      • SSD Lokal dan jenis antarmuka disk VM yang dipesan.

  6. Bergantung pada status pengadaan untuk permintaan reservasi di masa mendatang yang Anda ubah, lakukan salah satu hal berikut:

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

      • Untuk menyimpan perubahan, klik Simpan draf.

      • Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau, klik Kirim.

    • Untuk permintaan pemesanan untuk masa mendatang yang ditolak, Anda hanya dapat mengirimkannya untuk ditinjau dengan mengklik Kirim.

      Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.

gcloud

Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan properti secara langsung, gunakan perintah gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak.
  • Opsional. Lakukan salah satu hal berikut:

    • Untuk menambahkan unit pemrosesan grafis (GPU) ke setiap VM yang dipesan, tentukan hal berikut:

      • NUMBER_OF_ACCELERATORS: jumlah GPU yang akan ditambahkan per VM yang dipesan.

      • ACCELERATOR_TYPE: jenis GPU yang akan ditambahkan ke VM yang dipesan.

      Pastikan jenis mesin yang Anda tentukan dalam permintaan reservasi mendatang mendukung jenis GPU yang Anda tentukan dan bahwa GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.

    • Untuk menghapus semua GPU dari permintaan pemesanan untuk masa mendatangg ini, ganti flag --accelerator dengan flag --clear-accelerator.

  • DESCRIPTION: Opsional. Deskripsi baru untuk permintaan pemesanan untuk masa mendatang.
  • Opsional. Lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti INTERFACE_1 dan INTERFACE_2. Nilainya harus berupa salah satu dari berikut:

      Ukuran setiap SSD lokal adalah 375 GB. Ulangi flag --local-ssd untuk setiap SSD lokal yang ingin Anda tambahkan. Anda dapat menentukan maksimum 24 SSD lokal.

    • Untuk menghapus semua SSD lokal dari permintaan pemesanan untuk masa mendatang, hapus semua flag --local-ssd dan tentukan flag --clear-local-ssd.

  • MACHINE_TYPE: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.

  • MINIMUM_CPU_PLATFORM: Opsional. Platform CPU minimum yang akan digunakan untuk setiap VM. Jika Anda menghapus flag --min-cpu-platform, nilainya akan ditetapkan ke platform CPU default zona.

  • NAME_PREFIX: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah permintaan pemesanan untuk masa mendatang untuk satu project menjadi permintaan pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk permintaan pemesanan untuk masa mendatang. Jika Anda menghapus flag --project, nilainya akan ditetapkan ke ID project saat ini.
  • SHARE_SETTING: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:

    • Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan projects. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda --share-with. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.

    • Jika tidak, tentukan local.

  • CONSUMER_PROJECT_IDS: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukan project-1,project-2. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang ini dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.

  • START_TIME: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ganti kode berikut:

    • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda --end-time dengan tanda --duration=END_DURATION, dengan END_DURATION adalah durasi periode reservasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

    Perhatian: Pastikan Anda memiliki kuota yang cukup untuk resource yang ingin Anda pesan. Jika tidak, Google Cloud akan menolak permintaan pemesanan untuk masa mendatang Anda.

  • ZONE: zona tempat permintaan pemesanan untuk masa mendatang.

Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:

  • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

      Ganti AUTO_CREATED_RESERVATIONS_DELETE_TIME dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s untuk 1 hari, 2 jam, 3 menit, dan 4 detik.

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus pemesanan yang dibuat otomatis, tentukan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03 dan berada di zona us-central1-a. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:

  • Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.

  • Menonaktifkan opsi hapus otomatis.

  • Pesan 100 VM.

  • Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.

Untuk mengubah fr-03, jalankan perintah berikut:

gcloud beta compute future-reservations update fr-03 \
    --clear-share-settings \
    --no-auto-delete-auto-created-reservations \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=100 \
    --zone=us-central1-a

REST

Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan properti secara langsung, buatPATCH ke beta.futureReservations.update metode ini. Di parameter kueri updateMask, tentukan setiap kolom yang ingin diperbarui. Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask dan hapus kolom tersebut dari isi permintaan.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

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 draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak. Anda tidak dapat mengubah nama permintaan reservasi pada masa mendatang.

  • UPDATE_FIELDS: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaan PATCH ini. Anda harus mengenkode setiap koma sebagai %2C. Misalnya, jika Anda ingin memperbarui kolom autoDeleteAutoCreatedReservations, totalCount, dan endTime dalam permintaan reservasi mendatang, tentukan hal berikut:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opsional. Jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk permintaan reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ganti DELETE_TIME dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ganti kode berikut:

      • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

      • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

      • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

      Mengganti DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 untuk 604.800 detik (7 hari).

  • DESCRIPTION: Opsional. Untuk memperbarui deskripsi untuk permintaan reservasi mendatang, lakukan salah satu hal berikut:

    • Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.

    • Untuk menghapus deskripsi, hapus kolom description dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • NAME_PREFIX: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.

  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • SHARE_TYPE: Opsional. Untuk mengubah jenis berbagi permintaan reservasi mendatang, tentukan salah satu nilai berikut:

    • Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan SPECIFIC_PROJECTS. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolom projects. Jika tidak, modifikasi permintaan reservasi mendatang akan gagal.

    • Jika tidak, tentukan LOCAL. Selain itu, Anda harus menghapus kolom projects dari isi permintaan dan menentukannya dalam UPDATE_FIELDS. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatan. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.

  • Opsional. Untuk mengupdate unit pemrosesan grafis (GPU) yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengubah GPU, tentukan hal berikut:

      • NUMBER_OF_ACCELERATORS: jumlah GPU yang akan ditambahkan per VM yang dipesan.

      • ACCELERATOR_TYPE: jenis GPU yang akan ditambahkan ke VM yang dipesan.

      Pastikan jenis mesin yang Anda tentukan dalam permintaan reservasi mendatang mendukung jenis GPU yang Anda tentukan dan bahwa GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.

    • Untuk menghapus semua GPU dari permintaan reservasi mendatang ini, hapus kolom guestAccelerators dalam isi permintaan dan tentukan di UPDATE_FIELDS.

  • Opsional. Untuk mengupdate SSD lokal yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti INTERFACE_1 dan INTERFACE_2. Nilainya harus berupa salah satu dari berikut:

      Ulangi kolom diskSizeGb dan interface untuk setiap SSD lokal yang ingin ditambahkan atau diperbarui. Anda dapat menentukan maksimum 24 SSD lokal.

    • Untuk menghapus semua SSD lokal dari reservasi permintaan mendatang ini, hapus kolom localSsds dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • MACHINE_TYPE: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.

  • MINIMUM_CPU_PLATFORM: Opsional. Untuk mengupdate platform CPU minimum yang akan digunakan untuk setiap VM, lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengupdate platform CPU minimum, tentukan platform CPU minimum.

    • Untuk kembali ke platform CPU default zona, hapus kolom minCpuPlatform dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

  • START_TIME: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolom endTime dengan kolom duration untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:

    "duration": {
      "seconds": "END_DURATION"
    }
    

    Ganti END_DURATION dengan durasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03 dan berada di zona us-central1-a. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:

  • Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.

  • Menonaktifkan opsi hapus otomatis.

  • Pesan 100 VM.

  • Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.

Untuk mengubah fr-03, buat permintaan PATCH berikut:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount

{
  "autoDeleteAutoCreatedReservations": "false",
  "name": "fr-03",
  "planningStatus": "SUBMITTED",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "totalCount": "100"
  }
}

Setelah Anda mengirimkan permintaan reservasi mendatang ke Google Cloud untuk ditinjau, lihat detailnya untuk memantau status pengadaan.

Mengubah pemesanan untuk masa mendatang yang disetujui atau yang diperoleh

Untuk mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh, pilih salah satu metode berikut:

Mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan.

Untuk reservasi pada masa mendatang dengan status pengadaan yang ditetapkan ke Disetujui (APPROVED) atau Pengadaan (PROCURING), Anda dapat mengubah kolom berikut tanpa persetujuan dari Google Cloud:

  • Hapus otomatis

  • Deskripsi

  • Awalan nama

Perubahan properti ini terjadi segera. Hingga waktu mulai periode reservasi reservasi di masa mendatang, tidak ada batasan berapa kali Anda dapat mengubah properti ini.

Anda dapat mengubah atau mendapatkan reservasi mendatang yang disetujui tanpa peninjauan menggunakan Konsol Google Cloud, gcloud CLI, dan REST.

Konsol

Untuk mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Pemesanan untuk masa mendatang.

  3. Di kolom Name, klik nama pemesanan untuk masa mendatang yang ingin Anda ubah.

    Halaman detail pemesanan untuk masa mendatang yang dipilih akan terbuka.

  4. Jika Anda ingin mengubah opsi hapus otomatis dan deskripsi pemesanan untuk masa mendatang, lakukan satu atau beberapa hal berikut:

    • Di baris waktu dihapus secara otomatis pemesanan yang dibuat otomatis , klik Edit, lalu ikuti langkah-langkah berikut:

      1. Lakukan salah satu hal berikut:

        • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang, pilih salah satu metode berikut:

          1. Klik tombol Aktifkan hapus otomatis ke posisi aktif.

          2. Opsional: Di kolom Waktu dihapus otomatis, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.

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

      2. Klik Submit.

    • Di baris Awalan, klik Edit, lalu lakukan hal berikut:

      1. Di kolom Awalan, masukkan awalan nama baru.

      2. Klik Submit.

    • Di baris Deskripsi, klik Edit, lalu lakukan hal berikut:

      1. Di kolom Deskripsi, masukkan deskripsi baru.

      2. Klik Submit.

gcloud

Untuk mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan,, gunakan perintah gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama pemesanan untuk masa mendatang. yang sudah disetujui atau diperoleh.
  • DESCRIPTION: Opsional. Deskripsi baru untuk pemesanan untuk masa mendatang.
  • NAME_PREFIX: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
  • PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat.
  • ZONE: zona tempat permintaan pemesanan untuk masa mendatang berada.

Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:

  • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

      Ganti AUTO_CREATED_RESERVATIONS_DELETE_TIME dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s untuk 1 hari, 2 jam, 3 menit, dan 4 detik.

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus pemesanan yang dibuat otomatis, tentukan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-04 dan berada di zona us-central1-a. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:

  • Mengaktifkan opsi hapus otomatis.

  • Otomatis menghapus reservasi yang dibuat otomatis setelah 864.000 detik (10 hari).

  • Tentukan awalan nama baru.

Untuk mengubah fr-04, jalankan perintah berikut:

gcloud beta compute future-reservations update fr-04 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-duration=864000 \
    --name-prefix=new-prefix \
    --project=example-project \
    --zone=us-central1-a

REST

Untuk mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan, buat permintaan PATCH ke metode beta.futureReservations.update. Di parameter kueri updateMask, tentukan setiap kolom yang ingin diperbarui. Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask dan hapus kolom tersebut dari isi permintaan.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX"
}

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 pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh. Anda tidak dapat mengubah nama reservasi di masa mendatang.

  • UPDATE_FIELDS: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaan PATCH ini. Anda harus mengenkode setiap koma sebagai %2C. Misalnya, jika Anda ingin memperbarui kolom description dan namePrefix pada reservasi mendatang, tentukan hal berikut:

    description%2CnamePrefix
    

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opsional. Jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ganti DELETE_TIME dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ganti kode berikut:

      • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

      • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

      • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

      Mengganti DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 untuk 604.800 detik (7 hari).

  • DESCRIPTION: Opsional. Untuk memperbarui deskripsi bagi reservasi mendatang, lakukan salah satu hal berikut:

    • Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.

    • Untuk menghapus deskripsi, hapus kolom description dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • NAME_PREFIX: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.

Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-04 dan berada di zona us-central1-a. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:

  • Mengaktifkan opsi hapus otomatis.

  • Otomatis menghapus reservasi yang dibuat otomatis setelah 864.000 detik (10 hari).

  • Tentukan awalan nama baru.

Untuk mengubah fr-04, buat permintaan PATCH berikut:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix

{
  "autoDeleteAutoCreatedReservations": "true",
  "autoCreatedReservationsDuration": {
    "seconds": "864000"
  },
  "name": "fr-04",
  "namePrefix": "new-prefix"
}

Permintaan untuk mengubah pemesanan di masa mendatang yang disetujui atau diperoleh.

Anda dapat meminta Google Cloud untuk mengubah reservasi mendatang dengan status pengadaan yang ditetapkan ke Disetujui (APPROVED) atau Pengadaan (PROCURING) sebagai berikut:

  • Jika Anda meminta untuk mengubah reservasi mendatang yang disetujui, Google Cloud akan melakukan salah satu tindakan berikut:

    • Menyetujui permintaan dan menetapkan status pengadaan ke Disetujui (APPROVED). Jika waktu mulai periode reservasi berada dalam waktu 56 hari (8 minggu), Compute Engine akan menetapkan status pengadaan ke Pengadaan (PROCURING) dalam beberapa menit.

    • Menolak permintaan dan menetapkan status pengadaan ke Ditolak (DECLINED). Jika Anda ingin mengubah reservasi mendatang lagi, lihat Mengubah draf atau reservasi mendatang yang ditolak di dokumen ini.

  • Jika Anda meminta untuk mengubah reservasi pengadaan mendatang, Compute Engine akan membuat status update pada reservasi mendatang, dan menyetelnya ke Update tertunda persetujuan (AMENDMENT_PENDING_APPROVAL). Kemudian, Google Cloud akan meninjau permintaan Anda dan melakukan salah satu hal berikut:

    • Menyetujui permintaan dan menetapkan status update ke Update disetujui (AMENDMENT_APPROVED).

    • Menolak permintaan, menetapkan status update ke Update ditolak (AMENDMENT_DECLINED), dan terus menggunakan properti yang telah disetujui sebelumnya untuk reservasi yang dibuat otomatis.

    Selama Google Cloud meninjau permintaan Anda untuk mengubah pemesanan untuk masa mendatang yang diperoleh, Anda tidak dapat mengubah properti apa pun—termasuk properti yang biasanya dapat Anda ubah tanpa persetujuan—hingga Google Cloud menyetujui atau menolak permintaan Anda.

Untuk meminta Google Cloud mengubah properti pemesanan untuk masa mendatang yang disetujui atau diperoleh, pilih salah satu metode berikut:

Permintaan untuk mengubah pemesanan untuk masa mendatang yang dibuat dengan menentukan template instance.

Untuk reservasi di masa mendatang yang dibuat dengan menentukan template instance dengan status pengadaan Disetujui (APPROVED) atau Pengadaan (PROCURING), Anda dapat meminta untuk mengubah properti berikut:

  • Hapus otomatis

  • Deskripsi

  • Awalan nama

  • Setelan berbagi

  • Waktu mulai dan waktu berakhirnya periode pemesanan

  • Jumlah total (Jumlah VM)

Jika Anda meminta untuk menambah atau mengurangi jumlah total sebagian besar dalam waktu 14 hari sejak waktu mulai reservasi di masa mendatang, Google Cloud kemungkinan akan menolak permintaan Anda.

Anda dapat meminta Google Cloud untuk mengubah reservasi mendatang yang dibuat dengan menentukan template instance menggunakan gcloud CLI dan REST.

Konsol

Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menentukan template instance, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Pemesanan untuk masa mendatang.

  3. Di kolom Name, klik nama pemesanan untuk masa mendatang yang ingin Anda ubah.

    Halaman detail pemesanan untuk masa mendatang yang dipilih akan terbuka.

  4. Jika Anda ingin mengubah opsi hapus otomatis dan deskripsi pemesanan untuk masa mendatang, lakukan satu atau beberapa hal berikut:

    • Di baris waktu dihapus secara otomatis pemesanan yang dibuat otomatis , klik Edit, lalu ikuti langkah-langkah berikut:

      1. Lakukan salah satu hal berikut:

        • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang, pilih salah satu metode berikut:

          1. Klik tombol Aktifkan hapus otomatis ke posisi aktif.

          2. Opsional: Di kolom Waktu dihapus otomatis, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.

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

      2. Klik Submit.

    • Di baris Awalan, klik Edit, lalu lakukan hal berikut:

      1. Di kolom Awalan, masukkan awalan nama baru.

      2. Klik Submit.

    • Di baris Deskripsi, klik Edit, lalu lakukan hal berikut:

      1. Di kolom Deskripsi, masukkan deskripsi baru.

      2. Klik Submit.

  5. Klik Edit.

    Halaman untuk mengedit pemesanan untuk masa mendatang yang dipilih akan terbuka.

  6. Jika Anda ingin mengubah properti lain, lakukan satu atau beberapa hal berikut:

    • Ubah Waktu mulai atau Waktu berakhir untuk pemesanan untuk masa mendatang Anda. Pastikan hal berikut:

      • Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau.

      • Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

      • Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.

    • Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.

      Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.

    • DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

      Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

  7. Untuk mengirimkan permintaan perubahan ke Google Cloud untuk ditinjau, klik Kirim.

    Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.

gcloud

Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menentukan template instance, gunakan perintah gcloud beta compute future-reservations update.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --description="DESCRIPTION" \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama pemesanan untuk masa mendatang. yang sudah disetujui atau diperoleh.
  • DESCRIPTION: Opsional. Deskripsi baru untuk pemesanan untuk masa mendatang.
  • NAME_PREFIX: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk pemesanan untuk masa mendatang. Jika Anda menghapus flag --project, nilainya akan ditetapkan ke ID project saat ini.
  • SHARE_SETTING: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:

    • Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan projects. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda --share-with. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.

    • Jika tidak, tentukan local.

  • CONSUMER_PROJECT_IDS: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukan project-1,project-2. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.

  • START_TIME: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ganti kode berikut:

    • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda --end-time dengan tanda --duration=END_DURATION, dengan END_DURATION adalah durasi periode reservasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

    Perhatian: Jika Anda ingin meningkatkan jumlah VM yang akan dipesan, pastikan Anda memiliki kuota yang cukup untuk resource tambahan yang diminta dipesan. Jika tidak, Google Cloud akan menolak permintaan perubahan Anda.

  • ZONE: zona tempat permintaan pemesanan untuk masa mendatang berada.

Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:

  • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

      Ganti AUTO_CREATED_RESERVATIONS_DELETE_TIME dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s untuk 1 hari, 2 jam, 3 menit, dan 4 detik.

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus pemesanan yang dibuat otomatis, tentukan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05 dan berada di zona us-central1-a. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:

  • Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.

  • Pesan 10 VM.

  • Tentukan awalan nama baru.

Untuk meminta Google Cloud mengubah fr-05, jalankan perintah berikut:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menentukan template instance, buat permintaan PATCH ke metode beta.futureReservations.update. Di parameter kueri updateMask, tentukan setiap kolom yang ingin diperbarui. Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask dan hapus kolom tersebut dari isi permintaan.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

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 pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh. Anda tidak dapat mengubah nama reservasi di masa mendatang.

  • UPDATE_FIELDS: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaan PATCH ini. Anda harus mengenkode setiap koma sebagai %2C. Misalnya, jika Anda ingin memperbarui kolom autoDeleteAutoCreatedReservations, totalCount, dan endTime di reservasi mendatang, tentukan hal berikut:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opsional. Jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ganti DELETE_TIME dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ganti kode berikut:

      • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

      • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

      • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

      Mengganti DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 untuk 604.800 detik (7 hari).

  • DESCRIPTION: Opsional. Untuk memperbarui deskripsi bagi reservasi mendatang, lakukan salah satu hal berikut:

    • Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.

    • Untuk menghapus deskripsi, hapus kolom description dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • NAME_PREFIX: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.

  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • SHARE_TYPE: Opsional. Untuk mengubah jenis berbagi reservasi mendatang, tentukan salah satu nilai berikut:

    • Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan SPECIFIC_PROJECTS. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolom projects. Jika tidak, modifikasi reservasi mendatang akan gagal.

    • Jika tidak, tentukan LOCAL. Selain itu, Anda harus menghapus kolom projects dari isi permintaan dan menentukannya dalam UPDATE_FIELDS. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

  • START_TIME: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolom endTime dengan kolom duration untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:

    "duration": {
      "seconds": "END_DURATION"
    }
    

    Ganti END_DURATION dengan durasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05 dan berada di zona us-central1-a. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:

  • Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.

  • Pesan 10 VM.

  • Tentukan awalan nama baru.

Untuk meminta Google Cloud mengubah fr-05, buat permintaan PATCH berikut:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Setelah mengirimkan permintaan untuk mengubah reservasi mendatang ke Google Cloud, Anda dapat memantau status permintaan tersebut dengan melihat detail reservasi mendatang.

Permintaan untuk mengubah pemesanan untuk masa mendatang yang dibuat dengan menentukan properti secara langsung

Untuk reservasi di masa mendatang yang dibuat dengan menentukan properti secara langsung dengan status pengadaan Disetujui (APPROVED) atau Pengadaan (Procuring), Anda dapat meminta untuk mengubah properti berikut:

  • Hapus otomatis

  • Deskripsi

  • Awalan nama

  • GPU

  • SSD lokal dan jenis antarmuka disk

  • Seri mesin dan jenis mesin

  • Platform CPU minimum

  • Setelan berbagi

  • Waktu mulai dan waktu berakhirnya periode pemesanan

  • Jumlah total (Jumlah VM)

Jika Anda meminta untuk mengubah properti VM, atau menambah atau mengurangi jumlah total sebagian besar, dalam waktu 14 hari sejak waktu mulai reservasi di masa mendatang, Google Cloud kemungkinan akan menolak permintaan Anda.

Anda dapat meminta Google Cloud untuk mengubah reservasi mendatang yang dibuat dengan menentukan properti secara langsung menggunakan Konsol Google Cloud, gcloud CLI, dan REST.

Konsol

Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menetapkan properti secara langsung, ikuti langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Pemesanan untuk masa mendatang.

  3. Di kolom Name, klik nama pemesanan untuk masa mendatang yang ingin Anda ubah.

    Halaman detail pemesanan untuk masa mendatang yang dipilih akan terbuka.

  4. Jika Anda ingin mengubah opsi hapus otomatis dan deskripsi pemesanan untuk masa mendatang, lakukan satu atau beberapa hal berikut:

    • Di baris waktu dihapus secara otomatis pemesanan yang dibuat otomatis , klik Edit, lalu ikuti langkah-langkah berikut:

      1. Lakukan salah satu hal berikut:

        • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang, pilih salah satu metode berikut:

          1. Klik tombol Aktifkan hapus otomatis ke posisi aktif.

          2. Opsional: Di kolom Waktu dihapus otomatis, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.

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

      2. Klik Submit.

    • Di baris Awalan, klik Edit, lalu lakukan hal berikut:

      1. Di kolom Awalan, masukkan awalan nama baru.

      2. Klik Submit.

    • Di baris Deskripsi, klik Edit, lalu lakukan hal berikut:

      1. Di kolom Deskripsi, masukkan deskripsi baru.

      2. Klik Submit.

  5. Klik Edit.

    Halaman untuk mengedit pemesanan untuk masa mendatang yang dipilih akan terbuka.

  6. Jika Anda ingin mengubah properti lain, lakukan satu atau beberapa hal berikut:

    • Ubah Waktu mulai atau Waktu berakhir untuk pemesanan untuk masa mendatang Anda. Pastikan hal berikut:

      • Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau.

      • Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

      • Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.

    • Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.

      Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.

    • DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

      Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

    • Di bagian Konfigurasi mesin, Anda dapat mengubah hal berikut:

      • Seri mesin dan jenis mesin yang digunakan di VM yang dipesan.

      • GPU yang akan dipasang ke VM yang dipesan.

      • SSD Lokal dan jenis antarmuka disk VM yang dipesan.

  7. Untuk mengirimkan permintaan perubahan ke Google Cloud untuk ditinjau, klik Kirim.

    Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.

gcloud

Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menentukan properti secara langsung, gunakan perintah gcloud beta compute future-reservations update .

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --description="DESCRIPTION" \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --project=PROJECT_ID \
    --share-setting=SHARE_SETTING \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh.
  • Opsional. Lakukan salah satu hal berikut:

    • Untuk menambahkan unit pemrosesan grafis (GPU) ke setiap VM yang dipesan, tentukan hal berikut:

      • NUMBER_OF_ACCELERATORS: jumlah GPU yang akan ditambahkan per VM yang dipesan.

      • ACCELERATOR_TYPE: jenis GPU yang akan ditambahkan ke VM yang dipesan.

      Pastikan jenis mesin yang Anda tentukan pada reservasi mendatang mendukung jenis GPU yang Anda tentukan dan GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.

    • Untuk menghapus semua GPU dari permintaan pemesanan untuk masa mendatang ini, ganti flag --accelerator dengan flag --clear-accelerator.

  • DESCRIPTION: Opsional. Deskripsi baru untuk pemesanan untuk masa mendatang.
  • Opsional. Lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti INTERFACE_1 dan INTERFACE_2. Nilainya harus berupa salah satu dari berikut:

      Ukuran setiap SSD lokal adalah 375 GB. Ulangi flag --local-ssd untuk setiap SSD lokal yang ingin Anda tambahkan. Anda dapat menentukan maksimum 24 SSD lokal.

    • Untuk menghapus semua SSD lokal dari permintaan pemesanan untuk masa mendatang ini, hapus semua flag --local-ssd dan tentukan flag --clear-local-ssd.

  • MACHINE_TYPE: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.

  • MINIMUM_CPU_PLATFORM: Opsional. Platform CPU minimum yang akan digunakan untuk setiap VM. Jika Anda menghapus flag --min-cpu-platform, nilainya akan ditetapkan ke platform CPU default zona.

  • NAME_PREFIX: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk pemesanan untuk masa mendatang. Jika Anda menghapus flag --project, nilainya akan ditetapkan ke ID project saat ini.
  • SHARE_SETTING: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:

    • Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan projects. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda --share-with. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.

    • Jika tidak, tentukan local.

  • CONSUMER_PROJECT_IDS: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukan project-1,project-2. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.

  • START_TIME: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Ganti kode berikut:

    • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda --end-time dengan tanda --duration=END_DURATION, dengan END_DURATION adalah durasi periode reservasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

    Perhatian: Jika Anda ingin meningkatkan jumlah VM yang akan dipesan, pastikan Anda memiliki kuota yang cukup untuk resource tambahan yang diminta dipesan. Jika tidak, Google Cloud akan menolak permintaan perubahan Anda.

  • ZONE: zona tempat permintaan pemesanan untuk masa mendatang berada.

Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:

  • Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag --auto-delete-auto-created-reservations.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations
      
    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
      

      Ganti AUTO_CREATED_RESERVATIONS_DELETE_TIME dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag --auto-delete-auto-created-reservations dan --auto-created-reservations-duration.

      gcloud beta compute future-reservations update example-future-reservation \
          --auto-delete-auto-created-reservations \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE
      

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s untuk 1 hari, 2 jam, 3 menit, dan 4 detik.

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus pemesanan yang dibuat otomatis, tentukan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update example-future-reservation \
        --no-auto-delete-auto-created-reservations
    

Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05 dan berada di zona us-central1-a. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:

  • Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.

  • Pesan 10 VM.

  • Tentukan awalan nama baru.

Untuk meminta Google Cloud mengubah fr-05, jalankan perintah berikut:

gcloud beta compute future-reservations update fr-05 \
    --end-time=2024-12-31T00:00:00Z \
    --name-prefix=new-prefix \
    --planning-status=SUBMITTED \
    --project=example-project \
    --total-count=10 \
    --zone=us-central1-a

REST

Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menentukan properti secara langsung, buat permintaan PATCH ke metode beta.futureReservations.update . Di parameter kueri updateMask, tentukan setiap kolom yang ingin diperbarui. Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask dan hapus kolom tersebut dari isi permintaan.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS

{
  "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
  "description": "DESCRIPTION",
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "planningStatus": "PLANNING_STATUS",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SHARE_TYPE"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": "TOTAL_COUNT"
  },
  "timeWindow": {
    "endTime": "END_TIME",
    "startTime": "START_TIME"
  }
}

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 pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh. Anda tidak dapat mengubah nama reservasi di masa mendatang.

  • UPDATE_FIELDS: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaan PATCH ini. Anda harus mengenkode setiap koma sebagai %2C. Misalnya, jika Anda ingin memperbarui kolom autoDeleteAutoCreatedReservations, totalCount, dan endTime di reservasi mendatang, tentukan hal berikut:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Opsional. Jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME"
      }
      

      Ganti DELETE_TIME dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:

      YYYY-MM-DDTHH:MM:SSOFFSET
      

      Ganti kode berikut:

      • YYYY-MM-DD: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).

      • HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).

      • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        }
      }
      

      Mengganti DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 untuk 604.800 detik (7 hari).

  • DESCRIPTION: Opsional. Untuk memperbarui deskripsi bagi reservasi mendatang, lakukan salah satu hal berikut:

    • Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.

    • Untuk menghapus deskripsi, hapus kolom description dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • NAME_PREFIX: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.

  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukan SUBMITTED, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.

  • SHARE_TYPE: Opsional. Untuk mengubah jenis berbagi reservasi mendatang, tentukan salah satu nilai berikut:

    • Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan SPECIFIC_PROJECTS. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolom projects. Jika tidak, modifikasi reservasi mendatang akan gagal.

    • Jika tidak, tentukan LOCAL. Selain itu, Anda harus menghapus kolom projects dari isi permintaan dan menentukannya dalam UPDATE_FIELDS. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.

  • Opsional. Untuk mengupdate unit pemrosesan grafis (GPU) yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengubah GPU, tentukan hal berikut:

      • NUMBER_OF_ACCELERATORS: jumlah GPU yang akan ditambahkan per VM yang dipesan.

      • ACCELERATOR_TYPE: jenis GPU yang akan ditambahkan ke VM yang dipesan.

      Pastikan jenis mesin yang Anda tentukan pada reservasi mendatang mendukung jenis GPU yang Anda tentukan dan GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.

    • Untuk menghapus semua GPU dari permintaan mendatang ini, hapus kolom guestAccelerators dalam isi permintaan dan tentukan di UPDATE_FIELDS.

  • Opsional. Untuk mengupdate SSD lokal yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti INTERFACE_1 dan INTERFACE_2. Nilainya harus berupa salah satu dari berikut:

      Ulangi kolom diskSizeGb dan interface untuk setiap SSD lokal yang ingin ditambahkan atau diperbarui. Anda dapat menentukan maksimum 24 SSD lokal.

    • Untuk menghapus semua SSD lokal dari reservasi di masa mendatang, hapus kolom localSsds dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • MACHINE_TYPE: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.

  • MINIMUM_CPU_PLATFORM: Opsional. Untuk mengupdate platform CPU minimum yang akan digunakan untuk setiap VM, lakukan salah satu hal berikut:

    • Untuk menambahkan atau mengupdate platform CPU minimum, tentukan platform CPU minimum.

    • Untuk kembali ke platform CPU default zona, hapus kolom minCpuPlatform dari isi permintaan dan tentukan di UPDATE_FIELDS.

  • TOTAL_COUNT: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

    Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.

  • START_TIME: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.

  • END_TIME: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolom endTime dengan kolom duration untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:

    "duration": {
      "seconds": "END_DURATION"
    }
    

    Ganti END_DURATION dengan durasi dalam detik. Misalnya, tentukan 1209600 untuk 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05 dan berada di zona us-central1-a. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:

  • Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.

  • Pesan 10 VM.

  • Tentukan awalan nama baru.

Untuk meminta Google Cloud mengubah fr-05, buat permintaan PATCH berikut:

PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime

{
  "name": "fr-05",
  "namePrefix": "new-prefix",
  "planningStatus": "SUBMITTED",
  "specificSkuProperties": {
    "totalCount": "10"
  },
  "timeWindow": {
    "endTime": "2023-12-31T00:00:00Z"
  }
}

Setelah mengirimkan permintaan untuk mengubah reservasi mendatang ke Google Cloud, Anda dapat memantau status permintaan tersebut dengan melihat detail reservasi mendatang.

Mengubah properti lainnya dalam permintaan reservasi untuk masa mendatang

Jika Anda ingin mengubah properti lain dalam permintaan reservasi mendatang sebelum mencapai status pengadaan Pengadaan (PROCURING), ikuti langkah-langkah berikut:

  1. Lakukan satu atau beberapa hal berikut:

  2. Buat single-project baru atau permintaan pemesanan untuk masa mendatang yang baru dengan update yang Anda inginkan.

Memecahkan masalah

Jika Anda mengalami error saat mengubah permintaan pemesanan untuk masa mendatang, lihat cara memecahkan masalah permintaan pemesanan untuk masa mendatang.

Jika Anda masih mengalami masalah setelah memecahkan masalah, hubungi perwakilan akun Anda atau Dukungan Google Cloud.

Membatalkan permintaan pemesanan untuk masa mendatang

Anda dapat membatalkan permintaan pemesanan untuk masa mendatang yang disetujui, ditolak, atau menunggu persetujuan untuk menghentikan Google Cloud menyediakan kapasitas yang diminta. Setelah membatalkan permintaan pemesanan untuk masa mendatang, Anda hanya dapat melihat detailnya atau menghapusnya.

Anda dapat membatalkan permintaan reservasi pada masa mendatang menggunakan gcloud CLI dan REST.

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 \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang yang ada.

  • PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang berada. Jika Anda menghilangkan flag --project, ID project saat ini akan digunakan.

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

  • FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang yang ada.

Membatalkan permintaan pemesanan untuk masa mendatang

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

  • Permintaan pemesanan untuk masa mendatang dibatalkan.

  • Sebelum pemesanan untuk masa mendatang mencapai waktu mulai periode reservasinya.

  • Setelah pemesanan untuk masa mendatang mencapai waktu berakhir periode pemesanannya.

Menghapus pemesanan untuk masa mendatang tidak akan menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang. Jika Anda ingin menghapus pemesanan yang dibuat otomatis setelah akhir periode pemesanan, lihat Menghapus pemesanan.

Anda dapat menghapus permintaan reservasi pada masa mendatang menggunakan Konsol Google Cloud, gcloud CLI, dan REST.

Konsol

Untuk menghapus permintaan pemesanan untuk masa mendatang, ikuti langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman Reservations.

    Buka Reservations

  2. Klik tab Pemesanan untuk masa mendatang.

  3. Pilih kotak centang di samping 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 \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama permintaan pemesanan untuk masa mendatang yang ada.

  • PROJECT_ID: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang berada. Jika Anda menghilangkan flag --project, ID project saat ini akan digunakan.

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