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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
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.
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)
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)*
Di Konsol Google Cloud, buka halaman Pemesanan.
Klik tab Future reservations.
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.
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: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:
Klik tombol Aktifkan hapus otomatis ke posisi aktif.
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.
Klik Submit.
Untuk mengubah awalan nama, di baris Awalan, klik
Edit, lalu lakukan hal berikut:Untuk Awalan, masukkan awalan nama baru.
Klik Submit.
Untuk mengubah deskripsi, di baris Deskripsi, klik
Edit, lalu lakukan hal berikut:Untuk Deskripsi, masukkan deskripsi baru.
Klik Submit.
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 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.
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.
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.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, tentukan30m
selama 30 menit, atau1d2h3m4s
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:Jika image boot disk Anda telah mengoptimalkan driver NVMe:
nvme
.Atau:
scsi
.
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, misalnyaproject-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
. GantiEND_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.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.
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 kueriupdateMask
dan dalam isi permintaan, nilai kolom akan diperbarui. Jika tidak, jika Anda menentukan kolom hanya dalam parameter kueriupdateMask
, kolom tersebut akan dihapus.Misalnya, untuk memperbarui kolom
autoDeleteAutoCreatedReservations
,totalCount
, danendTime
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
.
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Jika Anda menetapkan kolom ini ketrue
, 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
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.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
ketrue
dan tentukan kolomautoCreatedReservationsDuration
.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, tentukan604800
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
danCONSUMER_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
danINTERFACE_2
: Jenis antarmuka disk untuk disk SSD Lokal yang dilampirkan ke setiap VM yang dipesan. Tentukan salah satu nilai berikut:Jika image disk booting Anda telah mengoptimalkan driver NVMe:
NVME
.Atau:
SCSI
.Anda dapat menentukan maksimum 24 disk SSD Lokal.
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 kolomendTime
dengan kolomduration
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, tentukan1209600
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.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 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.
Buat project tunggal baru atau permintaan pemesanan untuk masa mendatang bersama dengan update yang Anda inginkan.
Pelajari cara melihat permintaan pemesanan untuk masa mendatang.
Pelajari cara membatalkan atau menghapus permintaan pemesanan untuk masa mendatang.
Setelah waktu mulai periode pemesanan, pelajari cara menggunakan pemesanan yang dibuat otomatis.
Setelah waktu berakhir periode pemesanan, pelajari cara mengubah pemesanan yang dibuat otomatis.
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:
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:
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:* 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
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:
Ganti satu atau beberapa placeholder berikut, atau hapus bersama dengan flag yang sesuai:
Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama
fr-03
dan berada di zonaus-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut: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 metodebeta.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:
Ganti satu atau beberapa placeholder berikut, atau hapus placeholder tersebut beserta kolom yang sesuai:
Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama
fr-03
dan berada di zonaus-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:Untuk mengubah
fr-03
, buat permintaanPATCH
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:
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
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-22 UTC.
-