Membuat permintaan pemesanan untuk masa mendatang bersama


Dokumen ini menjelaskan cara membuat permintaan pemesanan untuk masa mendatang bersama.

Jika Google Cloud menyetujui permintaan pemesanan untuk masa mendatang bersama dari Anda, pada waktu mulai yang ditentukan dalam permintaan Anda, Compute Engine akan otomatis membuat pemesanan yang dibagikan ke beberapa project. Reservasi bersama yang dibuat secara otomatis ini digunakan oleh VM yang cocok dan reservasi yang ada di project yang menghosting reservasi mendatang (project pemilik) dan project yang digunakan bersama oleh reservasi di masa mendatang (project konsumen). Untuk mengetahui informasi selengkapnya tentang cara kerja pemesanan bersama yang dibuat otomatis dan dapat digunakan, lihat Membuat pemesanan bersama.

Sebelum memulai

  • Jika belum:
  • 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 Anda perlukan guna membuat permintaan reservasi bersama di masa mendatang, 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 bersama. 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 bersama:

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

Pembatasan

Selain pembatasan umum untuk pemesanan untuk masa mendatang, pembuatan permintaan pemesanan untuk masa mendatang bersama memiliki batasan berikut:

  • Project yang Anda gunakan untuk membuat permintaan pemesanan untuk masa mendatang bersama (project pemilik) harus ditambahkan ke daftar yang diizinkan untuk kebijakan organisasi Project Pemilik Pemesanan Bersama (compute.sharedReservationsOwnerProjects) oleh administrator kebijakan organisasi. Untuk mengetahui informasi selengkapnya, lihat Mengizinkan dan membatasi project untuk membuat dan mengubah pemesanan bersama dalam dokumentasi pemesanan Compute Engine.

  • Jika Anda memindahkan project yang membuat permintaan pemesanan untuk masa mendatang bersama ke organisasi lain, pemesanan untuk masa mendatang bersama akan dihapus. Project tidak dihapus secara otomatis dari batasan kebijakan organisasi Project Pemilik Pemesanan Bersama (compute.sharedReservationsOwnerProjects), tetapi Anda dapat menghapus project dari batasan ini jika memang diinginkan.

  • Setiap permintaan pemesanan untuk masa mendatang bersama dapat dibagikan dengan hingga 100 project konsumen.

  • Untuk setiap organisasi, Anda dapat membuat hingga 100 permintaan pemesanan untuk masa mendatang bersama untuk setiap kombinasi unik dari properti VM.

Membuat permintaan pemesanan untuk masa mendatang bersama

Bagian ini menjelaskan cara membuat permintaan pemesanan untuk masa mendatang bersama.

Setelah Anda membuat permintaan pemesanan untuk masa mendatang bersama, permintaan tersebut hanya dapat dibatalkan, dihapus, atau diubah oleh project pemilik. Namun, pemesanan yang dibuat secara otomatis dapat digunakan oleh project pemilik dan project konsumen yang dibagikan dengan permintaan pemesanan untuk masa mendatang bersama.

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 bersama. Dengan menggunakan template instance, Anda dapat menentukan properti permintaan pemesanan untuk masa mendatang dan VM yang dapat menggunakan pemesanan yang dibuat otomatis di tempat yang sama. Namun, karena template bersifat khusus project, Anda tidak dapat menggunakan template yang sama untuk membuat VM yang dapat menggunakan pemesanan yang dibuat otomatis di luar project yang membuat permintaan pemesanan untuk masa mendatang. Untuk project yang dibagikan dengan pemesanan untuk masa mendatang, Anda harus membuat template yang serupa dalam project tersebut atau membuat VM dengan menentukan properti secara langsung.

  • Menentukan properti secara langsung

    Bagian ini menjelaskan cara menentukan properti permintaan pemesanan untuk masa mendatang bersama secara langsung. Metode ini mengharuskan Anda secara manual memastikan bahwa properti VM Anda dan pemesanan yang dibuat otomatis cocok sama persis—setiap 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 reservasi bersama mendatang dengan menentukan template instance yang ada menggunakan Google Cloud Console, gcloud CLI, dan REST.

Konsol

Untuk membuat permintaan pemesanan untuk masa mendatang bersama dengan menentukan template instance, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Reservations.

    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 Share type, lakukan tindakan berikut:

    1. Untuk menentukan permintaan pemesanan untuk masa mendatang bersama, klik Shared.

    2. Klik Add projects, lalu pilih project dari organisasi project saat ini yang ingin Anda bagikan permintaan pemesanan untuk masa mendatang.

      Anda dapat memilih hingga 100 project. Jangan pilih project saat ini. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang.

  12. Di kolom Number of VM instances, masukkan jumlah total VM yang ingin dicadangkan 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 bersama 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 \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --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.

  • CONSUMER_PROJECT_IDS: daftar yang dipisahkan koma dari ID project dari project yang dapat dibagikan dengan permintaan pemesanan untuk masa mendatang. Misalnya, tentukan project-1,project-2. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang.
  • 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. Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2. 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-02-reservation, dan otomatis dihapus pada tengah malam tanggal 13 Desember 2023 UTC.

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --auto-created-reservations-delete-time=2023-12-13T00:00:00Z \
    --name-prefix=fr-02-reservation \
    --planning-status=DRAFT \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --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 bersama 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",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "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.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID project dari project yang dapat dibagikan oleh permintaan pemesanan untuk masa mendatang ini. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat pembuatan permintaan pemesanan untuk masa mendatang (project pemilik). Jangan menyebutkan project pemilik. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini.
  • 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. Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2. 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-02-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-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": {
    "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-template",
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2023-11-10T00:00:00Z",
    "endTime": "2023-12-10T00:00:00Z"
  }
}

Menentukan properti VM secara langsung

Anda dapat membuat permintaan reservasi bersama untuk masa mendatang dengan menentukan properti secara langsung menggunakan Konsol Google Cloud, gcloud CLI, dan REST.

Konsol

Untuk membuat permintaan pemesanan untuk masa mendatang bersama dengan menentukan properti secara langsung, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman Reservations.

    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 Share type, lakukan tindakan berikut:

    1. Untuk menentukan permintaan pemesanan untuk masa mendatang bersama, klik Shared.

    2. Klik Add projects, lalu pilih project dari organisasi project saat ini yang ingin Anda bagikan permintaan pemesanan untuk masa mendatang.

      Anda dapat memilih hingga 100 project. Jangan pilih project saat ini. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang.

  12. Di kolom Number of VM instances, masukkan jumlah total VM yang ingin dicadangkan 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 bersama 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 \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama 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.

  • CONSUMER_PROJECT_IDS: daftar yang dipisahkan koma dari ID project dari project yang dapat dibagikan dengan permintaan pemesanan untuk masa mendatang. Misalnya, tentukan project-1,project-2. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat permintaan pemesanan untuk masa mendatang dibuat (project pemilik). Jangan menetapkan project pemilik. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang.
  • 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. Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2. 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-02-reservation, dan otomatis dihapus pada tengah malam tanggal 13 Desember 2023 UTC.

gcloud beta compute future-reservations create fr-02 \
    --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-02-reservation \
    --planning-status=DRAFT \
    --project=example-project \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --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 bersama 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",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "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.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID project dari project yang dapat dibagikan oleh permintaan pemesanan untuk masa mendatang ini. Anda dapat menentukan hingga 100 project. Project ini harus berada di organisasi yang sama dengan project tempat pembuatan permintaan pemesanan untuk masa mendatang (project pemilik). Jangan menyebutkan project pemilik. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini.
  • 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. Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2. 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-02-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-02",
  "namePrefix": "fr-02-reservation",
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ],
      "machineType": "n2-standard-4",
      "minCpuPlatform": "Skylake"
    },
    "totalCount": "80"
  },
  "planningStatus": "DRAFT",
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "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