Dokumen ini menjelaskan cara mengelola permintaan pemesanan untuk masa mendatang. Secara khusus:
Mengubah draf atau permintaan pemesanan untuk masa mendatang yang dikirimkan untuk mengubah satu atau beberapa propertinya.
Membatalkan permintaan pemesanan untuk masa mendatang agar Google Cloud tidak meninjaunya atau menghentikan pemesanan untuk masa mendatang yang disetujui agar tidak memasuki waktu penguncian.
Menghapus pemesanan untuk masa mendatang sebelum memasuki waktu penguncian yang diperlukan atau setelah akhir periode pemesanannya.
Jika Anda ingin mengelola pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang yang terpenuhi setelah akhir periode pemesanannya, lihat hal berikut:
Sebelum memulai
-
Siapkan autentikasi, jika Anda belum melakukannya.
Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol
Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
gcloud
-
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
- Menetapkan region dan zona default.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
gcloud init
-
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk mengubah, membatalkan, atau menghapus permintaan reservasi mendatang,
minta administrator untuk memberi Anda peran IAM
Compute Future Reservasi Admin (roles/compute.futureReservationAdmin
) di project.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.
Peran yang telah ditentukan ini berisi izin yang diperlukan untuk mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang
-
Untuk membatalkan pemesanan untuk masa mendatang:
compute.futureReservations.cancel
di project -
Untuk menghapus pemesanan untuk masa mendatang:
compute.futureReservations.delete
pada project -
Untuk mengubah pemesanan untuk masa mendatang:
compute.futureReservations.update
pada project
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran yang telah ditetapkan sebelumnya.
Pembatasan
Selain pembatasan umum untuk pemesanan untuk masa mendatang, saat Anda mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang, pembatasan berikut akan berlaku:
Anda hanya dapat mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang dari dalam project tempat permintaan pemesanan untuk masa mendatang dibuat. Hal ini memungkinkan Anda membagikan permintaan reservasi mendatang ke project lain, tetapi pengguna yang hanya memiliki izin untuk project lain tidak dapat mengubah permintaan reservasi mendatang.
Anda hanya dapat mengubah, membatalkan, atau menghapus permintaan reservasi mendatang jika status pengadaannya memungkinkannya. Untuk mengetahui detailnya, lihat tabel berikut.
Status pengadaan Batal Hapus Mengubah Pembuatan draf ( DRAFTING
)Menunggu persetujuan ( PENDING_APPROVAL
)Disetujui ( APPROVED
)Ditolak ( DECLINED
)Dibatalkan ( CANCELED
)Pengadaan ( PROCURING
)Penyediaan ( PROVISIONING
)Terpenuhi ( FULFILLED
)* Terpenuhi sebagian ( FAILED_PARTIALLY_FULFILLED
)* Gagal ( FAILED
)* * Anda dapat menghapus reservasi mendatang yang telah terpenuhi, sebagian terpenuhi, atau gagal hanya setelah waktunya berakhir.
Mengubah permintaan pemesanan untuk masa mendatang
Anda dapat mengubah permintaan reservasi di masa mendatang sebelum mencapai status pengadaan
Penyediaan (PROVISIONING
) selama tidak dibatalkan atau menunggu
persetujuan. Saat mengubah permintaan pemesanan untuk masa mendatang, Anda tidak dapat mengubah
properti berikut:
Untuk pemesanan untuk masa mendatang:
Nama pemesanan untuk masa mendatang.
Project tempat permintaan pemesanan untuk masa mendatang dibuat.
Zona tempat pemesanan untuk masa mendatang berada.
Untuk permintaan pemesanan untuk masa mendatang yang dibuat dengan menentukan template instance:
Anda tidak dapat mengganti properti VM yang ditentukan dalam template instance.
Anda tidak dapat mengganti template instance yang digunakan untuk membuat permintaan pemesanan untuk masa mendatang dengan template lain.
Untuk mengubah salah satu properti ini, Anda harus membuat permintaan pemesanan untuk masa mendatang yang baru dengan update yang diinginkan.
Jika Anda ingin mengubah properti lain, pilih salah satu metode berikut:
Mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak.
Bagian ini menjelaskan cara mengubah permintaan reservasi pada masa mendatang dengan status pengadaan yang ditetapkan ke Pembuatan draf (
DRAFTING
) atau Ditolak (DECLINED
).Mengubah pengadaan pemesanan untuk masa mendatang atau yang ditolak .
Bagian ini menjelaskan cara mengubah reservasi pada masa mendatang dengan status pengadaan yang ditetapkan ke Disetujui (
APPROVED
) atau Pengadaan (PROCURING
). Jika ingin mengubah opsi hapus otomatis, deskripsi, atau awalan nama pada reservasi di masa mendatang, Anda dapat mengubahnya tanpa peninjauan. Atau, jika ingin mengubah properti lain, Anda memerlukan persetujuan Google Cloud.
Mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak.
Jika mengubah draf permintaan pemesanan untuk masa mendatang, Anda dapat menyimpan perubahan atau mengirimkan permintaan pemesanan untuk masa mendatang yang telah diperbarui ke Google Cloud untuk ditinjau. Jika mengubah permintaan pemesanan untuk masa mendatang yang ditolak, Anda harus mengirimkan permintaan tersebut untuk ditinjau.
Untuk mengubah properti draf atau permintaan pemesanan untuk masa mendatang yang ditolak, pilih salah satu metode berikut:
-
Bagian ini menjelaskan cara mengubah satu atau beberapa properti dalam draf atau menolak permintaan pemesanan untuk masa mendatang yang dibuat dengan menentukan template instance. Anda tidak dapat mengubah properti VM permintaan pemesanan untuk masa mendatang. Sebagai gantinya, Anda harus membuat pemesanan untuk masa mendatang yang baru.
-
Bagian ini menjelaskan cara mengubah satu atau beberapa properti dalam permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan properti secara langsung.
Ubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance.
Untuk permintaan reservasi pada masa mendatang yang dibuat dengan menentukan template instance dengan status pengadaan Draf (DRAFTING
) atau Ditolak (DECLINED
), Anda dapat mengubah properti berikut:
Hapus otomatis
Deskripsi
Awalan nama
Setelan berbagi
Waktu mulai dan waktu berakhirnya periode pemesanan
Jumlah total (Jumlah VM)
Anda dapat mengubah draf atau menolak permintaan reservasi mendatang yang dibuat dengan menentukan template instance menggunakan Konsol Google Cloud, gcloud CLI, dan REST.
Konsol
Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance, ikuti langkah-langkah berikut:
Di Konsol Google Cloud, buka halaman Pemesanan.
Klik tab Pemesanan untuk masa mendatang.
Di kolom Nama, klik nama permintaan pemesanan untuk masa mendatang yang ingin Anda ubah.
Halaman detail permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.
Untuk mengubah permintaan pemesanan untuk masa mendatang, klik
Edit atau Edit draf.Halaman untuk mengedit permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.
Lakukan satu atau beberapa hal berikut:
Di kolom Awalan, masukkan awalan nama baru.
Di kolom Deskripsi, masukkan deskripsi baru.
Ubah Waktu mulai atau Waktu berakhir untuk permintaan pemesanan untuk masa mendatang Anda. Pastikan hal berikut:
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau.
Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.
Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.
Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.
Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.
DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.
Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Di bagian Hapus otomatis pemesanan yang dibuat secara otomatis, Anda dapat mengaktifkan atau menonaktifkan penghapusan otomatis pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang Anda.
Opsional. Jika mengaktifkan opsi hapus otomatis, Anda dapat menentukan tanggal dan waktu saat Compute Engine menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhir periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhir periode reservasi.
Bergantung pada status pengadaan untuk permintaan reservasi di masa mendatang yang Anda ubah, lakukan salah satu hal berikut:
Untuk draf permintaan pemesanan untuk masa mendatang, pilih salah satu opsi berikut:
Untuk menyimpan perubahan, klik Simpan draf.
Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau, klik Kirim.
Untuk permintaan pemesanan untuk masa mendatang yang ditolak, Anda hanya dapat mengirimkannya untuk ditinjau dengan mengklik Kirim.
Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.
gcloud
Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance, gunakan perintah gcloud beta compute future-reservations update
.
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
--description="DESCRIPTION" \
--name-prefix=NAME_PREFIX \
--planning-status=PLANNING_STATUS \
--project=PROJECT_ID \
--share-setting=SHARE_SETTING \
--share-with=CONSUMER_PROJECT_IDS \
--start-time=START_TIME \
--end-time=END_TIME \
--total-count=TOTAL_COUNT \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak.
DESCRIPTION
: Opsional. Deskripsi baru untuk permintaan pemesanan untuk masa mendatang.
NAME_PREFIX
: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.
PROJECT_ID
: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah permintaan pemesanan untuk masa mendatang untuk satu project menjadi permintaan pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk permintaan pemesanan untuk masa mendatang. Jika Anda menghapus flag--project
, nilainya akan ditetapkan ke ID project saat ini.
SHARE_SETTING
: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan
projects
. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda--share-with
. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.Jika tidak, tentukan
local
.
CONSUMER_PROJECT_IDS
: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukanproject-1,project-2
. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang ini dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.START_TIME
: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.
END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda--end-time
dengan tanda--duration=END_DURATION
, denganEND_DURATION
adalah durasi periode reservasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Perhatian: Pastikan Anda memiliki kuota yang cukup untuk resource yang ingin Anda pesan. Jika tidak, Google Cloud akan menolak permintaan pemesanan untuk masa mendatang Anda.
ZONE
: zona tempat permintaan pemesanan untuk masa mendatang.
Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:
Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Ganti
AUTO_CREATED_RESERVATIONS_DELETE_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Ganti
DURATION_BEFORE_DELETE
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, 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, tentukan flag
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03
dan berada di zona us-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:
Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.
Menonaktifkan opsi hapus otomatis.
Pesan 100 VM.
Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.
Untuk mengubah fr-03
, jalankan perintah berikut:
gcloud beta compute future-reservations update fr-03 \
--clear-share-settings \
--no-auto-delete-auto-created-reservations \
--planning-status=SUBMITTED \
--project=example-project \
--total-count=100 \
--zone=us-central1-a
REST
Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan template instance, buat permintaan PATCH
ke
metode beta.futureReservations.update
.
Di parameter kueri updateMask
, tentukan setiap kolom yang ingin diperbarui.
Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask
dan hapus kolom tersebut dari isi permintaan.
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS
{
"autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
"description": "DESCRIPTION",
"name": "FUTURE_RESERVATION_NAME",
"namePrefix": "NAME_PREFIX",
"planningStatus": "PLANNING_STATUS",
"shareSettings": {
"projects": [
"CONSUMER_PROJECT_ID_1",
"CONSUMER_PROJECT_ID_2"
],
"shareType": "SHARE_TYPE"
},
"specificSkuProperties": {
"totalCount": "TOTAL_COUNT"
},
"timeWindow": {
"endTime": "END_TIME",
"startTime": "START_TIME"
}
}
Ganti kode berikut:
PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.FUTURE_RESERVATION_NAME
: nama draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak. Anda tidak dapat mengubah nama permintaan reservasi pada masa mendatang.UPDATE_FIELDS
: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaanPATCH
ini. Anda harus mengenkode setiap koma sebagai%2C
. Misalnya, jika Anda ingin memperbarui kolomautoDeleteAutoCreatedReservations
,totalCount
, danendTime
dalam permintaan reservasi mendatang, tentukan hal berikut:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opsional. Jika Anda menetapkan kolom ini ketrue
, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk permintaan reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Ganti
DELETE_TIME
dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Mengganti
DURATION_BEFORE_DELETE
dengan durasi dalam detik. Misalnya, tentukan604800
untuk 604.800 detik (7 hari).
DESCRIPTION
: Opsional. Untuk memperbarui deskripsi untuk permintaan reservasi mendatang, lakukan salah satu hal berikut:Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.
Untuk menghapus deskripsi, hapus kolom
description
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
NAME_PREFIX
: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.SHARE_TYPE
: Opsional. Untuk mengubah jenis berbagi permintaan reservasi mendatang, tentukan salah satu nilai berikut:Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan
SPECIFIC_PROJECTS
. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolomprojects
. Jika tidak, modifikasi permintaan reservasi mendatang akan gagal.Jika tidak, tentukan
LOCAL
. Selain itu, Anda harus menghapus kolomprojects
dari isi permintaan dan menentukannya dalamUPDATE_FIELDS
. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.
CONSUMER_PROJECT_ID_1
danCONSUMER_PROJECT_ID_2
: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatan. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
START_TIME
: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolomendTime
dengan kolomduration
untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:"duration": { "seconds": "END_DURATION" }
Ganti
END_DURATION
dengan durasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03
dan berada di zona us-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:
Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.
Menonaktifkan opsi hapus otomatis.
Pesan 100 VM.
Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.
Untuk mengubah fr-03
, buat permintaan PATCH
berikut:
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount
{
"autoDeleteAutoCreatedReservations": "false",
"name": "fr-03",
"planningStatus": "SUBMITTED",
"shareSettings": {
"shareType": "LOCAL"
},
"specificSkuProperties": {
"totalCount": "100"
}
}
Setelah Anda mengirimkan permintaan reservasi mendatang ke Google Cloud untuk ditinjau, lihat detailnya untuk memantau status pengadaan.
Mengubah pemesanan untuk masa mendatang versi draf atau yang ditolak dengan menentukan properti secara langsung
Untuk permintaan reservasi pada masa mendatang yang dibuat oleh properti secara langsung dengan status pengadaan yang ditetapkan ke Draf (DRAFTING
) atau Ditolak (DECLINED
), Anda dapat mengubah properti berikut:
Hapus otomatis
Deskripsi
Awalan nama
GPU
SSD lokal dan jenis antarmuka disk
Seri mesin dan jenis mesin
Platform CPU minimal
Setelan berbagi
Waktu mulai dan waktu berakhirnya periode pemesanan
Jumlah total (Jumlah VM)
Anda dapat mengubah draf atau menolak permintaan reservasi mendatang yang dibuat dengan menentukan properti secara langsung menggunakan konsol Google Cloud, gcloud CLI, dan REST.
Konsol
Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan properti secara langsung, ikuti langkah-langkah berikut .
Di konsol Google Cloud, buka halaman Pemesanan.
Klik tab Pemesanan untuk masa mendatang.
Di kolom Nama, klik nama permintaan pemesanan untuk masa mendatang yang ingin Anda ubah.
Halaman detail permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.
Untuk mengubah permintaan pemesanan untuk masa mendatang, klik
Edit atau Edit draf.Halaman untuk mengedit permintaan pemesanan untuk masa mendatang yang dipilih akan terbuka.
Lakukan satu atau beberapa hal berikut:
Di kolom Awalan, masukkan awalan nama baru.
Di kolom Deskripsi, masukkan deskripsi baru.
Ubah Waktu mulai atau Waktu berakhir untuk permintaan pemesanan untuk masa mendatang Anda. Pastikan hal berikut:
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau.
Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.
Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.
Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.
Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.
DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.
Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Di bagian Konfigurasi mesin, Anda dapat mengubah hal berikut:
Seri mesin dan jenis mesin yang digunakan di VM yang dipesan.
GPU yang akan dipasang ke VM yang dipesan.
SSD Lokal dan jenis antarmuka disk VM yang dipesan.
Bergantung pada status pengadaan untuk permintaan reservasi di masa mendatang yang Anda ubah, lakukan salah satu hal berikut:
Untuk draf permintaan pemesanan untuk masa mendatang, pilih salah satu opsi berikut:
Untuk menyimpan perubahan, klik Simpan draf.
Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau, klik Kirim.
Untuk permintaan pemesanan untuk masa mendatang yang ditolak, Anda hanya dapat mengirimkannya untuk ditinjau dengan mengklik Kirim.
Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.
gcloud
Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan properti secara langsung, gunakan perintah gcloud beta compute future-reservations update
.
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
--accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
--description="DESCRIPTION" \
--local-ssd=size=375,interface=INTERFACE_1 \
--local-ssd=size=375,interface=INTERFACE_2 \
--machine-type=MACHINE_TYPE \
--min-cpu-platform=MIN_CPU_PLATFORM \
--name-prefix=NAME_PREFIX \
--planning-status=PLANNING_STATUS \
--project=PROJECT_ID \
--share-setting=SHARE_SETTING \
--share-with=CONSUMER_PROJECT_IDS \
--start-time=START_TIME \
--end-time=END_TIME \
--total-count=TOTAL_COUNT \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak.
Opsional. Lakukan salah satu hal berikut:
Untuk menambahkan unit pemrosesan grafis (GPU) ke setiap VM yang dipesan, tentukan hal berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: jenis GPU yang akan ditambahkan ke VM yang dipesan.
Pastikan jenis mesin yang Anda tentukan dalam permintaan reservasi mendatang mendukung jenis GPU yang Anda tentukan dan bahwa GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.
Untuk menghapus semua GPU dari permintaan pemesanan untuk masa mendatangg ini, ganti flag
--accelerator
dengan flag--clear-accelerator
.
DESCRIPTION
: Opsional. Deskripsi baru untuk permintaan pemesanan untuk masa mendatang.
Opsional. Lakukan salah satu hal berikut:
Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti
INTERFACE_1
danINTERFACE_2
. Nilainya harus berupa salah satu dari berikut:Jika boot disk image telah mengoptimalkan driver NVMe, tentukan
nvme
.Jika tidak, tentukan
scsi
.
Ukuran setiap SSD lokal adalah 375 GB. Ulangi flag
--local-ssd
untuk setiap SSD lokal yang ingin Anda tambahkan. Anda dapat menentukan maksimum 24 SSD lokal.Untuk menghapus semua SSD lokal dari permintaan pemesanan untuk masa mendatang, hapus semua flag
--local-ssd
dan tentukan flag--clear-local-ssd
.
MACHINE_TYPE
: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.MINIMUM_CPU_PLATFORM
: Opsional. Platform CPU minimum yang akan digunakan untuk setiap VM. Jika Anda menghapus flag--min-cpu-platform
, nilainya akan ditetapkan ke platform CPU default zona.
NAME_PREFIX
: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.
PROJECT_ID
: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah permintaan pemesanan untuk masa mendatang untuk satu project menjadi permintaan pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk permintaan pemesanan untuk masa mendatang. Jika Anda menghapus flag--project
, nilainya akan ditetapkan ke ID project saat ini.
SHARE_SETTING
: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan
projects
. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda--share-with
. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.Jika tidak, tentukan
local
.
CONSUMER_PROJECT_IDS
: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukanproject-1,project-2
. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang ini dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.START_TIME
: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.
END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda--end-time
dengan tanda--duration=END_DURATION
, denganEND_DURATION
adalah durasi periode reservasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Perhatian: Pastikan Anda memiliki kuota yang cukup untuk resource yang ingin Anda pesan. Jika tidak, Google Cloud akan menolak permintaan pemesanan untuk masa mendatang Anda.
ZONE
: zona tempat permintaan pemesanan untuk masa mendatang.
Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:
Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Ganti
AUTO_CREATED_RESERVATIONS_DELETE_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Ganti
DURATION_BEFORE_DELETE
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, 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, tentukan flag
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03
dan berada di zona us-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:
Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.
Menonaktifkan opsi hapus otomatis.
Pesan 100 VM.
Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.
Untuk mengubah fr-03
, jalankan perintah berikut:
gcloud beta compute future-reservations update fr-03 \
--clear-share-settings \
--no-auto-delete-auto-created-reservations \
--planning-status=SUBMITTED \
--project=example-project \
--total-count=100 \
--zone=us-central1-a
REST
Untuk meminta Google Cloud mengubah permintaan pemesanan untuk masa mendatang versi draf atau yang ditolak yang dibuat dengan menentukan properti secara langsung, buatPATCH
ke
beta.futureReservations.update
metode ini.
Di parameter kueri updateMask
, tentukan setiap kolom yang ingin diperbarui.
Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask
dan hapus kolom tersebut dari isi permintaan.
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS
{
"autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
"description": "DESCRIPTION",
"name": "FUTURE_RESERVATION_NAME",
"namePrefix": "NAME_PREFIX",
"planningStatus": "PLANNING_STATUS",
"shareSettings": {
"projects": [
"CONSUMER_PROJECT_ID_1",
"CONSUMER_PROJECT_ID_2"
],
"shareType": "SHARE_TYPE"
},
"specificSkuProperties": {
"instanceProperties": {
"guestAccelerators": [
{
"acceleratorCount": NUMBER_OF_ACCELERATORS,
"acceleratorType": "ACCELERATOR_TYPE"
}
],
"localSsds": [
{
"diskSizeGb": "375",
"interface": "INTERFACE_1"
},
{
"diskSizeGb": "375",
"interface": "INTERFACE_2"
}
],
"machineType": "MACHINE_TYPE",
"minCpuPlatform": "MINIMUM_CPU_PLATFORM"
},
"totalCount": "TOTAL_COUNT"
},
"timeWindow": {
"endTime": "END_TIME",
"startTime": "START_TIME"
}
}
Ganti kode berikut:
PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.FUTURE_RESERVATION_NAME
: nama draf yang ada atau permintaan pemesanan untuk masa mendatang yang ditolak. Anda tidak dapat mengubah nama permintaan reservasi pada masa mendatang.UPDATE_FIELDS
: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaanPATCH
ini. Anda harus mengenkode setiap koma sebagai%2C
. Misalnya, jika Anda ingin memperbarui kolomautoDeleteAutoCreatedReservations
,totalCount
, danendTime
dalam permintaan reservasi mendatang, tentukan hal berikut:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opsional. Jika Anda menetapkan kolom ini ketrue
, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk permintaan reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Ganti
DELETE_TIME
dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Mengganti
DURATION_BEFORE_DELETE
dengan durasi dalam detik. Misalnya, tentukan604800
untuk 604.800 detik (7 hari).
DESCRIPTION
: Opsional. Untuk memperbarui deskripsi untuk permintaan reservasi mendatang, lakukan salah satu hal berikut:Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.
Untuk menghapus deskripsi, hapus kolom
description
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
NAME_PREFIX
: Opsional. Awalan nama baru untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.SHARE_TYPE
: Opsional. Untuk mengubah jenis berbagi permintaan reservasi mendatang, tentukan salah satu nilai berikut:Untuk mengubah permintaan pemesanan untuk masa mendatang satu project menjadi permintaan pemesanan untuk masa mendatang bersama, tentukan
SPECIFIC_PROJECTS
. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolomprojects
. Jika tidak, modifikasi permintaan reservasi mendatang akan gagal.Jika tidak, tentukan
LOCAL
. Selain itu, Anda harus menghapus kolomprojects
dari isi permintaan dan menentukannya dalamUPDATE_FIELDS
. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.
CONSUMER_PROJECT_ID_1
danCONSUMER_PROJECT_ID_2
: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatan. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk permintaan pemesanan untuk masa mendatang ini.
Opsional. Untuk mengupdate unit pemrosesan grafis (GPU) yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:
Untuk menambahkan atau mengubah GPU, tentukan hal berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: jenis GPU yang akan ditambahkan ke VM yang dipesan.
Pastikan jenis mesin yang Anda tentukan dalam permintaan reservasi mendatang mendukung jenis GPU yang Anda tentukan dan bahwa GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.
Untuk menghapus semua GPU dari permintaan reservasi mendatang ini, hapus kolom
guestAccelerators
dalam isi permintaan dan tentukan diUPDATE_FIELDS
.
Opsional. Untuk mengupdate SSD lokal yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:
Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti
INTERFACE_1
danINTERFACE_2
. Nilainya harus berupa salah satu dari berikut:Jika boot disk image telah mengoptimalkan driver NVMe, tentukan
NVME
.Jika tidak, tentukan
SCSI
.
Ulangi kolom
diskSizeGb
daninterface
untuk setiap SSD lokal yang ingin ditambahkan atau diperbarui. Anda dapat menentukan maksimum 24 SSD lokal.Untuk menghapus semua SSD lokal dari reservasi permintaan mendatang ini, hapus kolom
localSsds
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
MACHINE_TYPE
: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.MINIMUM_CPU_PLATFORM
: Opsional. Untuk mengupdate platform CPU minimum yang akan digunakan untuk setiap VM, lakukan salah satu hal berikut:Untuk menambahkan atau mengupdate platform CPU minimum, tentukan platform CPU minimum.
Untuk kembali ke platform CPU default zona, hapus kolom
minCpuPlatform
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
START_TIME
: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolomendTime
dengan kolomduration
untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:"duration": { "seconds": "END_DURATION" }
Ganti
END_DURATION
dengan durasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
Misalnya, pertimbangkan draf permintaan pemesanan untuk masa mendatang bersama bernama fr-03
dan berada di zona us-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang bersama ini dengan melakukan perubahan berikut:
Konversikan menjadi permintaan pemesanan untuk masa mendatang satu project.
Menonaktifkan opsi hapus otomatis.
Pesan 100 VM.
Kirimkan permintaan pemesanan untuk masa mendatang ke Google Cloud untuk mendapatkan persetujuan.
Untuk mengubah fr-03
, buat permintaan PATCH
berikut:
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount
{
"autoDeleteAutoCreatedReservations": "false",
"name": "fr-03",
"planningStatus": "SUBMITTED",
"shareSettings": {
"shareType": "LOCAL"
},
"specificSkuProperties": {
"totalCount": "100"
}
}
Setelah Anda mengirimkan permintaan reservasi mendatang ke Google Cloud untuk ditinjau, lihat detailnya untuk memantau status pengadaan.
Mengubah pemesanan untuk masa mendatang yang disetujui atau yang diperoleh
Untuk mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh, pilih salah satu metode berikut:
Mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan.
Bagian ini menjelaskan cara mengubah opsi hapus otomatis, deskripsi, dan awalan nama dalam pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan. Properti ini dapat langsung diubah, dan tidak ada batasan berapa kali Anda dapat mengubahnya hingga Google Cloud mulai membuat reservasi.
Permintaan untuk mengubah pemesanan di masa mendatang yang disetujui atau diperoleh.
Bagian ini menjelaskan cara meminta Google Cloud untuk mengubah satu atau beberapa properti dalam pemesanan untuk masa mendatang yang disetujui atau diperoleh. Anda hanya dapat mengirimkan permintaan untuk mengubah reservasi mendatang dengan status pengadaan Pengadaan (
PROCURING
).
Mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan.
Untuk reservasi pada masa mendatang dengan status pengadaan yang ditetapkan ke Disetujui (APPROVED
) atau Pengadaan (PROCURING
), Anda dapat mengubah kolom berikut tanpa persetujuan dari Google Cloud:
Hapus otomatis
Deskripsi
Awalan nama
Perubahan properti ini terjadi segera. Hingga waktu mulai periode reservasi reservasi di masa mendatang, tidak ada batasan berapa kali Anda dapat mengubah properti ini.
Anda dapat mengubah atau mendapatkan reservasi mendatang yang disetujui tanpa peninjauan menggunakan Konsol Google Cloud, gcloud CLI, dan REST.
Konsol
Untuk mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh tanpa peninjauan, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Pemesanan.
Klik tab Pemesanan untuk masa mendatang.
Di kolom Name, klik nama pemesanan untuk masa mendatang yang ingin Anda ubah.
Halaman detail pemesanan untuk masa mendatang yang dipilih akan terbuka.
Jika Anda ingin mengubah opsi hapus otomatis dan deskripsi pemesanan untuk masa mendatang, lakukan satu atau beberapa hal berikut:
Di baris waktu dihapus secara otomatis pemesanan yang dibuat otomatis , klik
Edit, lalu ikuti langkah-langkah berikut:Lakukan salah satu hal berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang, pilih salah satu metode berikut:
Klik tombol Aktifkan hapus otomatis ke posisi aktif.
Opsional: Di kolom Waktu dihapus otomatis, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.
Jika tidak, klik tombol Aktifkan hapus otomatis ke posisi nonaktif.
Klik Submit.
Di baris Awalan, klik
Edit, lalu lakukan hal berikut:Di kolom Awalan, masukkan awalan nama baru.
Klik Submit.
Di baris Deskripsi, klik
Edit, lalu lakukan hal berikut:Di kolom Deskripsi, masukkan deskripsi baru.
Klik Submit.
gcloud
Untuk
mengubah
pemesanan untuk masa mendatang yang disetujui atau diperoleh
tanpa peninjauan,,
gunakan
perintah gcloud beta compute future-reservations update
.
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
--description="DESCRIPTION" \
--name-prefix=NAME_PREFIX \
--project=PROJECT_ID \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama pemesanan untuk masa mendatang. yang sudah disetujui atau diperoleh.
DESCRIPTION
: Opsional. Deskripsi baru untuk pemesanan untuk masa mendatang.
NAME_PREFIX
: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PROJECT_ID
: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat.
ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.
Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:
Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Ganti
AUTO_CREATED_RESERVATIONS_DELETE_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Ganti
DURATION_BEFORE_DELETE
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, 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, tentukan flag
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-04
dan berada di zona us-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:
Mengaktifkan opsi hapus otomatis.
Otomatis menghapus reservasi yang dibuat otomatis setelah 864.000 detik (10 hari).
Tentukan awalan nama baru.
Untuk mengubah fr-04
, jalankan perintah berikut:
gcloud beta compute future-reservations update fr-04 \
--auto-delete-auto-created-reservations \
--auto-created-reservations-duration=864000 \
--name-prefix=new-prefix \
--project=example-project \
--zone=us-central1-a
REST
Untuk
mengubah
pemesanan untuk masa mendatang yang disetujui atau diperoleh
tanpa peninjauan,
buat permintaan PATCH
ke
metode beta.futureReservations.update
.
Di parameter kueri updateMask
, tentukan setiap kolom yang ingin diperbarui.
Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask
dan hapus kolom tersebut dari isi permintaan.
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS
{
"autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
"description": "DESCRIPTION",
"name": "FUTURE_RESERVATION_NAME",
"namePrefix": "NAME_PREFIX"
}
Ganti kode berikut:
PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.FUTURE_RESERVATION_NAME
: nama pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh. Anda tidak dapat mengubah nama reservasi di masa mendatang.UPDATE_FIELDS
: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaanPATCH
ini. Anda harus mengenkode setiap koma sebagai%2C
. Misalnya, jika Anda ingin memperbarui kolomdescription
dannamePrefix
pada reservasi mendatang, tentukan hal berikut:description%2CnamePrefix
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opsional. Jika Anda menetapkan kolom ini ketrue
, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Ganti
DELETE_TIME
dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Mengganti
DURATION_BEFORE_DELETE
dengan durasi dalam detik. Misalnya, tentukan604800
untuk 604.800 detik (7 hari).
DESCRIPTION
: Opsional. Untuk memperbarui deskripsi bagi reservasi mendatang, lakukan salah satu hal berikut:Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.
Untuk menghapus deskripsi, hapus kolom
description
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
NAME_PREFIX
: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-04
dan berada di zona us-central1-a
. Misalnya Anda ingin mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:
Mengaktifkan opsi hapus otomatis.
Otomatis menghapus reservasi yang dibuat otomatis setelah 864.000 detik (10 hari).
Tentukan awalan nama baru.
Untuk mengubah fr-04
, buat permintaan PATCH
berikut:
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-04?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CnamePrefix
{
"autoDeleteAutoCreatedReservations": "true",
"autoCreatedReservationsDuration": {
"seconds": "864000"
},
"name": "fr-04",
"namePrefix": "new-prefix"
}
Permintaan untuk mengubah pemesanan di masa mendatang yang disetujui atau diperoleh.
Anda dapat meminta Google Cloud untuk mengubah reservasi mendatang dengan status pengadaan yang ditetapkan ke Disetujui (APPROVED
) atau Pengadaan (PROCURING
) sebagai berikut:
Jika Anda meminta untuk mengubah reservasi mendatang yang disetujui, Google Cloud akan melakukan salah satu tindakan berikut:
Menyetujui permintaan dan menetapkan status pengadaan ke Disetujui (
APPROVED
). Jika waktu mulai periode reservasi berada dalam waktu 56 hari (8 minggu), Compute Engine akan menetapkan status pengadaan ke Pengadaan (PROCURING
) dalam beberapa menit.Menolak permintaan dan menetapkan status pengadaan ke Ditolak (
DECLINED
). Jika Anda ingin mengubah reservasi mendatang lagi, lihat Mengubah draf atau reservasi mendatang yang ditolak di dokumen ini.
Jika Anda meminta untuk mengubah reservasi pengadaan mendatang, Compute Engine akan membuat status update pada reservasi mendatang, dan menyetelnya ke Update tertunda persetujuan (
AMENDMENT_PENDING_APPROVAL
). Kemudian, Google Cloud akan meninjau permintaan Anda dan melakukan salah satu hal berikut:Menyetujui permintaan dan menetapkan status update ke Update disetujui (
AMENDMENT_APPROVED
).Menolak permintaan, menetapkan status update ke Update ditolak (
AMENDMENT_DECLINED
), dan terus menggunakan properti yang telah disetujui sebelumnya untuk reservasi yang dibuat otomatis.
Selama Google Cloud meninjau permintaan Anda untuk mengubah pemesanan untuk masa mendatang yang diperoleh, Anda tidak dapat mengubah properti apa pun—termasuk properti yang biasanya dapat Anda ubah tanpa persetujuan—hingga Google Cloud menyetujui atau menolak permintaan Anda.
Untuk meminta Google Cloud mengubah properti pemesanan untuk masa mendatang yang disetujui atau diperoleh, pilih salah satu metode berikut:
-
Bagian ini menjelaskan cara meminta Google Cloud untuk mengubah satu atau beberapa properti dalam pemesanan untuk masa mendatang yang disetujui dan dikirim, yang dibuat dengan menentukan template instance. Anda tidak dapat mengganti template instance yang digunakan untuk membuat pemesanan untuk masa mendatang atau mengganti properti VM-nya.
-
Bagian ini menjelaskan cara meminta Google Cloud untuk mengubah satu atau beberapa properti dalam pemesanan untuk masa mendatang yang dikirim dan disetujui, yang dibuat dengan menentukan properti secara langsung.
Permintaan untuk mengubah pemesanan untuk masa mendatang yang dibuat dengan menentukan template instance.
Untuk reservasi di masa mendatang yang dibuat dengan menentukan template instance dengan status pengadaan Disetujui (APPROVED
) atau Pengadaan (PROCURING
), Anda dapat meminta untuk mengubah properti berikut:
Hapus otomatis
Deskripsi
Awalan nama
Setelan berbagi
Waktu mulai dan waktu berakhirnya periode pemesanan
Jumlah total (Jumlah VM)†
† Jika Anda meminta untuk menambah atau mengurangi jumlah total sebagian besar dalam waktu 14 hari sejak waktu mulai reservasi di masa mendatang, Google Cloud kemungkinan akan menolak permintaan Anda.
Anda dapat meminta Google Cloud untuk mengubah reservasi mendatang yang dibuat dengan menentukan template instance menggunakan gcloud CLI dan REST.
Konsol
Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menentukan template instance, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Pemesanan.
Klik tab Pemesanan untuk masa mendatang.
Di kolom Name, klik nama pemesanan untuk masa mendatang yang ingin Anda ubah.
Halaman detail pemesanan untuk masa mendatang yang dipilih akan terbuka.
Jika Anda ingin mengubah opsi hapus otomatis dan deskripsi pemesanan untuk masa mendatang, lakukan satu atau beberapa hal berikut:
Di baris waktu dihapus secara otomatis pemesanan yang dibuat otomatis , klik
Edit, lalu ikuti langkah-langkah berikut:Lakukan salah satu hal berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang, pilih salah satu metode berikut:
Klik tombol Aktifkan hapus otomatis ke posisi aktif.
Opsional: Di kolom Waktu dihapus otomatis, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.
Jika tidak, klik tombol Aktifkan hapus otomatis ke posisi nonaktif.
Klik Submit.
Di baris Awalan, klik
Edit, lalu lakukan hal berikut:Di kolom Awalan, masukkan awalan nama baru.
Klik Submit.
Di baris Deskripsi, klik
Edit, lalu lakukan hal berikut:Di kolom Deskripsi, masukkan deskripsi baru.
Klik Submit.
Klik
Edit.Halaman untuk mengedit pemesanan untuk masa mendatang yang dipilih akan terbuka.
Jika Anda ingin mengubah properti lain, lakukan satu atau beberapa hal berikut:
Ubah Waktu mulai atau Waktu berakhir untuk pemesanan untuk masa mendatang Anda. Pastikan hal berikut:
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau.
Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.
Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.
Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.
Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.
DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.
Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Untuk mengirimkan permintaan perubahan ke Google Cloud untuk ditinjau, klik Kirim.
Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.
gcloud
Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menentukan template instance, gunakan perintah gcloud beta compute future-reservations update
.
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
--description="DESCRIPTION" \
--name-prefix=NAME_PREFIX \
--planning-status=PLANNING_STATUS \
--project=PROJECT_ID \
--share-setting=SHARE_SETTING \
--share-with=CONSUMER_PROJECT_IDS \
--start-time=START_TIME \
--end-time=END_TIME \
--total-count=TOTAL_COUNT \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama pemesanan untuk masa mendatang. yang sudah disetujui atau diperoleh.
DESCRIPTION
: Opsional. Deskripsi baru untuk pemesanan untuk masa mendatang.
NAME_PREFIX
: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.
PROJECT_ID
: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk pemesanan untuk masa mendatang. Jika Anda menghapus flag--project
, nilainya akan ditetapkan ke ID project saat ini.
SHARE_SETTING
: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan
projects
. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda--share-with
. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.Jika tidak, tentukan
local
.
CONSUMER_PROJECT_IDS
: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukanproject-1,project-2
. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.START_TIME
: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.
END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda--end-time
dengan tanda--duration=END_DURATION
, denganEND_DURATION
adalah durasi periode reservasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Perhatian: Jika Anda ingin meningkatkan jumlah VM yang akan dipesan, pastikan Anda memiliki kuota yang cukup untuk resource tambahan yang diminta dipesan. Jika tidak, Google Cloud akan menolak permintaan perubahan Anda.
ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.
Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:
Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Ganti
AUTO_CREATED_RESERVATIONS_DELETE_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Ganti
DURATION_BEFORE_DELETE
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, 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, tentukan flag
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05
dan berada di zona us-central1-a
. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:
Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.
Pesan 10 VM.
Tentukan awalan nama baru.
Untuk meminta Google Cloud mengubah fr-05
, jalankan perintah berikut:
gcloud beta compute future-reservations update fr-05 \
--end-time=2024-12-31T00:00:00Z \
--name-prefix=new-prefix \
--planning-status=SUBMITTED \
--project=example-project \
--total-count=10 \
--zone=us-central1-a
REST
Untuk
meminta Google Cloud
mengubah
pemesanan untuk masa mendatang
yang disetujui atau diperoleh
yang dibuat dengan menentukan
template instance,
buat permintaan PATCH
ke
metode beta.futureReservations.update
.
Di parameter kueri updateMask
, tentukan setiap kolom yang ingin diperbarui.
Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask
dan hapus kolom tersebut dari isi permintaan.
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS
{
"autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
"description": "DESCRIPTION",
"name": "FUTURE_RESERVATION_NAME",
"namePrefix": "NAME_PREFIX",
"planningStatus": "PLANNING_STATUS",
"shareSettings": {
"projects": [
"CONSUMER_PROJECT_ID_1",
"CONSUMER_PROJECT_ID_2"
],
"shareType": "SHARE_TYPE"
},
"specificSkuProperties": {
"totalCount": "TOTAL_COUNT"
},
"timeWindow": {
"endTime": "END_TIME",
"startTime": "START_TIME"
}
}
Ganti kode berikut:
PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.FUTURE_RESERVATION_NAME
: nama pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh. Anda tidak dapat mengubah nama reservasi di masa mendatang.UPDATE_FIELDS
: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaanPATCH
ini. Anda harus mengenkode setiap koma sebagai%2C
. Misalnya, jika Anda ingin memperbarui kolomautoDeleteAutoCreatedReservations
,totalCount
, danendTime
di reservasi mendatang, tentukan hal berikut:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opsional. Jika Anda menetapkan kolom ini ketrue
, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Ganti
DELETE_TIME
dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Mengganti
DURATION_BEFORE_DELETE
dengan durasi dalam detik. Misalnya, tentukan604800
untuk 604.800 detik (7 hari).
DESCRIPTION
: Opsional. Untuk memperbarui deskripsi bagi reservasi mendatang, lakukan salah satu hal berikut:Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.
Untuk menghapus deskripsi, hapus kolom
description
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
NAME_PREFIX
: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.SHARE_TYPE
: Opsional. Untuk mengubah jenis berbagi reservasi mendatang, tentukan salah satu nilai berikut:Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan
SPECIFIC_PROJECTS
. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolomprojects
. Jika tidak, modifikasi reservasi mendatang akan gagal.Jika tidak, tentukan
LOCAL
. Selain itu, Anda harus menghapus kolomprojects
dari isi permintaan dan menentukannya dalamUPDATE_FIELDS
. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.
CONSUMER_PROJECT_ID_1
danCONSUMER_PROJECT_ID_2
: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
START_TIME
: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolomendTime
dengan kolomduration
untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:"duration": { "seconds": "END_DURATION" }
Ganti
END_DURATION
dengan durasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05
dan berada di zona us-central1-a
. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:
Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.
Pesan 10 VM.
Tentukan awalan nama baru.
Untuk meminta Google Cloud mengubah fr-05
, buat permintaan PATCH
berikut:
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
{
"name": "fr-05",
"namePrefix": "new-prefix",
"planningStatus": "SUBMITTED",
"specificSkuProperties": {
"totalCount": "10"
},
"timeWindow": {
"endTime": "2023-12-31T00:00:00Z"
}
}
Setelah mengirimkan permintaan untuk mengubah reservasi mendatang ke Google Cloud, Anda dapat memantau status permintaan tersebut dengan melihat detail reservasi mendatang.
Permintaan untuk mengubah pemesanan untuk masa mendatang yang dibuat dengan menentukan properti secara langsung
Untuk reservasi di masa mendatang yang dibuat dengan menentukan properti secara langsung dengan status pengadaan Disetujui (APPROVED
) atau Pengadaan (Procuring
), Anda dapat
meminta untuk mengubah properti berikut:
Hapus otomatis
Deskripsi
Awalan nama
GPU‡
SSD lokal dan jenis antarmuka disk‡
Seri mesin dan jenis mesin‡
Platform CPU minimum‡
Setelan berbagi
Waktu mulai dan waktu berakhirnya periode pemesanan
Jumlah total (Jumlah VM)‡
‡ Jika Anda meminta untuk mengubah properti VM, atau menambah atau mengurangi jumlah total sebagian besar, dalam waktu 14 hari sejak waktu mulai reservasi di masa mendatang, Google Cloud kemungkinan akan menolak permintaan Anda.
Anda dapat meminta Google Cloud untuk mengubah reservasi mendatang yang dibuat dengan menentukan properti secara langsung menggunakan Konsol Google Cloud, gcloud CLI, dan REST.
Konsol
Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang yang disetujui atau diperoleh yang dibuat dengan menetapkan properti secara langsung, ikuti langkah-langkah berikut:
Di Konsol Google Cloud, buka halaman Pemesanan.
Klik tab Pemesanan untuk masa mendatang.
Di kolom Name, klik nama pemesanan untuk masa mendatang yang ingin Anda ubah.
Halaman detail pemesanan untuk masa mendatang yang dipilih akan terbuka.
Jika Anda ingin mengubah opsi hapus otomatis dan deskripsi pemesanan untuk masa mendatang, lakukan satu atau beberapa hal berikut:
Di baris waktu dihapus secara otomatis pemesanan yang dibuat otomatis , klik
Edit, lalu ikuti langkah-langkah berikut:Lakukan salah satu hal berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang, pilih salah satu metode berikut:
Klik tombol Aktifkan hapus otomatis ke posisi aktif.
Opsional: Di kolom Waktu dihapus otomatis, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.
Jika tidak, klik tombol Aktifkan hapus otomatis ke posisi nonaktif.
Klik Submit.
Di baris Awalan, klik
Edit, lalu lakukan hal berikut:Di kolom Awalan, masukkan awalan nama baru.
Klik Submit.
Di baris Deskripsi, klik
Edit, lalu lakukan hal berikut:Di kolom Deskripsi, masukkan deskripsi baru.
Klik Submit.
Klik
Edit.Halaman untuk mengedit pemesanan untuk masa mendatang yang dipilih akan terbuka.
Jika Anda ingin mengubah properti lain, lakukan satu atau beberapa hal berikut:
Ubah Waktu mulai atau Waktu berakhir untuk pemesanan untuk masa mendatang Anda. Pastikan hal berikut:
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau.
Tentukan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.
Tentukan periode pemesanan minimum yang direkomendasikan untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan Anda setelah mengirimkannya untuk ditinjau.
Di bagian Jenis berbagi, Anda dapat memilih Lokal atau Dibagikan. Jika memilih Dibagikan, Anda dapat menambahkan atau menghapus project untuk membagikan pemesanan untuk masa mendatang.
Anda dapat memilih hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.
DiJumlah instance VM masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.
Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika ada pemesanan yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang Compute Engine{101 } buat. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Di bagian Konfigurasi mesin, Anda dapat mengubah hal berikut:
Seri mesin dan jenis mesin yang digunakan di VM yang dipesan.
GPU yang akan dipasang ke VM yang dipesan.
SSD Lokal dan jenis antarmuka disk VM yang dipesan.
Untuk mengirimkan permintaan perubahan ke Google Cloud untuk ditinjau, klik Kirim.
Jika Anda mengirimkan permintaan, halaman Pemesanan akan terbuka. Jika tidak, halaman detail permintaan pemesanan untuk masa mendatang akan terbuka.
gcloud
Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang
yang disetujui atau diperoleh yang dibuat dengan menentukan properti secara langsung, gunakan perintah
gcloud beta compute future-reservations update
.
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
--accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
--description="DESCRIPTION" \
--local-ssd=size=375,interface=INTERFACE_1 \
--local-ssd=size=375,interface=INTERFACE_2 \
--machine-type=MACHINE_TYPE \
--min-cpu-platform=MIN_CPU_PLATFORM \
--name-prefix=NAME_PREFIX \
--planning-status=PLANNING_STATUS \
--project=PROJECT_ID \
--share-setting=SHARE_SETTING \
--share-with=CONSUMER_PROJECT_IDS \
--start-time=START_TIME \
--end-time=END_TIME \
--total-count=TOTAL_COUNT \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh.
Opsional. Lakukan salah satu hal berikut:
Untuk menambahkan unit pemrosesan grafis (GPU) ke setiap VM yang dipesan, tentukan hal berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: jenis GPU yang akan ditambahkan ke VM yang dipesan.
Pastikan jenis mesin yang Anda tentukan pada reservasi mendatang mendukung jenis GPU yang Anda tentukan dan GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.
Untuk menghapus semua GPU dari permintaan pemesanan untuk masa mendatang ini, ganti flag
--accelerator
dengan flag--clear-accelerator
.
DESCRIPTION
: Opsional. Deskripsi baru untuk pemesanan untuk masa mendatang.
Opsional. Lakukan salah satu hal berikut:
Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti
INTERFACE_1
danINTERFACE_2
. Nilainya harus berupa salah satu dari berikut:Jika boot disk image telah mengoptimalkan driver NVMe, tentukan
nvme
.Jika tidak, tentukan
scsi
.
Ukuran setiap SSD lokal adalah 375 GB. Ulangi flag
--local-ssd
untuk setiap SSD lokal yang ingin Anda tambahkan. Anda dapat menentukan maksimum 24 SSD lokal.Untuk menghapus semua SSD lokal dari permintaan pemesanan untuk masa mendatang ini, hapus semua flag
--local-ssd
dan tentukan flag--clear-local-ssd
.
MACHINE_TYPE
: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.MINIMUM_CPU_PLATFORM
: Opsional. Platform CPU minimum yang akan digunakan untuk setiap VM. Jika Anda menghapus flag--min-cpu-platform
, nilainya akan ditetapkan ke platform CPU default zona.
NAME_PREFIX
: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.
PROJECT_ID
: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang dibuat. Jika Anda mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, project ini akan menjadi project pemilik untuk pemesanan untuk masa mendatang. Jika Anda menghapus flag--project
, nilainya akan ditetapkan ke ID project saat ini.
SHARE_SETTING
: Opsional. Untuk mengubah jenis permintaan pemesanan untuk masa mendatang ini, tentukan salah satu nilai berikut:Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan
projects
. Pastikan untuk menentukan setidaknya satu project konsumen menggunakan tanda--share-with
. Jika tidak, perubahan permintaan pemesanan untuk masa mendatang akan gagal.Jika tidak, tentukan
local
.
CONSUMER_PROJECT_IDS
: Opsional. Daftar yang dipisahkan koma untuk project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang ini. Misalnya, tentukanproject-1,project-2
. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.START_TIME
: Opsional. Waktu mulai baru periode reservasi yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak saat Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah pemesanan untuk masa mendatang setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menentukan waktu mulai yang direkomendasikan.
END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti tanda--end-time
dengan tanda--duration=END_DURATION
, denganEND_DURATION
adalah durasi periode reservasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Perhatian: Jika Anda ingin meningkatkan jumlah VM yang akan dipesan, pastikan Anda memiliki kuota yang cukup untuk resource tambahan yang diminta dipesan. Jika tidak, Google Cloud akan menolak permintaan perubahan Anda.
ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.
Secara opsional, Anda juga dapat mengubah kapan saja Compute Engine menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang dengan melakukan salah satu tindakan berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat otomatis setelah waktu berakhir periode pemesanan, pilih salah satu metode berikut:
Untuk menghapus pemesanan dalam waktu 2 jam setelah waktu berakhir (default), tentukan flag
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations
Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME
Ganti
AUTO_CREATED_RESERVATIONS_DELETE_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, tentukan flag
--auto-delete-auto-created-reservations
dan--auto-created-reservations-duration
.gcloud beta compute future-reservations update example-future-reservation \ --auto-delete-auto-created-reservations \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE
Ganti
DURATION_BEFORE_DELETE
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, 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, tentukan flag
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update example-future-reservation \ --no-auto-delete-auto-created-reservations
Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05
dan berada di zona us-central1-a
. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:
Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.
Pesan 10 VM.
Tentukan awalan nama baru.
Untuk meminta Google Cloud mengubah fr-05
, jalankan perintah berikut:
gcloud beta compute future-reservations update fr-05 \
--end-time=2024-12-31T00:00:00Z \
--name-prefix=new-prefix \
--planning-status=SUBMITTED \
--project=example-project \
--total-count=10 \
--zone=us-central1-a
REST
Untuk meminta Google Cloud mengubah pemesanan untuk masa mendatang
yang disetujui atau diperoleh yang dibuat dengan menentukan properti secara langsung, buat permintaan PATCH
ke metode
beta.futureReservations.update
.
Di parameter kueri updateMask
, tentukan setiap kolom yang ingin diperbarui.
Jika Anda perlu menghapus kolom opsional dari reservasi, sertakan kolom tersebut dalam parameter kueri updateMask
dan hapus kolom tersebut dari isi permintaan.
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS
{
"autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
"description": "DESCRIPTION",
"name": "FUTURE_RESERVATION_NAME",
"namePrefix": "NAME_PREFIX",
"planningStatus": "PLANNING_STATUS",
"shareSettings": {
"projects": [
"CONSUMER_PROJECT_ID_1",
"CONSUMER_PROJECT_ID_2"
],
"shareType": "SHARE_TYPE"
},
"specificSkuProperties": {
"instanceProperties": {
"guestAccelerators": [
{
"acceleratorCount": NUMBER_OF_ACCELERATORS,
"acceleratorType": "ACCELERATOR_TYPE"
}
],
"localSsds": [
{
"diskSizeGb": "375",
"interface": "INTERFACE_1"
},
{
"diskSizeGb": "375",
"interface": "INTERFACE_2"
}
],
"machineType": "MACHINE_TYPE",
"minCpuPlatform": "MINIMUM_CPU_PLATFORM"
},
"totalCount": "TOTAL_COUNT"
},
"timeWindow": {
"endTime": "END_TIME",
"startTime": "START_TIME"
}
}
Ganti kode berikut:
PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.FUTURE_RESERVATION_NAME
: nama pemesanan untuk masa mendatang yang sudah disetujui atau diperoleh. Anda tidak dapat mengubah nama reservasi di masa mendatang.UPDATE_FIELDS
: daftar kolom yang dipisahkan koma untuk diperbarui dalam permintaanPATCH
ini. Anda harus mengenkode setiap koma sebagai%2C
. Misalnya, jika Anda ingin memperbarui kolomautoDeleteAutoCreatedReservations
,totalCount
, danendTime
di reservasi mendatang, tentukan hal berikut:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: Opsional. Jika Anda menetapkan kolom ini ketrue
, Compute Engine akan otomatis menghapus reservasi yang dibuat otomatis untuk reservasi reservasi mendatang ini. Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu hal berikut:Untuk menghapus pemesanan yang dibuat otomatis pada waktu tertentu setelah waktu berakhir periode pemesanan, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME" }
Ganti
DELETE_TIME
dengan tanggal dan waktu saat Compute Engine menghapus pemesanan. Tanggal dan waktu harus diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: data dengan format tahun 4 digit, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-
).HH:MM:SS
: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
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/example-project/zones/us-central1-a/futureReservations/example-future-reservation?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" } }
Mengganti
DURATION_BEFORE_DELETE
dengan durasi dalam detik. Misalnya, tentukan604800
untuk 604.800 detik (7 hari).
DESCRIPTION
: Opsional. Untuk memperbarui deskripsi bagi reservasi mendatang, lakukan salah satu hal berikut:Untuk menambahkan atau memperbarui deskripsi, tentukan deskripsi.
Untuk menghapus deskripsi, hapus kolom
description
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
NAME_PREFIX
: Opsional. Awalan nama baru untuk pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang ini, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: status perencanaan permintaan pemesanan untuk masa mendatang. Anda hanya dapat menentukanSUBMITTED
, yang akan mengirimkan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau.SHARE_TYPE
: Opsional. Untuk mengubah jenis berbagi reservasi mendatang, tentukan salah satu nilai berikut:Untuk mengubah pemesanan untuk masa mendatang satu project menjadi pemesanan untuk masa mendatang bersama, tentukan
SPECIFIC_PROJECTS
. Selain itu, Anda harus menentukan setidaknya satu project konsumen di kolomprojects
. Jika tidak, modifikasi reservasi mendatang akan gagal.Jika tidak, tentukan
LOCAL
. Selain itu, Anda harus menghapus kolomprojects
dari isi permintaan dan menentukannya dalamUPDATE_FIELDS
. Jika tidak, mengubah pemesanan untuk masa mendatang akan gagal.
CONSUMER_PROJECT_ID_1
danCONSUMER_PROJECT_ID_2
: Opsional. Project ID dari project yang dapat menggunakan secara bersama permintaan pemesanan untuk masa mendatang. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, pengguna sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis bersama untuk pemesanan untuk masa mendatang ini.
Opsional. Untuk mengupdate unit pemrosesan grafis (GPU) yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:
Untuk menambahkan atau mengubah GPU, tentukan hal berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: jenis GPU yang akan ditambahkan ke VM yang dipesan.
Pastikan jenis mesin yang Anda tentukan pada reservasi mendatang mendukung jenis GPU yang Anda tentukan dan GPU tersedia di zona tempat Anda ingin mencadangkan resource. Jika tidak, Anda akan mengalami error.
Untuk menghapus semua GPU dari permintaan mendatang ini, hapus kolom
guestAccelerators
dalam isi permintaan dan tentukan diUPDATE_FIELDS
.
Opsional. Untuk mengupdate SSD lokal yang terpasang ke setiap VM yang dicadangkan, lakukan salah satu hal berikut:
Untuk menambahkan atau mengedit jenis antarmuka yang Anda ingin digunakan SSD lokal untuk setiap VM, ganti
INTERFACE_1
danINTERFACE_2
. Nilainya harus berupa salah satu dari berikut:Jika boot disk image telah mengoptimalkan driver NVMe, tentukan
NVME
.Jika tidak, tentukan
SCSI
.
Ulangi kolom
diskSizeGb
daninterface
untuk setiap SSD lokal yang ingin ditambahkan atau diperbarui. Anda dapat menentukan maksimum 24 SSD lokal.Untuk menghapus semua SSD lokal dari reservasi di masa mendatang, hapus kolom
localSsds
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
MACHINE_TYPE
: Opsional. Jenis mesin standar atau kustom yang akan digunakan untuk setiap VM. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.MINIMUM_CPU_PLATFORM
: Opsional. Untuk mengupdate platform CPU minimum yang akan digunakan untuk setiap VM, lakukan salah satu hal berikut:Untuk menambahkan atau mengupdate platform CPU minimum, tentukan platform CPU minimum.
Untuk kembali ke platform CPU default zona, hapus kolom
minCpuPlatform
dari isi permintaan dan tentukan diUPDATE_FIELDS
.
TOTAL_COUNT
: Opsional. Jumlah total VM baru yang ingin Anda pesan untuk periode ini, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.Saat menghitung jumlah pemesanan yang akan dibuat untuk pemesanan untuk masa mendatang yang disetujui, Compute Engine akan memeriksa pemesanan yang ada terlebih dahulu. Jika terdapat pemesanan lama yang cocok dengan pemesanan untuk masa mendatang yang disetujui, jumlah pemesanan yang ada akan dikurangi dari total jumlah pemesanan yang diminta dalam permintaan untuk menentukan jumlah pemesanan baru yang dibuat Compute Engine. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
START_TIME
: Opsional. Waktu mulai baru periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu sejak Anda mengirimkan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menentukan waktu mulai yang direkomendasikan untuk memastikan Anda memiliki waktu yang cukup sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.END_TIME
: Opsional. Waktu berakhir baru dari periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Periode pemesanan harus berlangsung setidaknya 24 jam. Atau, Anda dapat mengganti kolomendTime
dengan kolomduration
untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:"duration": { "seconds": "END_DURATION" }
Ganti
END_DURATION
dengan durasi dalam detik. Misalnya, tentukan1209600
untuk 1.209.600 detik (14 hari).Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.
Misalnya, pertimbangkan pemesanan untuk masa mendatang yang disetujui bernama fr-05
dan berada di zona us-central1-a
. Misalkan Anda ingin meminta Google Cloud untuk mengubah permintaan pemesanan untuk masa mendatang ini dengan melakukan perubahan berikut:
Ubah waktu berakhir periode pemesanannya menjadi tengah malam pada 31 Desember 2023 UTC.
Pesan 10 VM.
Tentukan awalan nama baru.
Untuk meminta Google Cloud mengubah fr-05
, buat permintaan PATCH
berikut:
PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-05?updateMask=namePrefix%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
{
"name": "fr-05",
"namePrefix": "new-prefix",
"planningStatus": "SUBMITTED",
"specificSkuProperties": {
"totalCount": "10"
},
"timeWindow": {
"endTime": "2023-12-31T00:00:00Z"
}
}
Setelah mengirimkan permintaan untuk mengubah reservasi mendatang ke Google Cloud, Anda dapat memantau status permintaan tersebut dengan melihat detail reservasi mendatang.
Mengubah properti lainnya dalam permintaan reservasi untuk masa mendatang
Jika Anda ingin mengubah properti lain dalam permintaan reservasi mendatang
sebelum mencapai status pengadaan Pengadaan (PROCURING
), ikuti
langkah-langkah berikut:
Lakukan satu atau beberapa hal berikut:
Agar Google Cloud tidak meninjau permintaan pemesanan untuk masa mendatang, batalkan permintaan pemesanan untuk masa mendatang.
Untuk menghentikan permintaan pemesanan untuk masa mendatang agar tidak membatasi jenis permintaan pemesanan untuk masa mendatang yang dapat Anda buat di project saat ini—atau dalam project yang permintaan pemesanan untuk masa mendatang ini digunakan bersama —hapus permintaan pemesanan untuk masa mendatang.
Buat single-project baru atau permintaan pemesanan untuk masa mendatang yang baru dengan update yang Anda inginkan.
Memecahkan masalah
Jika Anda mengalami error saat mengubah permintaan pemesanan untuk masa mendatang, lihat cara memecahkan masalah permintaan pemesanan untuk masa mendatang.
Jika Anda masih mengalami masalah setelah memecahkan masalah, hubungi perwakilan akun Anda atau Dukungan Google Cloud.
Membatalkan permintaan pemesanan untuk masa mendatang
Anda dapat membatalkan permintaan pemesanan untuk masa mendatang yang disetujui, ditolak, atau menunggu persetujuan untuk menghentikan Google Cloud menyediakan kapasitas yang diminta. Setelah membatalkan permintaan pemesanan untuk masa mendatang, Anda hanya dapat melihat detailnya atau menghapusnya.
Anda dapat membatalkan permintaan reservasi pada masa mendatang menggunakan gcloud CLI dan REST.
gcloud
Untuk membatalkan permintaan pemesanan untuk masa mendatang, gunakan perintah gcloud beta compute future-reservations cancel
.
gcloud beta compute future-reservations cancel FUTURE_RESERVATION_NAME \
--project=PROJECT_ID \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang ada.PROJECT_ID
: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang berada. Jika Anda menghilangkan flag--project
, ID project saat ini akan digunakan.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.
REST
Untuk membatalkan permintaan pemesanan untuk masa mendatang, buat permintaan POST
ke
metode beta.futureReservations.cancel
.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME/cancel
Ganti kode berikut:
PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang.FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang ada.
Membatalkan permintaan pemesanan untuk masa mendatang
Anda dapat menghapus permintaan pemesanan untuk masa mendatang hanya dalam salah satu kasus berikut:
Permintaan pemesanan untuk masa mendatang dibatalkan.
Sebelum pemesanan untuk masa mendatang mencapai waktu mulai periode reservasinya.
Setelah pemesanan untuk masa mendatang mencapai waktu berakhir periode pemesanannya.
Menghapus pemesanan untuk masa mendatang tidak akan menghapus pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang. Jika Anda ingin menghapus pemesanan yang dibuat otomatis setelah akhir periode pemesanan, lihat Menghapus pemesanan.
Anda dapat menghapus permintaan reservasi pada masa mendatang menggunakan Konsol Google Cloud, gcloud CLI, dan REST.
Konsol
Untuk menghapus permintaan pemesanan untuk masa mendatang, ikuti langkah-langkah berikut:
Di Konsol Google Cloud, buka halaman Reservations.
Klik tab Pemesanan untuk masa mendatang.
Pilih kotak centang di samping setiap permintaan pemesanan untuk masa mendatang yang ingin Anda hapus.
Klik
Hapus pemesanan.Untuk mengonfirmasi, klik Hapus.
Proses penghapusan permintaan pemesanan untuk masa mendatang dapat memerlukan waktu hingga satu menit.
gcloud
Untuk menghapus permintaan pemesanan untuk masa mendatang, gunakan perintah gcloud beta compute future-reservations delete
.
gcloud beta compute future-reservations delete FUTURE_RESERVATION_NAME \
--project=PROJECT_ID \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang ada.PROJECT_ID
: Opsional. ID project tempat permintaan pemesanan untuk masa mendatang berada. Jika Anda menghilangkan flag--project
, ID project saat ini akan digunakan.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.
REST
Untuk menghapus permintaan pemesanan untuk masa mendatang, buat permintaan DELETE
ke
metode beta.futureReservations.delete
.
DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
Ganti kode berikut:
PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang.FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang ada.
Langkah selanjutnya
Pelajari cara melihat permintaan pemesanan untuk masa mendatang.
Setelah mencapai waktu mulai periode pemesanan, pelajari cara menggunakan pemesanan yang dibuat otomatis.
Setelah periode pemesanan Anda berakhir, pelajari cara melakukan hal berikut: