Membuat permintaan pemesanan untuk masa mendatang bagi project tunggal


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

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

      gcloud init
    2. Menetapkan region dan zona default.

    REST

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

      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 persisproperti 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:

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Future reservations.

  3. Klik Create future reservation.

    Halaman Create a future reservation akan terbuka.

  4. Di kolom Name, masukkan nama untuk permintaan pemesanan untuk masa mendatang.

  5. 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.

  6. Opsional: Di kolom Description, masukkan deskripsi untuk permintaan pemesanan untuk masa mendatang.

  7. Di kolom Region, pilih region untuk memesan resource.

  8. Di kolom Zone, pilih zona untuk memesan resource.

  9. 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.

  10. 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.

  11. Di bagian Jenis berbagi, pilih Lokal (default).

  12. 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.

  13. Di bagian Machine configuration, lakukan hal berikut:

    1. Untuk menentukan properti VM Anda menggunakan instance template yang ada, pilih Use instance template.

    2. 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.

  14. 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:

      1. Klik tombol Enable auto-delete ke posisi aktif (default).

      2. 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.

  15. 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 ke DRAFT.

  • 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. Ganti REGION 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, tentukan Z.

    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, dengan END_DURATION adalah durasi periode reservasi dalam detik. Misalnya, tentukan 1209600 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, tentukan 30m selama 30 menit, atau 1d2h3m4s untuk 1 hari, 2 jam, 3 menit, dan 4 detik.

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus pemesanan yang dibuat otomatis, 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 ke true, 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 ke false 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 ke true dan tentukan kolom autoCreatedReservationsDeleteTime.

      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, tentukan Z.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDuration.

      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, tentukan 604800 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 ke DRAFT.

  • LOCATION: lokasi template instance. Tentukan salah satu nilai berikut:

    • Untuk template instance global: global.

    • Untuk template instance regional: regions/REGION. Ganti REGION 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 kolom endTime dengan kolom duration untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:

    "duration": {
      "seconds": "END_DURATION"
    }
    

    Ganti END_DURATION dengan durasi dalam detik. Misalnya, tentukan 1209600 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:

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Future reservations.

  3. Klik Create future reservation.

    Halaman Create a future reservation akan terbuka.

  4. Di kolom Name, masukkan nama untuk permintaan pemesanan untuk masa mendatang.

  5. 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.

  6. Opsional: Di kolom Description, masukkan deskripsi untuk permintaan pemesanan untuk masa mendatang.

  7. Di kolom Region, pilih region untuk memesan resource.

  8. Di kolom Zone, pilih zona untuk memesan resource.

  9. 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.

  10. 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.

  11. Di bagian Jenis berbagi, pilih Lokal (default).

  12. 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.

  13. Di bagian Machine configuration, lakukan hal berikut:

    1. Pilih Specify machine type (default).

    2. 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.

    3. Lakukan salah satu hal berikut:

      • Jika Anda menentukan General purpose, Compute optimized, atau Memory optimized di langkah sebelumnya, lakukan tindakan berikut:

        1. Dalam daftar Series, pilih seri mesin.

        2. Dalam daftar Machine type, pilih jenis mesin.

        3. 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:

        1. Di menu GPU type, pilih salah satu jenis GPU.

        2. Di menu Number of GPU, pilih jumlah GPU.

        3. 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).

        4. Dalam daftar Machine type, pilih jenis mesin.

        5. Di daftar CPU platform, pilih platform CPU untuk VM yang ingin Anda pesan.

    4. Opsional: Jika jenis mesin memungkinkan, dan Anda ingin menambahkan SSD lokal, lakukan langkah berikut:

      1. Di kolom Number of disks, pilih jumlah disk untuk SSD lokal Anda.

      2. Pada bagian Interface type, pilih salah satu antarmuka berikut:

        • SCSI (default)

        • NVMe

  14. 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:

      1. Klik tombol Enable auto-delete ke posisi aktif (default).

      2. 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.

  15. 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 dan INTERFACE_2: Opsional. Jenis antarmuka yang Anda inginkan di SSD lokal untuk digunakan setiap VM. Nilainya harus berupa salah satu dari berikut:

    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 ke DRAFT.

  • 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, tentukan Z.

    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, dengan END_DURATION adalah durasi periode reservasi dalam detik. Misalnya, tentukan 1209600 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, tentukan 30m selama 30 menit, atau 1d2h3m4s untuk 1 hari, 2 jam, 3 menit, dan 4 detik.

  • Untuk menonaktifkan Compute Engine agar tidak otomatis menghapus pemesanan yang dibuat otomatis, 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 ke true, 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 ke false 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 ke true dan tentukan kolom autoCreatedReservationsDeleteTime.

      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, tentukan Z.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu dari waktu mulai periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan tentukan kolom autoCreatedReservationsDuration.

      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, tentukan 604800 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 ke DRAFT.

  • 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 dan INTERFACE_2: Opsional. Jenis antarmuka yang Anda inginkan di SSD lokal untuk digunakan setiap VM. Nilainya harus berupa salah satu dari berikut:

    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 kolom endTime dengan kolom duration untuk menentukan durasi tertentu dari waktu mulai periode pemesanan:

    "duration": {
      "seconds": "END_DURATION"
    }
    

    Ganti END_DURATION dengan durasi dalam detik. Misalnya, tentukan 1209600 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:

  1. Di konsol Google Cloud, buka halaman Reservations.

    Buka Reservations

  2. Klik tab Future reservations.

  3. 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.

  4. Klik Edit draft.

    Halaman detail draf permintaan pemesanan untuk masa mendatang akan terbuka.

  5. 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:

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