Mengubah permintaan pemesanan untuk masa mendatang


Dokumen ini menjelaskan cara mengubah permintaan reservasi di masa mendatang.

Anda dapat mengubah permintaan reservasi yang akan datang kapan saja sebelum waktu mulainya, asalkan belum dibatalkan atau tidak menunggu persetujuan. Mengubah masa depan permintaan reservasi berguna saat kapasitas Anda perlu berubah—untuk ketika Anda ingin meningkatkan jumlah virtual machine (VM) yang dicadangkan atau mengubah periode reservasi. Jika Anda ingin mengubah permintaan reservasi di masa mendatang, maka Anda harus mengubah permintaan menggunakan proyek.

Untuk mengubah reservasi yang dibuat otomatis setelah periode reservasinya berakhir, lihat Mengubah reservasi.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Authentication adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat mengautentikasi 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 permintaan reservasi di masa mendatang, minta administrator untuk memberi Anda Peran IAM Compute Future Reservasi Admin (roles/compute.futureReservationAdmin) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi compute.futureReservations.update, yang merupakan yang diperlukan untuk mengubah permintaan reservasi di masa mendatang.

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

Properti yang dapat diubah

Permintaan reservasi mendatang memiliki beberapa properti yang menentukan reservasi, menentukan perilakunya, dan menentukan resource yang akan dicadangkan. Anda dapat mengubah properti ini seperti yang dijelaskan di bagian berikut.

Setelah dibuat

Setelah membuat permintaan reservasi pada masa mendatang, Anda tidak dapat mengubah hal berikut properti:

  • Nama permintaan reservasi yang akan datang.

  • Project tempat permintaan reservasi di masa mendatang dibuat.

  • Zona tempat permintaan reservasi mendatang berada.

  • Template instance yang akan digunakan dan properti VM yang ditentukan dalam instance {i>template<i}.

Untuk mengubah salah satu properti ini sebelum permintaan reservasi mendatang memasukkan waktu kunci, buat permintaan baru.

Sebelum pengiriman

Sebelum mengirimkan permintaan reservasi mendatang ke Google Cloud untuk ditinjau, atau setelah mengirimkan permintaan reservasi berikutnya untuk ditinjau dan ditolak, Anda dapat mengubah properti berikut:

  • Opsi hapus otomatis

  • Deskripsi

  • GPU dan jenis GPU

  • Disk SSD lokal dan jenis antarmuka disk

  • Seri mesin dan jenis mesin

  • Platform CPU minimum

  • Awalan nama

  • Setelan berbagi

  • Waktu mulai dan waktu berakhirnya periode pemesanan

  • Jumlah total (Jumlah VM)

Draf status permintaan reservasi mendatang dapat segera diubah, dan ada berapa kali Anda dapat mengubahnya. Jika Anda memodifikasi menolak (DECLINED) permintaan reservasi di masa mendatang, maka Anda hanya dapat mengubah minta jika Anda mengirimkannya lagi untuk ditinjau.

Setelah persetujuan

Setelah Google Cloud menyetujui reservasi di masa mendatang, Anda dapat mengubahnya sebelum reservasi di masa depan mencapai status pengadaan yaitu penyediaan (PROVISIONING). Secara khusus, Anda dapat mengubah properti berikut:

  • Dengan mengubah reservasi yang akan datang kapan saja:

    • Opsi hapus otomatis

    • Deskripsi

    • Awalan nama

  • Dengan mengirimkan permintaan modifikasi tidak lebih awal dari 72 jam sebelum waktu mulai:

    • GPU dan jenis GPU*

    • Disk 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 secara signifikan menambah atau mengurangi total jumlah, dalam waktu 14 hari dari masa mendatang waktu mulai reservasi, maka Google Cloud kemungkinan akan menolak permintaan modifikasi.

Mengubah permintaan pemesanan untuk masa mendatang

Sebelum mengubah permintaan reservasi mendatang, tinjau properti yang dapat diubah, jika Anda belum .

Jika Anda ingin mengubah permintaan reservasi untuk satu project pada masa mendatang yang dibuat melalui template instance ke permintaan reservasi bersama di masa mendatang, lalu Anda tidak dapat menggunakan template yang sama untuk membuat VM yang dapat menggunakan template yang dibuat otomatis pemesanan di luar project yang membuat reservasi bersama mendatang permintaan. Untuk project yang diajak berbagi reservasi mendatang, Anda harus membuat template instance serupa dalam project tersebut atau buat VM dengan menentukan properti secara langsung.

Untuk mengubah permintaan reservasi pada masa mendatang, pilih salah satu opsi berikut:

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Future reservations.

  3. Di kolom Nama, klik nama permintaan reservasi yang akan datang yang ingin Anda modifikasi.

    Halaman detail permintaan reservasi mendatang yang dipilih akan terbuka.

  4. Jika Anda ingin mengubah opsi, deskripsi, atau nama hapus otomatis dari pemesanan mendatang yang disetujui, lalu lakukan satu atau beberapa berikut ini:

    • Untuk mengubah opsi hapus otomatis, di Baris waktu hapus otomatis reservasi yang dibuat otomatis, klik Edit, lalu lakukan berikut ini:

      1. Tentukan apakah Anda ingin mengaktifkan, menonaktifkan, atau mengubah opsi hapus otomatis dengan melakukan salah satu tindakan berikut:

        • Untuk mengaktifkan opsi hapus otomatis atau mengubah waktu saat Compute Engine secara otomatis menghapus reservasi yang dibuat otomatis, lakukan tindakan berikut:

          1. Klik tombol Aktifkan hapus otomatis ke aktif posisi Anda.

          2. Opsional: Untuk Hapus otomatis waktu, masukkan tanggal dan waktu saat menghapus reservasi yang dibuat otomatis. Tujuan tanggal dan waktu harus setelah waktu berakhir periode reservasi. Jika Anda mengosongkan {i>field<i} ini, reservasi yang dibuat otomatis akan dihapus dalam dua jam setelah waktu berakhir periode reservasi.

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

      2. Klik Kirim.

    • Untuk mengubah awalan nama, di baris Awalan, klik Edit, lalu lakukan berikut ini:

      1. Untuk Prefix, masukkan awalan nama baru.

      2. Klik Kirim.

    • Untuk mengubah deskripsi, di baris Deskripsi, klik Edit, lalu lakukan berikut ini:

      1. Untuk Description, masukkan deskripsi baru.

      2. Klik Kirim.

  5. Klik Edit atau Edit draf.

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

  6. Untuk mengubah permintaan reservasi mendatang dan mengirimkannya ke Google Cloud untuk ditinjau, atau simpan draf permintaan, lakukan satu atau beberapa dari yang berikut ini:

    • Untuk Prefix, masukkan awalan nama baru untuk nama yang dibuat otomatis reservasi yang disediakan untuk permintaan reservasi mendatang ini.

    • Untuk Description, masukkan deskripsi baru.

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

      • Waktu mulai tidak boleh lebih dari satu tahun dari tanggal dan waktu ketika Anda mengirimkan permintaan reservasi pada masa mendatang untuk ulasan.

      • 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 berbagi permintaan reservasi di masa mendatang. Anda dapat menyertakan hingga 100 project.

    • Untuk Jumlah instance VM, masukkan jumlah total VM yang yang ingin dipesan.

    • Jika Anda mengubah reservasi mendatang yang tidak dibuat melalui template instance, lalu di kolom Machine configuration Anda dapat mengubah hal berikut:

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

      • GPU yang akan dipasang ke VM yang dipesan.

      • Disk SSD Lokal dan jenis antarmuka disk penyimpanan atau VM.

    • Di bagian Hapus otomatis reservasi yang dibuat otomatis, Anda dapat aktifkan atau nonaktifkan penghapusan otomatis opsi pemesanan untuk permintaan reservasi Anda di masa mendatang.

  7. Bergantung pada status pengadaan permintaan reservasi di masa mendatang yang Anda modifikasi, lakukan salah satu hal berikut:

    • Jika Anda mengubah draf permintaan reservasi mendatang, lakukanlah dari yang berikut ini:

      • Untuk menyimpan perubahan, klik Simpan draf.

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

    • Jika tidak, klik Kirim.

Jika Anda mengirimkan permintaan perubahan, halaman Reservasi akan terbuka. Jika tidak, halaman detail reservasi mendatang akan terbuka.

gcloud

Untuk mengubah permintaan reservasi di masa mendatang, 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 \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform=MIN_CPU_PLATFORM \
    --name-prefix=NAME_PREFIX \
    --planning-status=PLANNING_STATUS \
    --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 masa depan permintaan reservasi.

  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Tentukan salah satu nilai berikut:

    • Untuk mengubah draf permintaan reservasi mendatang tanpa mengirimkannya untuk ditinjau: DRAFT.

    • Untuk mengirimkan permintaan reservasi mendatang agar ditinjau: SUBMITTED.

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

Ganti satu atau beberapa {i>placeholder<i} berikut, atau hapus bersama dengan penanda yang sesuai:

  • Agar Compute Engine dapat otomatis menghapus reservasi yang dibuat otomatis setelah waktu berakhir periode reservasi, lakukan salah satu hal berikut:

    • Untuk menghapus reservasi dalam waktu dua jam setelah waktu berakhir (default), menyertakan --auto-delete-auto-created-reservations penanda.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      
    • Untuk menghapus reservasi yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode reservasi, --auto-delete-auto-created-reservations dan --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

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

    • Untuk menghapus reservasi yang dibuat otomatis setelah durasi tertentu setelah waktu berakhir periode reservasi, --auto-delete-auto-created-reservations dan --auto-created-reservations-duration.

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      

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

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus reservasi yang dibuat otomatis dan disediakan untuk reservasi mendatang ini menyertakan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --planning-status=PLANNING_STATUS \
        --zone=ZONE
    
  • Untuk menambahkan atau menghapus GPU yang terpasang ke VM N1 yang dicadangkan, atau mengupdate GPU lakukan, lakukan salah satu langkah berikut:

    • Untuk mengubah jumlah dan jenis GPU, ganti kode berikut:

      • NUMBER_OF_ACCELERATORS: jumlah GPU yang akan per VM yang dicadangkan.

      • ACCELERATOR_TYPE: jenis GPU yang akan ditambahkan VM yang dicadangkan. Pastikan bahwa GPU tersedia di zona lokasi permintaan reservasi yang akan datang. Jika tidak, memodifikasi permintaan akan gagal.

    • Untuk menghapus semua GPU yang terpasang ke VM N1 yang dicadangkan, ganti Flag --accelerator dengan flag --clear-accelerator.

  • DESCRIPTION: Deskripsi baru untuk masa depan Anda permintaan reservasi.

  • Untuk menambahkan atau menghapus disk SSD Lokal dari VM yang dicadangkan, atau edit Jenis antarmuka disk SSD lokal, lakukan salah satu langkah berikut:

    • Untuk menambahkan disk SSD Lokal atau mengedit jenis antarmuka disk, ganti INTERFACE dengan salah satu nilai berikut:

      Sertakan tanda --local-ssd untuk sebanyak disk SSD Lokal yang Anda Anda ingin tambahkan. Anda dapat menentukan maksimal 24 disk SSD Lokal.

    • Untuk menghapus semua disk SSD Lokal yang terpasang ke VM yang dicadangkan, hapus semua flag --local-ssd dan menyertakan flag --clear-local-ssd.

  • MACHINE_TYPE: Jenis mesin baru yang akan digunakan untuk setiap VM yang dicadangkan. Jika Anda mengubah jenis mesin, pastikan untuk menentukan juga suatu periode reservasi minimum yang direkomendasikan untuk seri mesin baru. Jika tidak, Google Cloud mungkin untuk menolak permintaan modifikasi Anda.

  • MINIMUM_CPU_PLATFORM: Platform CPU minimum baru untuk untuk setiap VM yang dicadangkan.

  • NAME_PREFIX: Awalan nama baru untuk nama yang dibuat otomatis yang disediakan untuk permintaan reservasi Anda di masa mendatang.

  • SHARE_SETTING: Jenis berbagi baru untuk masa depan Anda permintaan reservasi. Tentukan salah satu nilai berikut:

    • Untuk permintaan reservasi satu project di masa mendatang: local. Untuk menghindari error, Anda juga harus mengganti flag --share-with dengan tanda --clear-share-settings.

    • Untuk permintaan reservasi bersama mendatang: projects. Untuk menghindari Anda juga harus menentukan setidaknya satu project konsumen dalam --share-with.

  • CONSUMER_PROJECT_IDS: Daftar ID yang dipisahkan koma project yang ingin Anda bagikan permintaan reservasi mendatang dengan—misalnya, project-1,project-2. Anda dapat menentukan hingga 100 proyek konsumen.

  • START_TIME: Waktu mulai reservasi yang baru periode diformat sebagai Stempel waktu RFC 3339. Awal waktu tidak boleh lebih dari satu tahun dari tanggal dan waktu saat Anda kirim permintaan modifikasi untuk ditinjau. Untuk memiliki cukup waktu untuk jika Anda mau, mereka dapat membatalkan, menghapus, atau mengubah reservasi di masa mendatang setelah dan sebelum memasuki waktu kunci, tentukan waktu mulai yang direkomendasikan.

  • END_TIME: Waktu berakhir yang baru dari periode reservasi diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda --end-time dengan flag --duration=END_DURATION. Ganti END_DURATION dengan durasi reservasi periode dalam detik. Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan reservasi berikutnya setelah mengirimkannya untuk ditinjau, tentukan periode reservasi yang direkomendasikan.

  • TOTAL_COUNT: Jumlah total VM baru yang Anda yang ingin dicadangkan untuk periode, konfigurasi VM, dan project yang ditentukan pada permintaan reservasi Anda di masa mendatang. Jika Anda ingin meningkatkan total memastikan bahwa Anda memiliki cukup kuota untuk resource yang yang Anda pesan. Jika tidak, Google Cloud akan menolak permintaan modifikasi.

Misalnya, pertimbangkan draf permintaan reservasi bersama mendatang yang bernama fr-03 dan berada di zona us-central1-a. Misalkan Anda ingin memodifikasi permintaan reservasi bersama pada masa mendatang ini dengan melakukan perubahan berikut:

  • Mengonversi permintaan menjadi permintaan reservasi mendatang untuk satu project.

  • Menonaktifkan opsi hapus otomatis.

  • Pesan 100 VM.

  • Kirim permintaan reservasi mendatang ke Google Cloud untuk ditinjau.

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 \
    --share-setting=local \
    --total-count=100 \
    --zone=us-central1-a

REST

Untuk mengubah permintaan reservasi pada masa mendatang, buat permintaan PATCH ke Metode beta.futureReservations.update.

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 masa depan permintaan reservasi.

  • UPDATE_FIELDS: daftar kolom yang dipisahkan koma untuk perbarui di isi permintaan. Anda harus mengenkode setiap koma sebagai %2C. Jika Anda tentukan kolom di parameter kueri updateMask dan dalam permintaan {i>body<i}, maka nilai ini akan memperbarui nilai {i>field<i}. Atau, jika Anda tentukan kolom hanya di parameter kueri updateMask, lalu akan menghapus {i>field<i} tersebut.

    Misalnya, untuk mengupdate autoDeleteAutoCreatedReservations, kolom totalCount dan endTime dalam permintaan reservasi Anda pada masa mendatang, menentukan hal berikut:

    autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
    
  • PLANNING_STATUS: status perencanaan permintaan pemesanan untuk masa mendatang. Tentukan salah satu nilai berikut:

    • Untuk mengubah draf permintaan reservasi mendatang tanpa mengirimkannya untuk ditinjau: DRAFT.

    • Untuk mengirimkan permintaan modifikasi agar ditinjau: SUBMITTED.

Ganti satu atau beberapa {i>placeholder<i} berikut, atau hapus bersama dengan kolom yang sesuai:

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Jika Anda menetapkan kolom ini ke true, lalu Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis dan disediakan untuk reservasi Anda pada masa mendatang permintaan. Secara default, penghapusan memerlukan waktu dua jam setelah waktu berakhir periode reservasi. Untuk mengubahnya, lakukan salah satu hal berikut:

    • Untuk menghapus reservasi yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode reservasi Anda, setel autoDeleteAutoCreatedReservations ke true dan menentukan Kolom autoCreatedReservationsDeleteTime.

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      Ganti DELETE_TIME dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai Stempel waktu RFC 3339.

    • Untuk menghapus reservasi yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode reservasi, tetapkan autoDeleteAutoCreatedReservations ke true dan menentukan Kolom autoCreatedReservationsDuration.

      PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus
      
      {
        "autoDeleteAutoCreatedReservations": "true",
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "name": "FUTURE_RESERVATION_NAME",
        "planningStatus": "PLANNING_STATUS"
      }
      

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 selama 604.800 detik (7 hari).

  • DESCRIPTION: Deskripsi baru untuk masa mendatang permintaan reservasi.

  • NAME_PREFIX: Awalan nama baru untuk nama yang dibuat otomatis yang disediakan untuk permintaan reservasi Anda di masa mendatang.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID project yang Anda ingin berbagi permintaan reservasi Anda yang akan datang. Proyek-proyek tersebut harus dalam organisasi yang sama dengan project pemilik. Anda dapat menentukan hingga 100 proyek konsumen.

  • SHARE_TYPE: Jenis berbagi baru untuk masa depan Anda permintaan reservasi. Lakukan salah satu hal berikut:

    • Untuk menentukan permintaan reservasi satu project di masa mendatang, lakukan metode berikut ini:

      • Tentukan LOCAL

      • Hapus kolom shareSettings.projects.

    • Untuk menentukan permintaan reservasi bersama mendatang, lakukan hal berikut:

      • Tentukan SPECIFIC_PROJECTS

      • Tentukan setidaknya satu project konsumen di Kolom shareSettings.projects. Proyek konsumen harus di organisasi yang sama dengan project pemilik. Anda dapat menentukan hingga hingga 100 project konsumen.

  • Untuk mengubah jumlah dan jenis GPU yang akan dipasang ke VM N1 yang dicadangkan, ganti yang berikut ini:

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

    • ACCELERATOR_TYPE: jenis GPU yang akan ditambahkan ke VM yang dipesan. Pastikan bahwa GPU tersedia di zona lokasi permintaan reservasi yang akan datang. Jika tidak, memodifikasi permintaan akan gagal.

  • INTERFACE_1 dan INTERFACE_2: jenis antarmuka disk untuk disk SSD Lokal yang terpasang VM yang dicadangkan. Tentukan salah satu nilai berikut:

  • MACHINE_TYPE: Jenis mesin baru yang akan digunakan untuk setiap VM yang dicadangkan. Jika Anda mengubah jenis mesin, pastikan untuk menentukan juga suatu periode reservasi minimum yang direkomendasikan. untuk seri mesin baru. Jika tidak, Google Cloud kemungkinan kecil untuk menyetujui permintaan modifikasi Anda.

  • MINIMUM_CPU_PLATFORM: Platform CPU minimum baru untuk untuk setiap VM yang dicadangkan.

  • TOTAL_COUNT: Jumlah total VM baru yang Anda yang ingin dicadangkan untuk periode, konfigurasi VM, dan project yang ditentukan pada permintaan reservasi mendatang. Jika Anda ingin meningkatkan total memastikan bahwa Anda memiliki cukup kuota untuk resource yang yang Anda pesan. Jika tidak, Google Cloud akan menolak permintaan modifikasi.

  • START_TIME: Waktu mulai reservasi yang baru periode diformat sebagai Stempel waktu RFC 3339. Awal waktu tidak boleh lebih dari satu tahun dari tanggal dan waktu saat Anda kirim permintaan modifikasi untuk ditinjau. Untuk memiliki cukup waktu untuk jika Anda mau, mereka dapat membatalkan, menghapus, atau mengubah reservasi di masa mendatang setelah dan sebelum memasuki waktu kunci, tentukan waktu mulai yang direkomendasikan.

  • END_TIME: Waktu berakhir yang baru dari periode reservasi 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 awal waktu periode reservasi:

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus
    
    {
      "name": "FUTURE_RESERVATION_NAME",
      "planningStatus": "PLANNING_STATUS",
      "timeWindow": {
        "duration": {
          "seconds": "END_DURATION"
        }
      }
    }
    

    Ganti END_DURATION dengan durasi dalam detik. Sebagai misalnya, tentukan 1209600 selama 1.209.600 detik (14 hari). Untuk meningkatkan kemungkinan Google Cloud menyetujui reservasi pada masa mendatang setelah Anda mengirimkannya untuk ditinjau, tentukan periode reservasi yang direkomendasikan.

Misalnya, pertimbangkan draf permintaan reservasi bersama mendatang yang bernama fr-03 dan berada di zona us-central1-a. Misalkan Anda ingin memodifikasi permintaan reservasi bersama pada masa mendatang ini dengan melakukan perubahan berikut:

  • Mengonversi permintaan menjadi permintaan reservasi mendatang untuk satu project.

  • Menonaktifkan opsi hapus otomatis.

  • Pesan 100 VM.

  • Kirim permintaan reservasi mendatang ke Google Cloud untuk ditinjau.

Untuk mengubah fr-03, buat permintaan PATCH sebagai 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 mengubah permintaan reservasi di masa mendatang, Anda dapat memantau pengadaannya atau memperbarui status berdasarkan melihat detail permintaan reservasi pada masa mendatang.

Mengubah properti lainnya dalam permintaan reservasi pada masa mendatang

Untuk mengubah properti yang tidak dapat diubah setelah membuat permintaan reservasi untuk masa mendatang, dan sebelum permintaan disetujui dan memasuki waktu kunci, lakukan hal berikut:

  1. Untuk menghentikan permintaan reservasi mendatang agar tidak membatasi jenis masa mendatang permintaan reservasi yang dapat Anda buat dalam project, atau dalam project yang digunakan untuk berbagi permintaan reservasi, menghapus permintaan reservasi yang akan datang.

  2. Buat baru project tunggal atau berbagi permintaan reservasi mendatang dengan pembaruan yang Anda inginkan.

Memecahkan masalah

Jika Anda mengalami error saat mengubah permintaan reservasi di masa mendatang, lihat petunjuk memecahkan masalah permintaan reservasi di masa mendatang.

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

Langkah selanjutnya