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. Pemesanan bersama yang dibuat secara otomatis ini digunakan oleh VM yang cocok dan pemesanan yang ada di project yang menghosting pemesanan untuk masa mendatang (project pemilik) dan project yang dibagikan dengan pemesanan untuk 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:
  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Untuk informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat permintaan pemesanan untuk masa mendatang bersama kepada Anda, minta administrator untuk memberi Anda peran IAM Compute Future Reservation User (roles/compute.futureReservationUser) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditentukan ini berisi izin 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 pemesanan untuk masa mendatang: compute.futureReservations.create pada project
  • Agar Compute Engine membuat pemesanan secara otomatis: 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 bawaan lainnya.

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 draf

Saat membuat permintaan pemesanan untuk masa mendatang, Anda dapat menyimpan permintaan sebagai draf, lalu mengirimkannya ke Google Cloud untuk ditinjau, atau langsung mengirimkan permintaan untuk ditinjau. Google merekomendasikan untuk membuat permintaan draf terlebih dahulu karena hal ini memungkinkan Anda menentukan jumlah VM yang akan disediakan Compute Engine untuk permintaan Anda, bukan memperkirakan jumlah ini secara manual, dan secara opsional mengubah jumlah VM yang dicadangkan dalam permintaan sebelum mengirimkannya untuk ditinjau.

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 draf permintaan pemesanan untuk masa mendatang, gunakan salah satu metode berikut:

  • Direkomendasikan: Menentukan template instance

    Anda dapat menggunakan template instance yang ada untuk menentukan properti draf permintaan pemesanan untuk masa mendatang. 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 VM yang ada

    Anda dapat menggunakan VM yang ada untuk menentukan properti permintaan pemesanan untuk masa mendatang. Dengan menggunakan properti VM yang ada, Anda dapat menggunakan reservasi yang dibuat otomatis yang disediakan untuk pemesanan untuk masa mendatang dengan membuat VM dengan properti yang cocok dengan VM referensi.

  • Menentukan properti secara langsung

    Anda dapat menentukan properti draf permintaan pemesanan untuk masa mendatang secara langsung. Metode ini mengharuskan Anda secara manual memastikan bahwa properti VM dan pemesanan yang dibuat secara otomatis 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

Saat membuat permintaan pemesanan untuk masa mendatang bersama dengan menentukan template instance, pertimbangkan hal berikut:

  • Template instance berisi setelan spesifik per project, sehingga Anda hanya dapat mengakses dan menggunakan template instance dalam project yang sama. Jika membuat permintaan pemesanan untuk masa mendatang bersama dengan menentukan template instance, Anda harus membuat template serupa untuk membuat VM, atau membuat VM dengan menentukan properti yang cocok secara langsung, untuk menggunakan pemesanan yang dibuat otomatis di setiap project konsumen.

  • Anda harus membuat permintaan pemesanan untuk masa mendatang di region dan zona yang sama dengan resource dalam template instance. Setiap resource regional atau resource zona yang ditentukan dalam template instance—seperti jenis mesin atau Persistent Disk—membatasi penggunaan template ke lokasi tempat resource tersebut berada. Misalnya, jika template instance Anda menentukan Persistent Disk yang ada di zona us-central1-a, Anda harus membuat permintaan pemesanan untuk masa mendatang di zona yang sama. Jika tidak, pembuatan permintaan pemesanan untuk masa mendatang akan gagal.

    Untuk memeriksa apakah template yang ada menentukan resource yang mengikat template ke region atau zona tertentu, lihat detail template dan cari referensi ke resource regional atau zona di dalamnya.

  • Jika ingin melampirkan pemesanan yang dibuat otomatis yang disediakan untuk pemesanan untuk masa mendatang ke komitmen, Anda harus menonaktifkan opsi hapus otomatis. Untuk mengetahui informasi selengkapnya, lihat Pembatasan setelah pembuatan.

Setelah membuat permintaan pemesanan untuk masa mendatang, Anda tidak dapat mengubah permintaan pemesanan untuk masa mendatang untuk mengganti properti VM template atau menentukan template lain. Sebagai gantinya, jika perlu mengubah properti VM yang ditentukan dalam permintaan, Anda harus membuat permintaan pemesanan untuk masa mendatang yang baru.

Untuk membuat pemesanan untuk masa mendatang bersama dengan menentukan template instance yang ada, pilih salah satu opsi berikut:

Konsol

  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. Untuk Name, masukkan nama untuk permintaan pemesanan untuk masa mendatang.

  5. Untuk Awalan, masukkan awalan nama. Nama setiap pemesanan yang dibuat secara otomatis dari permintaan pemesanan untuk masa mendatang dimulai dengan awalan ini.

  6. Untuk Region dan Zone, pilih region dan zona tempat Anda ingin memesan resource.

  7. Untuk Start time, masukkan waktu mulai untuk periode pemesanan. Waktu mulai tidak boleh lebih dari satu tahun sejak tanggal dan waktu Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk mengubah, membatalkan, atau menghapus pemesanan untuk masa mendatang secara opsional sebelum memasuki waktu penguncian, tentukan nilai yang direkomendasikan untuk waktu mulai.

  8. Untuk 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.

  9. Di bagian Share type, lakukan tindakan berikut:

    1. Untuk menentukan permintaan pemesanan untuk masa mendatang bersama, pilih 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.

  10. Untuk Number of VM instances, masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

  11. Di bagian Machine configuration, lakukan hal berikut:

    1. Pilih Gunakan template instance.

    2. Untuk Instance template, pilih template instance pilihan Anda. Jika memilih template instance regional, Anda hanya dapat memesan resource dalam region yang sama dengan region template.

  12. 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 Aktifkan hapus otomatis ke posisi aktif jika belum disetel ke posisi tersebut.

      2. Opsional: Untuk Auto-delete time, masukkan tanggal dan waktu untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu dua jam setelah waktu berakhir periode pemesanan.

    • Jika tidak, klik tombol Enable auto-delete ke posisi nonaktif.

  13. Untuk menyelesaikan pembuatan draf permintaan pemesanan untuk masa mendatang, klik Save draft.

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 --share-setting=projects dan --share-with.

Untuk membuat draf permintaan pemesanan untuk masa mendatang dengan menentukan template instance tanpa menyertakan flag opsional, dan menghapus otomatis pemesanan yang dibuat otomatis di akhir periode pemesanan, jalankan perintah berikut:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --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.

  • MACHINE_TYPE: jenis mesin yang akan digunakan untuk setiap VM yang dipesan.

  • CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma yang ingin Anda izinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini—misalnya, 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 ini.

  • PROJECT_ID: ID project tempat Anda ingin memesan resource dan tempat template instance berada.

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

    • Untuk template instance regional: regions/REGION. Ganti REGION dengan region tempat template instance berada. Jika menentukan template instance regional, Anda hanya dapat membuat permintaan pemesanan untuk masa mendatang dalam region yang sama dengan region template.

    • Untuk template instance global: global.

  • INSTANCE_TEMPLATE_NAME: nama template instance yang ada.

  • START_TIME: waktu mulai periode pemesanan sebagai stempel waktu RFC 3339, yang harus diformat sebagai berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ganti kode berikut:

    • YYYY-MM-DD: data yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari satu 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 dan sebelum memasuki waktu penguncian, tentukan 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 flag --end-time dengan flag --duration=END_DURATION. Ganti END_DURATION dengan durasi periode pemesanan dalam detik. Misalnya, tentukan 1209600 selama 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, tentukan durasi minimum yang direkomendasikan.

  • TOTAL_COUNT: jumlah total VM yang ingin Anda pesan.

  • ZONE: zona tempat memesan resource.

Misalnya, Anda ingin membuat draf permintaan pemesanan untuk masa mendatang bernama fr-02 di zona us-central1-a dengan properti berikut:

  • Periode pemesanan yang dimulai pada tengah malam tanggal 10 November 2024 UTC, dan berakhir pada tengah malam tanggal 10 Desember 2024 UTC.

  • Jumlah total 80 VM.

  • Template instance regional dari region us-central1.
  • Opsi hapus otomatis diaktifkan. Pemesanan yang dibuat otomatis akan dihapus pada akhir periode pemesanan.
  • Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2.

Untuk membuat fr-02, jalankan perintah berikut:

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Secara opsional, Anda dapat melakukan satu atau beberapa 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 tanggal dan waktu tertentu setelah waktu berakhirnya periode pemesanan, sertakan flag --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --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 AUTO_CREATED_RESERVATIONS_DELETE_TIME dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, sertakan flag --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --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 DURATION_BEFORE_DELETE dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s selama satu hari, dua jam, tiga menit, dan empat detik.

  • Untuk menonaktifkan opsi hapus otomatis untuk pemesanan yang dibuat otomatis, ganti flag --auto-delete-auto-created-reservations dengan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --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

  • Untuk menentukan awalan nama untuk pemesanan yang dibuat otomatis, sertakan flag --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --name-prefix=NAME_PREFIX \
    --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 NAME_PREFIX dengan awalan nama untuk setiap pemesanan yang dibuat otomatis. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, Google Cloud merekomendasikan untuk menentukan awalan nama yang unik.

REST

Untuk membuat permintaan pemesanan untuk masa mendatang bersama dengan menentukan template instance, buat permintaan POST ke metode beta.futureReservations.insert.

Untuk membuat draf permintaan pemesanan untuk masa mendatang dengan menentukan template instance tanpa menyertakan kolom opsional apa pun, buat permintaan POST sebagai berikut:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "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 menyimpan resource dan tempat template instance berada.

  • ZONE: zona tempat memesan resource.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang ini dalam waktu dua jam sejak waktu berakhirnya periode pemesanan. Jika Anda ingin melampirkan pemesanan yang dibuat secara otomatis ke komitmen, tetapkan kolom ini ke false.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID 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 menentukan project pemilik. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini.

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

    • Untuk template instance regional: regions/REGION. Ganti REGION dengan region tempat template instance berada. Jika menentukan template instance regional, Anda hanya dapat membuat permintaan pemesanan untuk masa mendatang dalam region yang sama dengan region template.

    • Untuk template instance global: global.

  • INSTANCE_TEMPLATE_NAME: nama template instance yang ada.

  • TOTAL_COUNT: jumlah total VM yang ingin Anda pesan.

  • START_TIME: waktu mulai periode pemesanan sebagai stempel waktu RFC 3339, yang harus diformat sebagai berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ganti kode berikut:

    • YYYY-MM-DD: data yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari satu 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 dan sebelum memasuki waktu penguncian, tentukan 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 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 selama 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, tentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

Misalnya, Anda ingin membuat draf permintaan pemesanan untuk masa mendatang bernama fr-02 di zona us-central1-a dengan properti berikut:

  • Periode pemesanan yang dimulai pada tengah malam tanggal 10 November 2024 UTC, dan berakhir pada tengah malam tanggal 10 Desember 2024 UTC.

  • Jumlah total 80 VM.

  • Template instance regional dari region us-central1.
  • Opsi hapus otomatis diaktifkan. Pemesanan yang dibuat otomatis akan dihapus pada akhir periode pemesanan.
  • Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2.

Untuk membuat fr-02, buat permintaan POST sebagai berikut:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:

  • Untuk menentukan awalan nama untuk pemesanan yang dibuat otomatis, sertakan kolom namePrefix.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "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 NAME_PREFIX dengan awalan nama untuk setiap pemesanan yang dibuat otomatis. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, Google Cloud merekomendasikan untuk menentukan awalan nama yang unik.

  • Untuk menghapus pemesanan yang dibuat secara otomatis setelah waktu berakhirnya periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis setelah waktu tertentu setelah akhir periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan sertakan kolom autoCreatedReservationsDeleteTime.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "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 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.

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

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "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 DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 selama 604.800 detik (7 hari).

Setelah membuat draf permintaan pemesanan untuk masa mendatang, Anda dapat menentukan jumlah VM yang akan disediakan Compute Engine untuk permintaan tersebut.

Menentukan VM yang ada

Anda hanya dapat membuat draf permintaan pemesanan untuk masa mendatang berdasarkan VM yang ada di project dan zona yang sama dengan VM.

Setelah permintaan pemesanan untuk masa mendatang disetujui oleh Google Cloud dan memasuki periode pemesanannya, Anda dapat menggunakan pemesanan yang dibuat secara otomatis dengan membuat VM dengan properti yang cocok dengan VM referensi. Anda dapat melakukannya dengan melakukan salah satu hal berikut:

  • Buat dan gunakan template instance sebagai berikut:

    1. Buat template instance berdasarkan VM referensi tanpa mengganti properti VM referensi.

    2. Buat VM menggunakan template yang baru dibuat dengan melakukan salah satu atau kedua hal berikut:

  • Buat VM dengan properti yang sama persis dengan VM referensi sebagai berikut:

    • Di project pemilik, buat VM berdasarkan VM referensi tanpa mengubah properti VM yang Anda buat.

    • Dalam project konsumen, buat VM sambil memastikan secara manual bahwa propertinya dan properti VM referensi cocok.

Untuk membuat permintaan pemesanan untuk masa mendatang bersama yang menggunakan properti VM yang ada, lakukan 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. Untuk Name, masukkan nama untuk permintaan pemesanan untuk masa mendatang.

  5. Untuk Awalan, masukkan awalan nama. Nama setiap pemesanan yang dibuat secara otomatis dari permintaan pemesanan untuk masa mendatang dimulai dengan awalan ini.

  6. Untuk Region dan Zone, pilih region dan zona tempat Anda ingin memesan resource.

  7. Untuk Start time, masukkan waktu mulai untuk periode pemesanan. Waktu mulai tidak boleh lebih dari satu tahun sejak tanggal dan waktu Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk mengubah, membatalkan, atau menghapus pemesanan untuk masa mendatang secara opsional sebelum memasuki waktu penguncian, tentukan nilai yang direkomendasikan untuk waktu mulai.

  8. Untuk 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.

  9. Di bagian Share type, lakukan tindakan berikut:

    1. Untuk menentukan permintaan pemesanan untuk masa mendatang bersama, pilih 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.

  10. Untuk Number of VM instances, masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

  11. Di bagian Machine configuration, lakukan hal berikut:

    1. Pilih Gunakan VM yang ada.

    2. Untuk VM yang Ada, pilih VM yang propertinya ingin Anda gunakan untuk membuat reservasi.

  12. 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 Aktifkan hapus otomatis ke posisi aktif jika belum disetel ke posisi tersebut.

      2. Opsional: Untuk Auto-delete time, masukkan tanggal dan waktu untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu dua jam setelah waktu berakhir periode pemesanan.

    • Jika tidak, klik tombol Enable auto-delete ke posisi nonaktif.

  13. Untuk menyelesaikan pembuatan draf permintaan pemesanan untuk masa mendatang, klik Save draft.

Halaman Reservations akan terbuka. Pembuatan permintaan pemesanan untuk masa mendatang dapat memakan waktu hingga satu menit.

Setelah membuat draf permintaan pemesanan untuk masa mendatang, Anda dapat menentukan jumlah VM yang akan disediakan Compute Engine untuk permintaan tersebut.

Menentukan properti secara langsung

Jika ingin melampirkan pemesanan yang dibuat otomatis yang disediakan untuk pemesanan untuk masa mendatang ke komitmen, Anda harus menonaktifkan opsi hapus otomatis. Untuk mengetahui informasi selengkapnya, lihat Pembatasan setelah pembuatan.

Untuk membuat permintaan pemesanan untuk masa mendatang bersama dengan menentukan properti secara langsung, pilih salah satu opsi berikut:

Konsol

  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. Untuk Name, masukkan nama untuk permintaan pemesanan untuk masa mendatang.

  5. Untuk Awalan, masukkan awalan nama. Nama setiap pemesanan yang dibuat secara otomatis dari permintaan pemesanan untuk masa mendatang dimulai dengan awalan ini.

  6. Untuk Region dan Zone, pilih region dan zona tempat Anda ingin memesan resource.

  7. Untuk Start time, masukkan waktu mulai untuk periode pemesanan. Waktu mulai tidak boleh lebih dari satu tahun sejak tanggal dan waktu Anda mengirimkan permintaan pemesanan untuk masa mendatang untuk ditinjau. Agar memiliki cukup waktu untuk mengubah, membatalkan, atau menghapus pemesanan untuk masa mendatang secara opsional sebelum memasuki waktu penguncian, tentukan nilai yang direkomendasikan untuk waktu mulai.

  8. Untuk 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.

  9. Di bagian Share type, lakukan tindakan berikut:

    1. Untuk menentukan permintaan pemesanan untuk masa mendatang bersama, pilih 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.

  10. Untuk Number of VM instances, masukkan jumlah total VM yang ingin Anda pesan untuk periode, konfigurasi VM, dan project yang ditentukan dalam permintaan pemesanan untuk masa mendatang.

  11. Di bagian Machine configuration, lakukan hal berikut:

    1. Pilih Specify machine type jika belum dipilih.

    2. Tentukan jenis mesin yang akan digunakan untuk VM yang direservasi.

  12. 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 Aktifkan hapus otomatis ke posisi aktif jika belum disetel ke posisi tersebut.

      2. Opsional: Untuk Auto-delete time, masukkan tanggal dan waktu untuk menghapus pemesanan yang dibuat otomatis. Tanggal dan waktu harus setelah waktu berakhirnya periode pemesanan. Jika Anda membiarkan kolom ini kosong, pemesanan yang dibuat secara otomatis akan dihapus dalam waktu dua jam setelah waktu berakhir periode pemesanan.

    • Jika tidak, klik tombol Enable auto-delete ke posisi nonaktif.

  13. Untuk menyelesaikan pembuatan draf permintaan pemesanan untuk masa mendatang, klik Save draft.

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 dengan flag --share-setting=projects dan --share-with.

Untuk membuat draf permintaan pemesanan untuk masa mendatang dengan menentukan properti secara langsung tanpa menyertakan flag opsional, dan menghapus otomatis pemesanan yang dibuat otomatis di akhir periode pemesanan, jalankan perintah berikut:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --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.

  • MACHINE_TYPE: jenis mesin yang akan digunakan untuk setiap VM yang dipesan.

  • CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma yang ingin Anda izinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini—misalnya, 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 ini.

  • START_TIME: waktu mulai periode pemesanan sebagai stempel waktu RFC 3339, yang harus diformat sebagai berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ganti kode berikut:

    • YYYY-MM-DD: data yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari satu 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 dan sebelum memasuki waktu penguncian, tentukan 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 flag --end-time dengan flag --duration=END_DURATION. Ganti END_DURATION dengan durasi periode pemesanan dalam detik. Misalnya, tentukan 1209600 selama 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, tentukan durasi minimum yang direkomendasikan.

  • TOTAL_COUNT: jumlah total VM yang ingin Anda pesan.

  • ZONE: zona tempat memesan resource.

Misalnya, Anda ingin membuat draf permintaan pemesanan untuk masa mendatang bernama fr-02 di zona us-central1-a dengan properti berikut:

  • Periode pemesanan yang dimulai pada tengah malam tanggal 10 November 2024 UTC, dan berakhir pada tengah malam tanggal 10 Desember 2024 UTC.

  • Jumlah total 80 VM.

  • Jenis mesin standar N2 dengan 4 vCPU.
  • Opsi hapus otomatis diaktifkan. Pemesanan yang dibuat otomatis akan dihapus pada akhir periode pemesanan.
  • Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2.

Untuk membuat fr-02, jalankan perintah berikut:

gcloud beta compute future-reservations create fr-02 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --share-setting=projects \
    --share-with=project-1,project-2 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:

  • Untuk memasang GPU ke VM N1 yang dipesan, sertakan flag --accelerator.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --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:

    • NUMBER_OF_ACCELERATORS: jumlah GPU yang akan ditambahkan per VM yang dipesan.

    • ACCELERATOR_TYPE: model GPU yang didukung untuk VM N1. Untuk mencegah error, pastikan model GPU yang Anda pilih tersedia di zona tempat Anda membuat permintaan pemesanan untuk masa mendatang.

  • Untuk menghapus pemesanan yang dibuat secara otomatis setelah waktu berakhirnya periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis pada tanggal dan waktu tertentu setelah waktu berakhirnya periode pemesanan, sertakan flag --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Ganti AUTO_CREATED_RESERVATIONS_DELETE_TIME dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • Untuk menghapus pemesanan yang dibuat otomatis setelah durasi tertentu setelah waktu berakhirnya periode pemesanan, sertakan flag --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s selama satu hari, dua jam, tiga menit, dan empat detik.

  • Untuk menonaktifkan opsi hapus otomatis untuk pemesanan yang dibuat otomatis, ganti flag --auto-delete-auto-created-reservations dengan flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --no-auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

  • Untuk menambahkan satu atau beberapa disk SSD Lokal ke setiap VM yang dicadangkan, sertakan satu atau beberapa flag --local-ssd. Anda dapat menentukan hingga 24 disk SSD Lokal. Ukuran setiap disk SSD Lokal adalah 375 GB.

    Misalnya, untuk menentukan dua disk SSD Lokal saat membuat draf permintaan pemesanan untuk masa mendatang, sertakan dua flag --local-ssd sebagai berikut:

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --local-ssd=size=375,interface=INTERFACE_1 \
    --local-ssd=size=375,interface=INTERFACE_2 \
    --machine-type=MACHINE_TYPE \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ganti INTERFACE_1 dan INTERFACE_2 dengan jenis antarmuka yang Anda inginkan untuk digunakan disk SSD Lokal sebagai berikut:

    Pastikan jenis mesin yang Anda tentukan untuk VM yang direservasi mendukung antarmuka disk yang dipilih. Jika tidak, pembuatan permintaan pemesanan untuk masa mendatang akan gagal. Untuk informasi selengkapnya, lihat cara memilih antarmuka disk.

  • Agar VM yang dipesan menggunakan platform CPU minimum tertentu, bukan platform CPU default zona, sertakan flag --min-cpu-platform.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --min-cpu-platform="MIN_CPU_PLATFORM" \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ganti MIN_CPU_PLATFORM dengan platform CPU minimum. Untuk memastikan platform CPU tersedia di zona tempat Anda menyimpan resource, lihat platform CPU yang tersedia menurut zona.

  • Untuk menentukan awalan nama untuk pemesanan yang dibuat otomatis, sertakan flag --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --name-prefix=NAME_PREFIX \
    --share-setting=projects \
    --share-with=CONSUMER_PROJECT_IDS \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

    Ganti NAME_PREFIX dengan awalan nama untuk setiap pemesanan yang dibuat otomatis. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, Google Cloud merekomendasikan untuk menentukan awalan nama yang unik.

REST

Untuk membuat permintaan pemesanan untuk masa mendatang bersama dengan menentukan properti secara langsung, buat permintaan POST ke metode beta.futureReservations.insert.

Untuk membuat draf permintaan pemesanan untuk masa mendatang dengan menentukan properti secara langsung tanpa menyertakan kolom opsional apa pun, buat permintaan POST sebagai berikut:

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat Anda ingin memesan resource.

  • ZONE: zona tempat memesan resource.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: jika Anda menetapkan kolom ini ke true, Compute Engine akan otomatis menghapus pemesanan yang dibuat secara otomatis untuk pemesanan untuk masa mendatang ini dalam waktu dua jam sejak waktu berakhirnya periode pemesanan. Jika Anda ingin melampirkan pemesanan yang dibuat secara otomatis ke komitmen, tetapkan kolom ini ke false.

  • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID 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 menentukan project pemilik. Secara default, project sudah diizinkan untuk menggunakan pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini.

  • TOTAL_COUNT: jumlah total VM yang ingin Anda pesan.

  • START_TIME: waktu mulai periode pemesanan sebagai stempel waktu RFC 3339, yang harus diformat sebagai berikut:

    YYYY-MM-DDTHH:MM:SSOFFSET

    Ganti kode berikut:

    • YYYY-MM-DD: data yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam bulan, yang dipisahkan dengan tanda hubung (-).

    • HH:MM:SS: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:).

    • OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, untuk tidak menggunakan penyeimbang, tentukan Z.

    Waktu mulai tidak boleh lebih dari satu 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 dan sebelum memasuki waktu penguncian, tentukan 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 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 selama 1.209.600 detik (14 hari).

    Untuk meningkatkan kemungkinan Google Cloud menyetujui permintaan pemesanan untuk masa mendatang setelah Anda mengirimkannya untuk ditinjau, tentukan salah satu nilai yang direkomendasikan untuk periode pemesanan Anda.

Misalnya, Anda ingin membuat draf permintaan pemesanan untuk masa mendatang bernama fr-02 di zona us-central1-a dengan properti berikut:

  • Periode pemesanan yang dimulai pada tengah malam tanggal 10 November 2024 UTC, dan berakhir pada tengah malam tanggal 10 Desember 2024 UTC.

  • Jumlah total 80 VM.

  • Jenis mesin standar N2 dengan 4 vCPU.
  • Opsi hapus otomatis diaktifkan. Pemesanan yang dibuat otomatis akan dihapus pada akhir periode pemesanan.
  • Permintaan pemesanan untuk masa mendatang dibagikan dengan project-1 dan project-2.

Untuk membuat fr-02, buat permintaan POST sebagai berikut:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-02",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "shareSettings": {
    "projects": [
      "project-1",
      "project-2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:

  • Untuk menentukan awalan nama untuk pemesanan yang dibuat otomatis, sertakan kolom namePrefix.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "namePrefix": "NAME_PREFIX",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ganti NAME_PREFIX dengan awalan nama untuk setiap pemesanan yang dibuat otomatis. Untuk membantu Anda mengidentifikasi pemesanan yang dibuat otomatis untuk permintaan pemesanan untuk masa mendatang ini, Google Cloud merekomendasikan untuk menentukan awalan nama yang unik.

  • Untuk memasang GPU ke VM N1 yang dipesan, sertakan kolom guestAccelerators.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "guestAccelerators": [
        {
          "acceleratorCount": NUMBER_OF_ACCELERATORS,
          "acceleratorType": "ACCELERATOR_TYPE"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ganti kode berikut:

    • NUMBER_OF_ACCELERATORS: jumlah GPU yang akan ditambahkan per VM yang dipesan.

    • ACCELERATOR_TYPE: model GPU yang didukung untuk VM N1. Untuk mencegah error, pastikan model GPU yang Anda pilih tersedia di zona tempat Anda membuat permintaan pemesanan untuk masa mendatang.

  • Untuk menambahkan satu atau beberapa disk SSD Lokal ke setiap VM yang direservasi, sertakan kolom localSsds. Anda dapat menentukan hingga 24 Disk SSD lokal. Ukuran setiap disk SSD Lokal adalah 375 GB.

    Misalnya, untuk menentukan dua disk SSD Lokal saat membuat draf permintaan pemesanan untuk masa mendatang, buat permintaan POST sebagai berikut:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_1"
        },
        {
          "diskSizeGb": "375",
          "interface": "INTERFACE_2"
        }
      ],
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ganti INTERFACE_1 dan INTERFACE_2 dengan jenis antarmuka yang ingin Anda gunakan untuk disk SSD Lokal:

    Pastikan jenis mesin yang Anda tentukan untuk VM yang direservasi mendukung antarmuka disk yang dipilih. Jika tidak, pembuatan permintaan pemesanan untuk masa mendatang akan gagal. Untuk informasi selengkapnya, lihat cara memilih antarmuka disk.

  • Agar VM yang dipesan menggunakan platform CPU minimum tertentu, bukan platform CPU default zona, sertakan minCpuPlatform.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "MACHINE_TYPE",
      "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

    Ganti MIN_CPU_PLATFORM dengan platform CPU minimum. Untuk memastikan platform CPU tersedia di zona tempat Anda memesan resource, lihat platform CPU yang tersedia menurut zona.

  • Untuk menghapus pemesanan yang dibuat secara otomatis setelah waktu berakhirnya periode pemesanan, pilih salah satu metode berikut:

    • Untuk menghapus pemesanan yang dibuat otomatis setelah waktu tertentu setelah akhir periode pemesanan, tetapkan autoDeleteAutoCreatedReservations ke true dan sertakan kolom autoCreatedReservationsDeleteTime.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDeleteTime": "DELETE_TIME",
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_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.

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

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

{
  "autoCreatedReservationsDuration": {
    "seconds": "DURATION_BEFORE_DELETE"
  },
  "autoDeleteAutoCreatedReservations": true,
  "name": "FUTURE_RESERVATION_NAME",
  "shareSettings": {
    "projects": [
      "CONSUMER_PROJECT_ID_1",
      "CONSUMER_PROJECT_ID_2"
    ],
    "shareType": "SPECIFIC_PROJECTS"
  },
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

      Ganti DURATION_BEFORE_DELETE dengan durasi dalam detik. Misalnya, tentukan 604800 selama 604.800 detik (7 hari).

Setelah membuat draf permintaan pemesanan untuk masa mendatang, Anda dapat menentukan jumlah VM yang akan disediakan Compute Engine untuk permintaan tersebut.

Mengirim permintaan draf

Setelah permintaan pemesanan untuk masa mendatang dikirimkan, disetujui oleh Google Cloud, dan melewati waktu kuncinya, Anda dapat menghapus pemesanan untuk masa mendatang dan pemesanan yang dibuat secara otomatis hanya setelah akhir periode pemesanan pemesanan untuk masa mendatang. Menghapus pemesanan untuk masa mendatang yang ada berguna jika Anda perlu membuat pemesanan untuk masa mendatang lainnya dengan properti yang sama. Oleh karena itu, sebelum membuat permintaan pemesanan untuk masa mendatang, pastikan hal berikut:

  • Semua pemesanan atau pemesanan untuk masa mendatang yang ada dalam sebuah project akan membatasi setelan berbagi dari permintaan pemesanan untuk masa mendatang yang dapat Anda buat. Untuk memastikan Anda berhasil membuat permintaan pemesanan untuk masa mendatang, dan permintaan Anda tidak menyebabkan masalah pada project lain yang juga menggunakan pemesanan atau pemesanan untuk masa mendatang, lihat Batasan.

  • Anda harus berkomitmen untuk membayar resource yang Anda pesan dan disediakan Compute Engine untuk seluruh periode pemesanan, terlepas dari apakah pemesanan yang dibuat secara otomatis digunakan atau tidak. Untuk mengetahui informasi selengkapnya, lihat Penagihan.

Jika Anda ingin mengubah satu atau beberapa properti saat mengirimkan draf permintaan pemesanan untuk masa mendatang untuk ditinjau, lihat Mengubah permintaan pemesanan untuk masa mendatang.

Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang ke Google Cloud untuk ditinjau, pilih salah satu opsi berikut:

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Reservations

  2. Klik tab Future reservations.

  3. Di kolom Name, klik nama permintaan pemesanan untuk masa mendatang dengan status pengadaan Drafting.

    Halaman Future reservations yang berisi detail permintaan pemesanan untuk masa mendatang akan terbuka.

  4. Klik Edit draft.

    Halaman untuk memperbarui draf permintaan pemesanan untuk masa mendatang akan terbuka.

  5. Untuk mengirimkan draf permintaan pemesanan untuk masa mendatang untuk ditinjau, klik Kirim.

Halaman Reservation akan terbuka. Di kolom Status permintaan pemesanan untuk masa mendatang yang baru saja Anda kirimkan, status pengadaannya akan ditetapkan ke Pending approval.

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 \
    --zone=ZONE

Ganti kode berikut:

  • FUTURE_RESERVATION_NAME: nama draf permintaan pemesanan untuk masa mendatang yang ada.

  • 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. Dalam isi permintaan, sertakan kolom planningStatus dan tetapkan 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 pemesanan untuk masa mendatang untuk ditinjau, Anda dapat melakukan hal 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 masalah setelah memecahkan masalah, hubungi Manajer Akun Teknis atau Tim Penjualan.

Langkah selanjutnya