Dokumen ini menjelaskan cara membuat permintaan pemesanan untuk masa mendatang bagi project tunggal.
Jika Google Cloud menyetujui permintaan pemesanan untuk masa mendatang bagi project tunggal, pada waktu mulai yang ditetapkan dalam permintaan Anda, Compute Engine akan otomatis membuat pemesanan yang hanya dapat digunakan oleh instance virtual machine (VM) yang dibuat dalam project yang sama.
Sebelum memulai
- Jika Anda belum melakukannya, tinjau cara kerja pemesanan untuk masa mendatang.
-
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 guna membuat permintaan reservasi mendatang untuk project tunggal,
minta administrator untuk memberi Anda peran IAM
Compute Future Reservasi User (roles/compute.futureReservationUser
) di project.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.
Peran yang telah ditentukan ini berisi izin yang diperlukan untuk membuat permintaan pemesanan untuk masa mendatang bagi project tunggal. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat permintaan pemesanan untuk masa mendatang bagi project tunggal:
-
Untuk membuat permintaan reservasi mendatang:
compute.futureReservations.create
di project -
Agar Compute Engine dapat otomatis membuat pemesanan:
compute.reservations.create
di project -
Untuk menentukan template instance:
compute.instanceTemplates.useReadOnly
pada template instance
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran yang telah ditetapkan sebelumnya.
Membuat permintaan pemesanan untuk masa mendatang bagi project tunggal
Bagian ini menjelaskan cara membuat permintaan pemesanan untuk masa mendatang bagi project tunggal.
Agar dapat menggunakan pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang, VM harus memiliki properti yang sama persis dengan pemesanan tersebut. Untuk menentukan properti VM yang ingin Anda minta untuk dicadangkan dengan membuat permintaan pemesanan untuk masa mendatang, pilih salah satu metode berikut:
Direkomendasikan: Menentukan template instance
Bagian ini menjelaskan cara menggunakan template instance yang ada untuk menentukan properti permintaan pemesanan untuk masa mendatang. Dengan menggunakan template instance, Anda dapat menentukan properti pemesanan untuk masa mendatang dan VM yang dapat menggunakan pemesanan yang dibuat secara otomatis di tempat yang sama.
Menentukan properti secara langsung
Bagian ini menjelaskan cara menentukan properti secara langsung untuk permintaan pemesanan untuk masa mendatang. Metode ini mengharuskan Anda memastikan secara manual bahwa properti VM Anda dan pemesanan yang dibuat secara otomatis sama persis—properti yang tidak cocok akan mencegah penggunaan.
Pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang dapat otomatis digunakan oleh setiap VM yang memiliki properti yang cocok. Jika Anda tidak ingin VM menggunakan salah satu pemesanan yang dibuat secara otomatis, lihat cara membuat VM tanpa menggunakan pemesanan.
Menentukan template instance
Anda dapat membuat pemesanan project tunggal mendatang dengan menentukan template instance yang ada menggunakan Google Cloud Console, gcloud CLI, dan REST.
Konsol
Untuk membuat permintaan pemesanan untuk masa mendatang bagi project tunggal dengan menentukan template instance, ikuti langkah-langkah berikut:
Di Konsol Google Cloud, buka halaman Pemesanan.
Klik tab Future reservations.
Klik
Create future reservation.Halaman Create a future reservation akan terbuka.
Di kolom Name, masukkan nama untuk permintaan pemesanan untuk masa mendatang.
Di kolom Prefix, masukkan awalan nama. Nama setiap pemesanan yang dibuat secara otomatis dari permintaan pemesanan untuk masa mendatang dimulai dengan awalan ini.
Guna membantu Anda mengidentifikasi pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, sebaiknya tentukan awalan nama yang unik.
Opsional: Di kolom Description, masukkan deskripsi untuk permintaan pemesanan untuk masa mendatang.
Di kolom Region, pilih region untuk memesan resource.
Di kolom Zone, pilih zona untuk memesan resource.
Di kolom Start time, masukkan waktu mulai untuk periode pemesanan. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau.
Pastikan untuk menetapkan nilai yang direkomendasikan untuk waktu mulai agar Anda memiliki cukup waktu sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.
Di kolom End time, masukkan waktu berakhir untuk periode pemesanan. Periode pemesanan harus berlangsung setidaknya 24 jam.
Di bagian Duration summary, Anda dapat melihat durasi periode pemesanan. Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menetapkan nilai yang direkomendasikan untuk periode pemesanan.
Di bagian Jenis berbagi, pilih Lokal (default).
Di kolom Jumlah 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 baru yang akan dibuat untuk permintaan pemesanan untuk masa mendatang yang disetujui tidak lama sebelum waktu mulai, Compute Engine akan mengurangi pemesanan yang ada dan cocok dengan permintaan dari total ini. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Di bagian Machine configuration, lakukan hal berikut:
Untuk menentukan properti VM Anda menggunakan instance template yang ada, pilih Use instance template.
Di kolom Instance template, pilih template instance pilihan Anda. Jika memilih template instance regional, Anda hanya dapat mencadangkan resource di dalam region tempat template instance berada.
Di bagian Auto-generated reservations auto-delete time, lakukan salah satu tindakan berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, lakukan langkah berikut:
Klik tombol Enable auto-delete ke posisi aktif (default).
Opsional: Di kolom Auto-delete time, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.
Jika tidak, klik tombol Enable auto-delete ke posisi nonaktif.
Lakukan salah satu hal berikut:
Untuk membuat permintaan pemesanan untuk masa mendatang dan mengirimkannya ke Google Cloud untuk ditinjau, klik Submit.
Untuk membuat draf permintaan pemesanan untuk masa mendatang, klik Save draft.
Untuk keluar tanpa menyimpan, klik Cancel.
Halaman Reservations akan terbuka. Pembuatan permintaan pemesanan untuk masa mendatang dapat memakan waktu hingga satu menit.
gcloud
Untuk membuat
permintaan pemesanan
untuk masa mendatang bagi project tunggal dengan menentukan
template instance, gunakan
perintah gcloud beta compute future-reservations create
dengan flag --source-instance-template
.
gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
--auto-delete-auto-created-reservations \
--description="DESCRIPTION" \
--name-prefix=NAME_PREFIX \
--planning-status=PLANNING_STATUS \
--project=PROJECT_ID \
--source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
--start-time=START_TIME \
--end-time=END_TIME \
--total-count=TOTAL_COUNT \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang akan dibuat.
DESCRIPTION
: Opsional. Deskripsi untuk permintaan pemesanan untuk masa mendatang.
NAME_PREFIX
: awalan nama untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, sebaiknya tentukan awalan nama yang unik.PLANNING_STATUS
: Opsional. Status perencanaan permintaan pemesanan untuk masa mendatang, yang harus berupa salah satu dari berikut:Untuk membuat draf permintaan pemesanan untuk masa mendatang, tentukan
DRAFT
.Untuk membuat permintaan pemesanan untuk masa mendatang dan mengirimkannya ke Google Cloud untuk disetujui, tentukan
SUBMITTED
.
Jika Anda menghapus flag
--planning-status
, nilainya akan ditetapkan keDRAFT
.PROJECT_ID
: ID project tempat Anda ingin mencadangkan resource dan lokasi template instance.
LOCATION
: lokasi template instance. Tentukan salah satu nilai berikut:Untuk template instance global:
global
.Untuk template instance regional:
regions/REGION
. GantiREGION
dengan region tempat template instance berada. Jika menentukan template instance regional, Anda hanya dapat mencadangkan VM di dalam region tempat template instance berada.
INSTANCE_TEMPLATE_NAME
: nama template instance yang ada. Jika menentukan template instance, Anda tidak dapat mengganti propertinya saat membuat permintaan reservasi mendatang. Jika tidak, Anda akan mengalami error.
START_TIME
: waktu mulai 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, jika tidak ingin menggunakan offset, tentukanZ
.
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah permintaan pemesanan untuk masa mendatang secara opsional setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menetapkan nilai yang direkomendasikan untuk waktu mulai.
END_TIME
: waktu berakhirnya 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
: 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 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.
ZONE
: zona untuk memesan resource.
Saat Anda menentukan flag --auto-delete-auto-created-reservations
,
Compute Engine akan otomatis menghapus pemesanan yang dibuat secara otomatis untuk
permintaan pemesanan untuk masa mendatang. Secara default, waktu penghapusan adalah dalam waktu 2 jam
setelah waktu berakhirnya periode pemesanan. Secara opsional, Anda dapat mengubahnya dengan
melakukan salah satu hal berikut:
Untuk menghapus pemesanan yang dibuat secara otomatis setelah waktu berakhirnya periode pemesanan, pilih salah satu metode berikut:
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 create 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 create 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
. Anda harus menonaktifkan opsi hapus otomatis jika ingin melampirkan reservasi yang dibuat otomatis ke abonemen.gcloud beta compute future-reservations create example-future-reservation \ --no-auto-delete-auto-created-reservations \ ...
Misalnya, perintah berikut akan membuat draf permintaan reservasi mendatang menggunakan template instance global example-template
untuk 80 VM.
Periode pemesanan dimulai pada tengah malam tanggal 10 November 2023 UTC, dan berakhir pada
tengah malam tanggal 10 Desember 2023 UTC.
Pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang dibuat di zona
us-central1-a
, memiliki nama yang diawali dengan fr-01-reservation
,
dan otomatis dihapus pada tengah malam tanggal 13 Desember 2023 UTC.
gcloud beta compute future-reservations create fr-01 \
--auto-delete-auto-created-reservations \
--auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
--name-prefix=fr-01-reservation \
--planning-status=DRAFT \
--project=example-project \
--source-instance-template=projects/example-project/global/instanceTemplates/example-template \
--start-time=2023-11-10T00:00:00Z \
--end-time=2023-12-10T00:00:00Z \
--total-count=80 \
--zone=us-central1-a
REST
Untuk membuat
permintaan pemesanan
untuk masa mendatang bagi project tunggal dengan menentukan
template instance,
buat permintaan POST
ke
metode beta.futureReservations.insert
.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
{
"autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
"description": "DESCRIPTION",
"name": "FUTURE_RESERVATION_NAME",
"namePrefix": "NAME_PREFIX",
"planningStatus": "PLANNING_STATUS",
"specificSkuProperties": {
"sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
"totalCount": "TOTAL_COUNT"
},
"timeWindow": {
"startTime": "START_TIME",
"endTime": "END_TIME"
}
}
Ganti kode berikut:
PROJECT_ID
: ID project tempat Anda ingin mencadangkan resource dan lokasi template instance.ZONE
: zona tempat Anda ingin mencadangkan resource.AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: jika Anda menetapkan kolom ini ketrue
, Compute Engine akan otomatis menghapus pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, terlepas dari apakah kolom tersebut telah digunakan sepenuhnya atau tidak. Tetapkan kolom ini kefalse
jika Anda ingin melampirkan reservasi yang dibuat otomatis ke abonemen.Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu langkah berikut:
Untuk menghapus reservasi yang dibuat otomatis setelah waktu tertentu setelah akhir periode reservasi, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME", ... }
Ganti
DELETE_TIME
dengan tanggal dan waktu saat Compute Engine menghapus pemesanan yang dibuat secara otomatis. 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 zona waktu Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan zona waktu Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, jika tidak ingin menggunakan offset, tentukanZ
.
Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDuration
.POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "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. Deskripsi untuk permintaan pemesanan untuk masa mendatang.FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang akan dibuat.NAME_PREFIX
: awalan nama untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: Opsional. Status perencanaan permintaan pemesanan untuk masa mendatang, yang harus berupa salah satu dari berikut:Untuk membuat draf permintaan pemesanan untuk masa mendatang, tentukan
DRAFT
.Untuk membuat permintaan pemesanan untuk masa mendatang dan mengirimkannya ke Google Cloud untuk disetujui, tentukan
SUBMITTED
.
Jika Anda menghapus kolom
planningStatus
, nilainya akan ditetapkan keDRAFT
.
LOCATION
: lokasi template instance. Tentukan salah satu nilai berikut:Untuk template instance global:
global
.Untuk template instance regional:
regions/REGION
. GantiREGION
dengan region tempat template instance berada. Jika menentukan template instance regional, Anda hanya dapat mencadangkan VM di dalam region tempat template instance berada.
INSTANCE_TEMPLATE_NAME
: nama template instance yang ada. Jika menentukan template instance, Anda tidak dapat mengganti propertinya saat membuat permintaan reservasi mendatang. Jika tidak, Anda akan mengalami error.
TOTAL_COUNT
: 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 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
: waktu mulai periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menetapkan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki cukup waktu sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.END_TIME
: waktu berakhirnya 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, perintah berikut akan membuat draf permintaan reservasi mendatang menggunakan template instance global example-template
untuk 80 VM.
Periode pemesanan dimulai pada tengah malam tanggal 10 November 2023 UTC, dan berakhir pada
tengah malam tanggal 10 Desember 2023 UTC.
Pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang dibuat di zona
us-central1-a
, memiliki nama yang diawali dengan fr-01-reservation
,
dan otomatis dihapus pada tengah malam tanggal 13 Desember 2023 UTC.
POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations
{
"autoDeleteAutoCreatedReservations": "true",
"autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
"name": "fr-01",
"namePrefix": "fr-01-reservation",
"specificSkuProperties": {
"sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-template",
"totalCount": "80"
},
"planningStatus": "DRAFT",
"timeWindow": {
"startTime": "2023-11-10T00:00:00Z",
"endTime": "2023-12-10T00:00:00Z"
}
}
Menentukan properti VM secara langsung
Anda dapat membuat pemesanan project tunggal mendatang dengan menentukan properti secara langsung menggunakan Google Cloud Console, gcloud CLI, dan REST.
Konsol
Untuk membuat permintaan pemesanan untuk masa mendatang bagi project tunggal dengan menentukan properti secara langsung, ikuti langkah-langkah berikut:
Di Konsol Google Cloud, buka halaman Pemesanan.
Klik tab Future reservations.
Klik
Create future reservation.Halaman Create a future reservation akan terbuka.
Di kolom Name, masukkan nama untuk permintaan pemesanan untuk masa mendatang.
Di kolom Prefix, masukkan awalan nama. Nama setiap pemesanan yang dibuat secara otomatis dari permintaan pemesanan untuk masa mendatang dimulai dengan awalan ini.
Guna membantu Anda mengidentifikasi pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, sebaiknya tentukan awalan nama yang unik.
Opsional: Di kolom Description, masukkan deskripsi untuk permintaan pemesanan untuk masa mendatang.
Di kolom Region, pilih region untuk memesan resource.
Di kolom Zone, pilih zona untuk memesan resource.
Di kolom Start time, masukkan waktu mulai untuk periode pemesanan. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau.
Pastikan untuk menetapkan nilai yang direkomendasikan untuk waktu mulai agar Anda memiliki cukup waktu sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.
Di kolom End time, masukkan waktu berakhir untuk periode pemesanan. Periode pemesanan harus berlangsung setidaknya 24 jam.
Di bagian Duration summary, Anda dapat melihat durasi periode pemesanan. Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, pastikan untuk menetapkan nilai yang direkomendasikan untuk periode pemesanan.
Di bagian Jenis berbagi, pilih Lokal (default).
Di kolom Jumlah 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 baru yang akan dibuat untuk permintaan pemesanan untuk masa mendatang yang disetujui tidak lama sebelum waktu mulai, Compute Engine akan mengurangi pemesanan yang ada dan cocok dengan permintaan dari total ini. Untuk mengetahui informasi selengkapnya, lihat cara Compute Engine menghitung dan menyediakan resource yang dipesan.
Di bagian Machine configuration, lakukan hal berikut:
Pilih Specify machine type (default).
Pilih salah satu opsi berikut:
Untuk workload umum, klik tab General destination (default).
Untuk workload yang membutuhkan performa intensif, klik tab Compute optimized.
Untuk workload rasio memori ke vCPU tinggi, klik tab Memory optimized.
Untuk workload yang menggunakan Unit pemrosesan grafis (GPU), klik tab GPUs.
Lakukan salah satu hal berikut:
Jika Anda menentukan General purpose, Compute optimized, atau Memory optimized di langkah sebelumnya, lakukan tindakan berikut:
Dalam daftar Series, pilih seri mesin.
Dalam daftar Machine type, pilih jenis mesin.
Opsional: Guna menyesuaikan mesin lebih lanjut untuk VM yang ingin Anda reservasi, luaskan Konfigurasi lanjutan dan ikuti petunjuknya.
Jika Anda menentukan GPU pada langkah sebelumnya, lakukan hal berikut:
Di menu GPU type, pilih salah satu jenis GPU.
Di menu Number of GPU, pilih jumlah GPU.
Opsional: Jika jenis GPU mengizinkannya dan Anda ingin menggunakan resource yang dicadangkan untuk menjalankan workload yang intensif grafis, pilih kotak centang Enable Virtual Workstation (NVIDIA GRID).
Dalam daftar Machine type, pilih jenis mesin.
Di daftar CPU platform, pilih platform CPU untuk VM yang ingin Anda pesan.
Opsional: Jika jenis mesin memungkinkan, dan Anda ingin menambahkan SSD lokal, lakukan langkah berikut:
Di kolom Number of disks, pilih jumlah disk untuk SSD lokal Anda.
Pada bagian Interface type, pilih salah satu antarmuka berikut:
SCSI (default)
NVMe
Di bagian Auto-generated reservations auto-delete time, lakukan salah satu tindakan berikut:
Agar Compute Engine dapat otomatis menghapus pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, lakukan langkah berikut:
Klik tombol Enable auto-delete ke posisi aktif (default).
Opsional: Di kolom Auto-delete time, masukkan tanggal dan waktu baru untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan.
Jika tidak, klik tombol Enable auto-delete ke posisi nonaktif.
Lakukan salah satu hal berikut:
Untuk membuat permintaan pemesanan untuk masa mendatang dan mengirimkannya ke Google Cloud untuk ditinjau, klik Submit.
Untuk membuat draf permintaan pemesanan untuk masa mendatang, klik Save draft.
Untuk keluar tanpa menyimpan, klik Cancel.
Halaman Reservations akan terbuka. Pembuatan permintaan pemesanan untuk masa mendatang dapat memakan waktu hingga satu menit.
gcloud
Untuk membuat
permintaan pemesanan
untuk masa mendatang bagi project tunggal dengan menentukan
properti secara langsung, gunakan
perintah gcloud beta compute future-reservations create
.
gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
--accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
--auto-delete-auto-created-reservations \
--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 \
--start-time=START_TIME \
--end-time=END_TIME \
--total-count=TOTAL_COUNT \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang akan dibuat.
Opsional: 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.
DESCRIPTION
: Opsional. Deskripsi untuk permintaan pemesanan untuk masa mendatang.
INTERFACE_1
danINTERFACE_2
: Opsional. Jenis antarmuka yang Anda inginkan di SSD lokal untuk digunakan setiap VM. 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.MACHINE_TYPE
: jenis mesin yang digunakan untuk setiap VM. Tentukan salah satu nilai berikut:Untuk jenis mesin yang telah ditetapkan:
MACHINE_FAMILY-standard-CPUS
.Untuk jenis mesin kustom:
MACHINE_FAMILY-custom-CPUS-MEMORY
. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.
Ganti kode berikut:
MACHINE_FAMILY
: kelompok mesin.CPUS
: jumlah vCPU.MEMORY
: total memori untuk VM yang dipesan. Memori harus kelipatan 256 MB dan harus disediakan dalam MB.
Misalnya, untuk menentukan jenis mesin kustom N2 dengan 4 vCPU dan memori 5 GB, yaitu 5.120 MB, tentukan
n2-custom-4-5120
.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
: awalan nama untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, sebaiknya tentukan awalan nama yang unik.PLANNING_STATUS
: Opsional. Status perencanaan permintaan pemesanan untuk masa mendatang, yang harus berupa salah satu dari berikut:Untuk membuat draf permintaan pemesanan untuk masa mendatang, tentukan
DRAFT
.Untuk membuat permintaan pemesanan untuk masa mendatang dan mengirimkannya ke Google Cloud untuk disetujui, tentukan
SUBMITTED
.
Jika Anda menghapus flag
--planning-status
, nilainya akan ditetapkan keDRAFT
.PROJECT_ID
: ID project tempat Anda ingin mencadangkan resource.
START_TIME
: waktu mulai 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, jika tidak ingin menggunakan offset, tentukanZ
.
Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu saat Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk membatalkan, menghapus, atau mengubah permintaan pemesanan untuk masa mendatang secara opsional setelah disetujui atau sebelum memasuki waktu penguncian, pastikan untuk menetapkan nilai yang direkomendasikan untuk waktu mulai.
END_TIME
: waktu berakhirnya 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
: 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 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.
ZONE
: zona untuk memesan resource.
Saat Anda menentukan flag --auto-delete-auto-created-reservations
,
Compute Engine akan otomatis menghapus pemesanan yang dibuat secara otomatis untuk
permintaan pemesanan untuk masa mendatang. Secara default, waktu penghapusan adalah dalam waktu 2 jam
setelah waktu berakhirnya periode pemesanan. Secara opsional, Anda dapat mengubahnya dengan
melakukan salah satu hal berikut:
Untuk menghapus pemesanan yang dibuat secara otomatis setelah waktu berakhirnya periode pemesanan, pilih salah satu metode berikut:
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 create 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 create 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
. Anda harus menonaktifkan opsi hapus otomatis jika ingin melampirkan reservasi yang dibuat otomatis ke abonemen.gcloud beta compute future-reservations create example-future-reservation \ --no-auto-delete-auto-created-reservations \ ...
Misalnya, perintah berikut membuat draf permintaan pemesanan untuk masa mendatang
untuk 80 VM.
Periode pemesanan dimulai pada tengah malam tanggal 10 November 2023 UTC, dan berakhir pada
tengah malam tanggal 10 Desember 2023 UTC.
VM yang dipesan menentukan
jenis mesin n2-standard-4
, platform CPU minimum skylake
, dan 1 SSD lokal dengan antarmuka scsi
,
masing-masing sebesar 375 GB.
Pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang dibuat di zona
us-central1-a
, memiliki nama yang diawali dengan fr-01-reservation
,
dan otomatis dihapus pada tengah malam tanggal 13 Desember 2023 UTC.
gcloud beta compute future-reservations create fr-01 \
--auto-delete-auto-created-reservations \
--auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
--local-ssd=size=375,interface=scsi \
--machine-type=n2-standard-4 \
--min-cpu-platform=skylake \
--name-prefix=fr-01-reservation \
--planning-status=DRAFT \
--project=example-project \
--start-time=2023-11-10T00:00:00Z \
--end-time=2023-12-10T00:00:00Z \
--total-count=80 \
--zone=us-central1-a
REST
Untuk membuat
permintaan pemesanan untuk masa mendatang bagi project tunggal
dengan menentukan
properti secara langsung, buat permintaan POST
ke
metode beta.futureReservations.insert
.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
{
"autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS",
"description": "DESCRIPTION",
"name": "FUTURE_RESERVATION_NAME",
"namePrefix": "NAME_PREFIX",
"planningStatus": "PLANNING_STATUS",
"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": {
"startTime": "START_TIME",
"endTime": "END_TIME"
}
}
Ganti kode berikut:
PROJECT_ID
: ID project tempat Anda ingin mencadangkan resource.ZONE
: zona tempat Anda ingin mencadangkan resource.AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: jika Anda menetapkan kolom ini ketrue
, Compute Engine akan otomatis menghapus pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, terlepas dari apakah kolom tersebut telah digunakan sepenuhnya atau tidak. Tetapkan kolom ini kefalse
jika Anda ingin melampirkan reservasi yang dibuat otomatis ke abonemen.Secara default, waktu penghapusan adalah dalam waktu 2 jam setelah waktu berakhirnya periode pemesanan. Untuk mengubahnya, lakukan salah satu langkah berikut:
Untuk menghapus reservasi yang dibuat otomatis setelah waktu tertentu setelah akhir periode reservasi, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDeleteTime
.POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME", ... }
Ganti
DELETE_TIME
dengan tanggal dan waktu saat Compute Engine menghapus pemesanan yang dibuat secara otomatis. 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 zona waktu Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan zona waktu Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, jika tidak ingin menggunakan offset, tentukanZ
.
Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan
autoDeleteAutoCreatedReservations
ketrue
dan tentukan kolomautoCreatedReservationsDuration
.POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations { "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. Deskripsi untuk permintaan pemesanan untuk masa mendatang.FUTURE_RESERVATION_NAME
: nama permintaan pemesanan untuk masa mendatang yang akan dibuat.NAME_PREFIX
: awalan nama untuk permintaan pemesanan untuk masa mendatang. Nama setiap pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang dimulai dengan awalan nama. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat secara otomatis untuk permintaan pemesanan untuk masa mendatang, sebaiknya tentukan awalan nama yang unik.
PLANNING_STATUS
: Opsional. Status perencanaan permintaan pemesanan untuk masa mendatang, yang harus berupa salah satu dari berikut:Untuk membuat draf permintaan pemesanan untuk masa mendatang, tentukan
DRAFT
.Untuk membuat permintaan pemesanan untuk masa mendatang dan mengirimkannya ke Google Cloud untuk disetujui, tentukan
SUBMITTED
.
Jika Anda menghapus kolom
planningStatus
, nilainya akan ditetapkan keDRAFT
.
Opsional: 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.
INTERFACE_1
danINTERFACE_2
: Opsional. Jenis antarmuka yang Anda inginkan di SSD lokal untuk digunakan setiap VM. 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.MACHINE_TYPE
: jenis mesin yang digunakan untuk setiap VM. Tentukan salah satu nilai berikut:Untuk jenis mesin yang telah ditetapkan:
MACHINE_FAMILY-standard-CPUS
.Untuk jenis mesin kustom:
MACHINE_FAMILY-custom-CPUS-MEMORY
. Sebelum menentukan jenis mesin kustom, tinjau batasan untuk VM dengan jenis mesin kustom.
Ganti kode berikut:
MACHINE_FAMILY
: kelompok mesin.CPUS
: jumlah vCPU.MEMORY
: total memori untuk VM yang dipesan. Memori harus kelipatan 256 MB dan harus disediakan dalam MB.
Misalnya, untuk menentukan jenis mesin kustom N2 dengan 4 vCPU dan memori 5 GB, yaitu 5.120 MB, tentukan
n2-custom-4-5120
.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.
TOTAL_COUNT
: 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 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
: waktu mulai periode pemesanan yang diformat sebagai stempel waktu RFC 3339. Waktu mulai tidak boleh lebih dari 1 tahun sejak tanggal dan waktu Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Selain itu, pastikan untuk menetapkan nilai yang direkomendasikan untuk waktu mulai guna memastikan Anda memiliki cukup waktu sebelum pemesanan untuk masa mendatang memasuki waktu penguncian.END_TIME
: waktu berakhirnya 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, perintah berikut membuat draf permintaan pemesanan untuk masa mendatang
untuk 80 VM.
Periode pemesanan dimulai pada tengah malam tanggal 10 November 2023 UTC, dan berakhir pada
tengah malam tanggal 10 Desember 2023 UTC.
VM yang dipesan menentukan
jenis mesin n2-standard-4
, platform CPU minimum skylake
, dan 1 SSD lokal dengan antarmuka SCSI
,
masing-masing sebesar 375 GB.
Pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang dibuat di zona
us-central1-a
, memiliki nama yang diawali dengan fr-01-reservation
,
dan otomatis dihapus pada tengah malam tanggal 13 Desember 2023 UTC.
POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations
{
"autoDeleteAutoCreatedReservations": "true",
"autoCreatedReservationsDeleteTime": "2023-12-13T00:00:00Z",
"name": "fr-01",
"namePrefix": "fr-01-reservation",
"specificSkuProperties": {
"instanceProperties": {
"localSsds": [
{
"diskSizeGb": "375",
"interface": "SCSI"
}
],
"machineType": "n2-standard-4",
"minCpuPlatform": "Skylake"
},
"totalCount": "80"
},
"planningStatus": "DRAFT",
"timeWindow": {
"startTime": "2023-11-10T00:00:00Z",
"endTime": "2023-12-10T00:00:00Z"
}
}
Mengirim draf permintaan pemesanan untuk masa mendatang untuk ditinjau
Anda dapat mengirimkan draf permintaan reservasi mendatang ke Google Cloud untuk ditinjau menggunakan Google Cloud Console, gcloud CLI, dan REST. Jika Anda juga ingin mengubah satu atau beberapa properti saat mengirimkan draf permintaan pemesanan untuk masa mendatang untuk ditinjau, lihat Mengubah draf atau permintaan pemesanan untuk masa mendatang ditolak.
Konsol
Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang untuk ditinjau, ikuti langkah-langkah berikut:
Di konsol Google Cloud, buka halaman Reservations.
Klik tab Future reservations.
Di kolom Name, klik nama permintaan reservasi mendatang dengan status pengadaan Drafting.
Halaman Future reservations yang berisi detail permintaan pemesanan untuk masa mendatang akan terbuka.
Klik
Edit draft.Halaman detail draf permintaan pemesanan untuk masa mendatang akan terbuka.
Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang ke Google Cloud, klik Submit.
Halaman Reservation akan terbuka. Di kolom Status pada permintaan reservasi mendatang yang baru saja Anda kirimkan, status pengadaan ditetapkan ke Menunggu persetujuan.
gcloud
Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang untuk ditinjau, gunakan
perintah gcloud beta compute future-reservations update
dengan flag --planning-status
ditetapkan ke SUBMITTED
.
gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
--planning-status=SUBMITTED \
--project=PROJECT_ID \
--zone=ZONE
Ganti kode berikut:
FUTURE_RESERVATION_NAME
: nama draf permintaan pemesanan untuk masa mendatang yang ada.PROJECT_ID
: ID project tempat permintaan pemesanan untuk masa mendatang berada.ZONE
: zona tempat permintaan pemesanan untuk masa mendatang berada.
REST
Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang untuk ditinjau, buat permintaan PATCH
ke
metode beta.futureReservations.update
dengan kolom planningStatus
ditetapkan ke SUBMITTED
.
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus
{
"name": "FUTURE_RESERVATION_NAME",
"planningStatus": "SUBMITTED"
}
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 permintaan pemesanan untuk masa mendatang yang ada.
Setelah mengirimkan draf permintaan reservasi mendatang untuk ditinjau, Anda dapat melakukan tindakan berikut:
Untuk memantau status pengadaan permintaan dan mengetahui apakah Google Cloud telah menyetujui atau menolak permintaan Anda, lihat detail permintaan reservasi Anda pada masa mendatang.
Agar Google Cloud tidak dapat meninjau permintaan Anda dan mencegah Compute Engine menyediakan kapasitas yang diminta, batalkan atau hapus permintaan reservasi Anda pada masa mendatang.
Memecahkan masalah
Jika Anda mengalami error saat membuat permintaan pemesanan untuk masa mendatang, lihat cara memecahkan masalah permintaan pemesanan untuk masa mendatang.
Jika Anda masih mengalami kesulitan setelah memecahkan masalah, hubungi Manajer Akun Teknis atau Tim Penjualan.
Langkah selanjutnya
Pelajari cara melihat permintaan pemesanan untuk masa mendatang.
Pelajari cara mengubah, membatalkan, atau menghapus permintaan pemesanan untuk masa mendatang.
Setelah mencapai waktu mulai periode pemesanan, pelajari cara menggunakan pemesanan yang dibuat otomatis.