Mengubah permintaan pemesanan untuk masa mendatang


Dokumen ini menjelaskan cara mengubah permintaan pemesanan untuk masa mendatang.

Anda dapat mengubah permintaan pemesanan untuk masa mendatang kapan saja sebelum waktu mulainya, asalkan belum dibatalkan atau tidak menunggu persetujuan. Mengubah permintaan pemesanan untuk masa mendatang berguna saat kebutuhan kapasitas Anda berubah—misalnya, saat Anda ingin meningkatkan jumlah instance virtual machine (VM) yang direservasi atau mengubah periode pemesanan. Jika ingin mengubah permintaan pemesanan untuk masa mendatang bersama, Anda harus mengubah permintaan menggunakan project pemilik.

Untuk mengubah pemesanan yang dibuat otomatis setelah periode pemesanannya berakhir, lihat Mengubah pemesanan.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.
    3. REST

      Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command:

        gcloud init

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengubah permintaan pemesanan untuk masa mendatang, minta administrator untuk memberi Anda peran IAM Compute Future Reservation Admin (roles/compute.futureReservationAdmin) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditentukan ini berisi izin compute.futureReservations.update, yang diperlukan untuk mengubah permintaan pemesanan untuk masa mendatang.

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

Properti yang dapat diubah

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

Setelah pembuatan

Setelah membuat permintaan pemesanan untuk masa mendatang, Anda tidak dapat mengubah properti berikut:

  • Nama permintaan pemesanan untuk masa mendatang.

  • Project tempat permintaan pemesanan untuk masa mendatang dibuat.

  • Zona tempat permintaan pemesanan untuk masa mendatang berada.

  • Template instance yang akan digunakan dan properti VM yang ditentukan dalam template instance.

Untuk mengubah salah satu properti ini sebelum permintaan pemesanan untuk masa mendatang memasuki waktu penguncian, buat permintaan baru.

Sebelum pengiriman

Sebelum mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau, atau setelah mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau dan permintaan tersebut 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)

Mengubah status draf permintaan pemesanan untuk masa mendatang akan langsung dilakukan, dan tidak ada batasan frekuensi Anda dapat mengubahnya. Jika mengubah permintaan pemesanan untuk masa mendatang yang ditolak (DECLINED), Anda hanya dapat mengubah permintaan tersebut jika mengirimkannya lagi untuk ditinjau.

Setelah persetujuan

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

  • Dengan mengubah pemesanan untuk masa mendatang kapan saja:

    • Opsi hapus otomatis

    • Deskripsi

    • Awalan nama

  • Dengan mengirimkan permintaan perubahan 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 meningkatkan atau mengurangi jumlah total secara signifikan, dalam waktu 14 hari sejak waktu mulai pemesanan untuk masa mendatang, Google Cloud kemungkinan akan menolak permintaan perubahan Anda.

Mengubah permintaan pemesanan untuk masa mendatang

Sebelum mengubah permintaan pemesanan untuk masa mendatang, tinjau properti yang dapat Anda ubah, jika Anda belum melakukannya.

Jika ingin mengubah permintaan pemesanan untuk masa mendatang bagi satu project yang dibuat melalui template instance menjadi permintaan pemesanan untuk masa mendatang bersama, Anda tidak dapat menggunakan template yang sama untuk membuat VM yang dapat menggunakan pemesanan yang dibuat otomatis di luar project yang membuat permintaan pemesanan untuk masa mendatang bersama. Untuk project yang dibagikan dengan pemesanan untuk masa mendatang, Anda harus membuat template instance yang serupa dalam project tersebut atau membuat VM dengan menentukan properti secara langsung.

Untuk mengubah permintaan pemesanan untuk 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 Name, klik nama permintaan pemesanan untuk masa mendatang yang ingin Anda ubah.

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

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

    • Untuk mengubah opsi hapus otomatis, di baris Auto-created reservations auto-delete time, klik Edit, lalu lakukan tindakan berikut:

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

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

          1. Klik tombol Aktifkan hapus otomatis ke posisi aktif.

          2. Opsional: Untuk Auto-delete time, 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 dua jam setelah waktu berakhirnya periode pemesanan.

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

      2. Klik Submit.

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

      1. Untuk Awalan, masukkan awalan nama baru.

      2. Klik Submit.

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

      1. Untuk Deskripsi, masukkan deskripsi baru.

      2. Klik Submit.

  5. Klik Edit atau Edit draf.

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

  6. Untuk mengubah permintaan pemesanan untuk masa mendatang dan mengirimkannya ke Google Cloud untuk ditinjau, atau menyimpan draf permintaan, lakukan satu atau beberapa hal berikut:

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

    • Untuk 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 satu tahun sejak tanggal dan waktu 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 permintaan pemesanan untuk masa mendatang. Anda dapat menyertakan hingga 100 project.

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

    • Jika Anda mengubah pemesanan untuk masa mendatang yang tidak dibuat melalui template instance, 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.

      • Disk SSD Lokal dan jenis antarmuka disk VM yang dipesan.

    • Di bagian Auto-generated reservations auto-delete, Anda dapat mengaktifkan atau menonaktifkan penghapusan otomatis pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang Anda.

  7. Bergantung pada status pengadaan permintaan pemesanan untuk masa mendatang yang Anda ubah, lakukan salah satu hal berikut:

    • Jika Anda mengubah draf permintaan pemesanan untuk masa mendatang, lakukan salah satu hal berikut:

      • Untuk menyimpan perubahan, klik Simpan draf.

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

    • Jika tidak, klik Submit.

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

gcloud

Untuk mengubah permintaan pemesanan untuk 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 permintaan pemesanan untuk masa mendatang.

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

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

    • Untuk mengirimkan permintaan pemesanan untuk masa mendatang guna ditinjau: SUBMITTED.

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

Ganti satu atau beberapa placeholder berikut, atau hapus bersama dengan flag yang sesuai:

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

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

      gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
          --auto-delete-auto-created-reservations \
          --planning-status=PLANNING_STATUS \
          --zone=ZONE
      
    • Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, sertakan flag --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 pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, sertakan flag --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 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 dan disediakan untuk permintaan pemesanan untuk masa mendatang ini, sertakan 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 dipesan, atau memperbarui jenis GPU, lakukan salah satu tindakan berikut:

    • Untuk mengubah jumlah dan jenis GPU, ganti 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 GPU tersedia di zona tempat permintaan pemesanan untuk masa mendatang berada. Jika tidak, perubahan permintaan akan gagal.

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

  • DESCRIPTION: Deskripsi baru untuk permintaan pemesanan untuk masa mendatang.

  • Untuk menambahkan atau menghapus disk SSD Lokal dari VM yang dipesan, atau mengedit jenis antarmuka disk SSD Lokal, lakukan salah satu tindakan berikut:

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

      Sertakan flag --local-ssd untuk sebanyak mungkin disk SSD Lokal yang ingin Anda tambahkan. Anda dapat menentukan maksimum 24 disk SSD Lokal.

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

  • MACHINE_TYPE: Jenis mesin baru yang akan digunakan untuk setiap VM yang direservasi. Jika Anda mengubah jenis mesin, pastikan untuk juga menentukan periode pemesanan minimum yang direkomendasikan untuk seri mesin baru. Jika tidak, Google Cloud kemungkinan akan menolak permintaan perubahan Anda.

  • MINIMUM_CPU_PLATFORM: Platform CPU minimum baru yang akan digunakan untuk setiap VM yang dipesan.

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

  • SHARE_SETTING: Jenis berbagi baru untuk permintaan pemesanan untuk masa mendatang. Tentukan salah satu nilai berikut:

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

    • Untuk permintaan pemesanan untuk masa mendatang bersama: projects. Untuk menghindari error, Anda juga harus menentukan setidaknya satu project konsumen dalam flag --share-with.

  • CONSUMER_PROJECT_IDS: Daftar ID project yang dipisahkan koma yang ingin Anda ajak berbagi permintaan pemesanan untuk masa mendatang, misalnya project-1,project-2. Anda dapat menentukan hingga 100 project konsumen.

  • START_TIME: Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari satu tahun sejak tanggal dan waktu Anda mengirimkan permintaan perubahan untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang secara opsional setelah disetujui dan sebelum memasuki waktu penguncian, tentukan waktu mulai yang direkomendasikan.

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

  • TOTAL_COUNT: Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang. Jika Anda ingin meningkatkan jumlah total, pastikan Anda memiliki kuota yang cukup untuk resource yang Anda pesan. Jika tidak, Google Cloud akan menolak permintaan perubahan 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 permintaan 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 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 pemesanan untuk 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 permintaan pemesanan untuk masa mendatang.

  • UPDATE_FIELDS: daftar kolom yang dipisahkan koma untuk diperbarui dalam isi permintaan. Anda harus mengenkode setiap koma sebagai %2C. Jika Anda menentukan kolom dalam parameter kueri updateMask dan dalam isi permintaan, nilai kolom akan diperbarui. Jika tidak, jika Anda menentukan kolom hanya dalam parameter kueri updateMask, kolom tersebut akan dihapus.

    Misalnya, untuk memperbarui kolom autoDeleteAutoCreatedReservations, totalCount, dan endTime dalam permintaan reservasi mendatang, tentukan 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 pemesanan untuk masa mendatang tanpa mengirimkannya untuk ditinjau: DRAFT.

    • Untuk mengirimkan permintaan perubahan untuk ditinjau: SUBMITTED.

Ganti satu atau beberapa placeholder berikut, atau hapus placeholder tersebut beserta kolom yang sesuai:

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: Jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus pemesanan yang dibuat otomatis yang disediakan untuk permintaan pemesanan Anda di masa mendatang. Secara default, penghapusan dilakukan dalam waktu dua jam setelah waktu berakhir 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/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 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/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 permintaan pemesanan untuk masa mendatang.

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

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID project yang ingin Anda gunakan dalam pemesanan bersama. Project harus berada dalam organisasi yang sama dengan project pemilik. Anda dapat menentukan hingga 100 project konsumen.

  • SHARE_TYPE: Jenis berbagi baru untuk permintaan pemesanan untuk masa mendatang. Lakukan salah satu hal berikut:

    • Untuk menentukan permintaan pemesanan untuk masa mendatang bagi satu project, lakukan hal berikut:

      • Tentukan LOCAL

      • Hapus kolom shareSettings.projects.

    • Untuk menentukan permintaan pemesanan untuk masa mendatang bersama, lakukan langkah berikut:

      • Tentukan SPECIFIC_PROJECTS

      • Tentukan setidaknya satu project konsumen di kolom shareSettings.projects. Project konsumen harus berada dalam organisasi yang sama dengan project pemilik. Anda dapat menentukan hingga 100 project konsumen.

  • Untuk mengubah jumlah dan jenis GPU yang akan dilampirkan ke VM N1 yang dipesan, ganti 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 GPU tersedia di zona tempat permintaan pemesanan untuk masa mendatang berada. Jika tidak, perubahan permintaan akan gagal.

  • INTERFACE_1 dan INTERFACE_2: Jenis antarmuka disk untuk disk SSD Lokal yang dilampirkan ke setiap VM yang dipesan. Tentukan salah satu nilai berikut:

  • MACHINE_TYPE: Jenis mesin baru yang akan digunakan untuk setiap VM yang direservasi. Jika Anda mengubah jenis mesin, pastikan untuk juga menentukan periode pemesanan minimum yang direkomendasikan. untuk seri mesin baru. Jika tidak, Google Cloud kemungkinan besar tidak akan menyetujui permintaan perubahan Anda.

  • MINIMUM_CPU_PLATFORM: Platform CPU minimum baru yang akan digunakan untuk setiap VM yang dipesan.

  • TOTAL_COUNT: Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang. Jika Anda ingin meningkatkan jumlah total, pastikan Anda memiliki kuota yang cukup untuk resource yang Anda pesan. Jika tidak, Google Cloud akan menolak permintaan perubahan Anda.

  • START_TIME: Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari satu tahun sejak tanggal dan waktu Anda mengirimkan permintaan perubahan untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang secara opsional setelah disetujui dan sebelum memasuki waktu penguncian, tentukan waktu mulai yang direkomendasikan.

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

    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. Misalnya, tentukan 1209600 selama 1.209.600 detik (14 hari). Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, tentukan periode pemesanan yang direkomendasikan.

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 permintaan 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 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 pemesanan untuk masa mendatang, Anda dapat memantau status pengadaan atau updatenya dengan melihat detail permintaan pemesanan untuk masa mendatang.

Mengubah properti lain dalam permintaan reservasi untuk masa mendatang

Untuk mengubah properti yang tidak dapat Anda ubah setelah membuat permintaan pemesanan untuk masa mendatang, dan sebelum permintaan disetujui dan memasuki waktu penguncian, lakukan tindakan berikut:

  1. Untuk menghentikan permintaan pemesanan untuk masa mendatang agar tidak membatasi jenis permintaan pemesanan untuk masa mendatang yang dapat Anda buat di project, atau di project yang permintaan pemesanan untuk masa mendatang ini digunakan bersama, hapus permintaan pemesanan untuk masa mendatang.

  2. Buat project tunggal baru atau permintaan pemesanan untuk masa mendatang bersama 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.

Langkah selanjutnya