Halaman ini diterjemahkan oleh Cloud Translation API.

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 ingin mengubah permintaan pemesanan untuk masa mendatang bersama, Anda harus mengubah permintaan menggunakan project pemilik.

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

Sebelum memulai

Siapkan autentikasi jika Anda belum melakukannya. 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
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
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.

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 izin akses, yang diperlukan untuk mengubah permintaan reservasi di masa yang akan datang.

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 pemesanan untuk 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)

Mengubah status draf permintaan pemesanan untuk masa mendatang akan langsung dilakukan, dan tidak ada batasan frekuensi 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 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 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 pemesanan untuk masa mendatang, tinjau properti yang dapat Anda ubah, jika Anda belum melakukannya.

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

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Reservations
Klik tab Future reservations.
Di kolom Name, klik nama permintaan pemesanan untuk masa mendatang yang ingin Anda ubah.

Halaman detail permintaan reservasi mendatang yang dipilih akan terbuka.
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 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 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 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.
Klik Edit atau Edit draf.

Halaman untuk mengedit permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.
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 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 membagikan permintaan pemesanan untuk masa mendatang. Anda dapat menyertakan hingga 100 project.
- Untuk Jumlah instance VM, masukkan jumlah total VM yang yang ingin dipesan.
  
  Perhatian: Jika Anda ingin meningkatkan jumlah VM yang akan direservasi, memastikan bahwa Anda memiliki cukup kuota untuk resource tambahan yang Anda minta untuk direservasi. Jika tidak, Google Cloud akan menolak permintaan perubahan Anda.
- 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.
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 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 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 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 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 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 dicadangkan, atau mengupdate GPU lakukan, lakukan salah satu langkah berikut:
- Untuk mengubah jumlah dan jenis GPU, ganti hal 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:
  - Jika boot disk image Anda telah mengoptimalkan driver NVMe: nvme.
  - Atau: scsi.
  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 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 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 permintaan pemesanan untuk masa mendatang. 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 project yang dipisahkan koma yang ingin Anda ajak berbagi permintaan pemesanan untuk masa mendatang, 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.

Penting: Pastikan periode reservasi Anda tidak tumpang-tindih dengan periode reservasi dari permintaan reservasi mendatang lainnya yang ada dengan dan zona serta properti VM yang cocok, dan yang dibuat di atau dibagikan dengan proyek Anda saat ini. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.
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 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 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 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 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 permintaan pemesanan untuk masa mendatang.
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 project konsumen.
SHARE_TYPE: Jenis berbagi baru untuk permintaan pemesanan untuk masa mendatang. 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:
- Jika boot disk image Anda telah mengoptimalkan driver NVMe: NVME.
- Atau: SCSI.
  
  Anda dapat menentukan maksimal 24 disk SSD Lokal.
MACHINE_TYPE: Jenis mesin baru yang akan digunakan untuk setiap VM yang dicadangkan. Jika Anda mengubah jenis mesin, pastikan untuk menentukan juga a 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 perubahan Anda.
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.

Penting: Pastikan periode reservasi Anda tidak tumpang-tindih dengan periode reservasi dari permintaan reservasi mendatang lainnya yang ada dengan dan zona serta properti VM yang cocok, dan yang dibuat di atau dibagikan dengan proyek Anda saat ini. Atau, mengubah reservasi pada masa mendatang permintaan gagal.

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 Anda ubah setelah membuat permintaan pemesanan untuk masa mendatang, dan sebelum permintaan disetujui dan memasuki waktu penguncian, lakukan tindakan berikut:

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.
Buat baru project tunggal atau berbagi permintaan reservasi mendatang dengan pembaruan 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 pemecahan masalah, hubungi akun Anda atau Dukungan Google Cloud.

Langkah selanjutnya

Pelajari cara melihat permintaan pemesanan untuk masa mendatang.
Pelajari cara membatalkan atau menghapus permintaan pemesanan untuk masa mendatang.
Setelah waktu mulai periode reservasi, pelajari cara menggunakan reservasi yang dibuat otomatis.
Setelah waktu berakhir periode reservasi, pelajari cara mengubah reservasi yang dibuat otomatis.