Menggabungkan dan memisahkan komitmen

---

Untuk membantu Anda mengelola persyaratan resource bagi project, Compute Engine memungkinkan Anda menggabungkan atau memisahkan komitmen yang ada dan mendistribusikan ulang resource agar sesuai dengan tingkat perincian yang diperlukan untuk project Anda.

Dokumen ini menjelaskan manfaat dan proses penggabungan serta pemisahan komitmen, beserta batasan dan persyaratan yang berlaku.

Sebelum memulai

• 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

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  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.

Menggabungkan komitmen

Anda dapat menggabungkan beberapa komitmen yang kompatibel untuk membuat komitmen baru yang lebih besar. Dengan menggabungkan komitmen, Anda dapat melacak dan mengelolanya sebagai satu entitas. Menggabungkan komitmen membantu Anda menghindari tanggal akhir komitmen yang berbeda-beda dengan menggabungkan komitmen individu agar masa berlakunya berakhir pada waktu yang sama. Penggabungan juga memungkinkan Anda untuk meningkatkan workload secara bertahap. Misalnya, Anda dapat membeli komitmen yang lebih baru dan lebih kecil jika diperlukan dan memilih untuk menggabungkannya bersama atau dengan komitmen yang sudah ada.

Perhatian: Saat Anda menggabungkan komitmen, semua aturan atribusi prioritas yang terkait dengan komitmen tersebut akan dihapus dan tidak dapat dipulihkan. Jika ingin terus menggunakan aturan atribusi yang diprioritaskan pada komitmen gabungan, Anda harus membuat ulang aturan tersebut setelah operasi masing-masing.

Cara kerja penggabungan

Jika menggabungkan komitmen individu (komitmen sumber), Anda akan membuat komitmen baru (komitmen gabungan) dengan resource gabungan dari semua komitmen sumber. Pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas) pada hari berikutnya, komitmen gabungan akan aktif dan komitmen sumber dibatalkan. Tanggal aktivasi ini menjadi tanggal mulai untuk komitmen gabungan dan operasi penggabungan berakhir.

Selain itu, komitmen gabungan yang baru dibuat mewarisi properti berikut, terlepas dari apakah komitmen sumber memiliki durasi masa berlaku preset atau durasi masa berlaku kustom:

• Tanggal akhir yang paling jauh di masa mendatang di antara komitmen sumber.
• Periode kelayakan perpanjangan masa berlaku yang berakhir paling awal di antara komitmen sumber.

Misalnya, pertimbangkan dua komitmen sumber yang dimulai pada 1 Januari 2020 dan 1 Desember 2020. Masing-masing komitmen memiliki tanggal akhir 1 Januari 2023 dan 1 Desember 2023. Periode kelayakan perpanjangan masa berlaku untuk komitmen pertama tetap terbuka hingga 1 Mei 2020, dan untuk komitmen kedua hingga 1 April 2021. Jika Anda menggabungkan komitmen ini pada 1 Maret 2022, komitmen gabungan akan mewarisi tanggal akhir 1 Desember 2023. Periode kelayakan perpanjangan jangka waktu untuk komitmen gabungan akan telah berakhir pada 1 Mei 2020.

Jika salah satu komitmen sumber memiliki pemesanan yang terlampir, pemesanan itu akan dipertahankan selama penggabungan dan dilampirkan ke komitmen gabungan setelah dibuat. Untuk mempelajari lebih lanjut komitmen dengan pemesanan terlampir, lihat Melampirkan pemesanan ke komitmen berbasis resource.

Contoh komitmen gabungan

Tabel berikut menunjukkan properti sumber dan komitmen gabungan dalam skenario di mana dua komitmen (source-commitment-1 dan source-commitment-2) digabungkan menjadi satu komitmen (merged-commitment) pada March 1, 2022.

	Komitmen sumber pertama (sebelum penggabungan)	Komitmen sumber kedua (sebelum penggabungan)	Komitmen gabungan
Name	komitmen-sumber-1	komitmen-sumber-2	komitmen gabungan
Jenis	N2	N2	N2
Region	us-central-1	us-central-1	us-central-1
Resource	vCPU: 100 Memori: 100 GB	vCPU: 200 Memori: 300 GB	vCPU: 300 Memori: 400 GB
Masa Berlaku	3 tahun	3 tahun	3 tahun
Tanggal mulai^*	1 Januari 2020	1 Desember 2020	2 Maret 2022 (hari setelah penggabungan)
Tanggal akhir^†	1 Januari 2023	1 Desember 2023	1 Desember 2023
Periode kelayakan perpanjangan masa berlaku terbuka hingga	1 Mei 2020	1 April 2021	1 Mei 2020

^*Semua komitmen dimulai pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7) pada tanggal mulai yang ditentukan.
^†Semua komitmen berakhir pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7) pada tanggal akhir yang ditentukan.

Implikasi harga

Biaya komitmen adalah jumlah harga diskon dari semua alokasi resource Anda. Jika Anda menggabungkan komitmen, harga diskon untuk resource komitmen gabungan dapat berubah pada hari komitmen gabungan Anda aktif. Harga diskon baru untuk setiap resource ini tetap sama hingga akhir masa berlaku komitmen gabungan, meskipun harga on-demand berubah. Namun, jika Anda menggabungkan atau memisahkan komitmen ini lagi di masa mendatang, harga diskon resource dapat berubah lagi.

Batasan

• Anda tidak dapat menggabungkan komitmen lisensi.
• Pada saat membuat komitmen gabungan, Anda tidak dapat membuat pemesanan baru dan melampirkannya ke komitmen tersebut.
• Anda tidak dapat menggabungkan komitmen yang telah habis masa berlakunya atau dibatalkan.
• Secara default, saat Anda membuat komitmen gabungan, setelan perpanjangan otomatis akan dinonaktifkan pada komitmen baru meskipun semua komitmen sumber disetel untuk diperpanjang secara otomatis. Jika ingin komitmen gabungan diperpanjang secara otomatis, Anda harus mengaktifkan setelan perpanjangan otomatis pada komitmen tersebut secara manual. Anda dapat melakukannya pada saat pembuatan atau setelah pembuatan.

Persyaratan

Saat Anda menggabungkan komitmen sumber individu untuk membuat komitmen gabungan yang baru, komitmen sumber dan gabungan Anda harus memenuhi persyaratan berikut:

• Komitmen sumber harus memiliki project, region, durasi (atau masa berlaku), jenis komitmen, dan kategori komitmen yang sama.
• Komitmen gabungan yang baru harus memiliki project, region, durasi (atau masa berlaku), jenis komitmen, dan kategori komitmen yang sama dengan komitmen sumber. Namun, Anda dapat memilih nama baru untuk komitmen gabungan.
• Jenis resource yang ditentukan untuk komitmen gabungan harus sama persis dengan jenis resource yang ada dalam komitmen sumber. Selain itu, jumlah resource untuk setiap jenis resource dalam komitmen gabungan baru Anda harus sama dengan total jumlah resource untuk jenis resource tersebut di semua komitmen sumber. Misalnya, jika komitmen sumber pertama memiliki 100 vCPU dan 100 GB memori sedangkan komitmen sumber kedua memiliki 200 vCPU dan 300 GB memori, Anda harus membuat komitmen gabungan dengan 300 vCPU dan 400 GB memori.
• Komitmen sumber dan gabungan harus ditujukan untuk resource hardware (vCPU, memori, GPU, dan disk SSD Lokal).

Membuat komitmen gabungan

Buat komitmen gabungan menggunakan gcloud CLI atau Compute Engine API. Sebelum menggabungkan komitmen, tinjau batasan untuk penggabungan.

Izin yang diperlukan untuk langkah ini

Untuk menjalankan langkah ini, Anda harus memiliki izin berikut:

• compute.commitments.create di project atau organisasi.

Konsol

1. Di Konsol Google Cloud, pilih project tempat Anda ingin menggabungkan komitmen dan buka halaman Committed use discounts.

   Buka halaman Committed use discounts

2. Untuk memulai operasi penggabungan pada sekumpulan komitmen, di tab Hardware commitments di halaman Commitment list, klik Merge.

   Atau, Anda juga dapat memilih komitmen yang ingin digabungkan dari daftar, lalu mengklik Merge.

3. Pada tab Choose commitment di halaman Merge yang terbuka, lakukan hal berikut:

   1. Di bagian Choose commitments to merge, pilih komitmen yang ingin Anda gabungkan dari daftar. Jika Anda sudah memilih komitmen ini di halaman Commitment list, verifikasi komitmen yang Anda pilih di tab ini.

      Opsional: Anda juga dapat menentukan nilai Plan, Region, dan Commitment type yang diinginkan untuk komitmen gabungan Anda sebelum memilih komitmen individual yang akan digabungkan. Tindakan ini akan memfilter daftar komitmen agar hanya menampilkan komitmen yang dapat Anda gabungkan untuk atribut yang ditentukan.

   2. Klik Next. Tab Review akan terbuka.

4. Pada tab Review di halaman Merge, lakukan hal berikut:

   1. Tinjau dan konfirmasi detail komitmen gabungan. Untuk mengubah daftar komitmen individual yang ingin digabungkan, pilih tab Choose commitment di sisi kiri jendela, lalu ulangi langkah 3.
   2. Di kolom New commitment name, masukkan nama untuk komitmen gabungan Anda.
   3. Opsional: Untuk mengaktifkan perpanjangan otomatis di komitmen gabungan Anda, centang kotak Enable auto renew.
   4. Baca Terms and conditions.
   5. Untuk menyelesaikan pembuatan komitmen gabungan dan kembali ke halaman Commitment list, klik Merge.

gcloud

Untuk menggabungkan komitmen yang ada menjadi satu komitmen, gunakan perintah pembuatan komitmen komputasi gcloud dengan flag --merge-source-commitment.

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --merge-source-commitments=SOURCE_COMMITMENT_URLS

Ganti properti berikut:

• COMMITMENT_NAME: nama komitmen gabungan baru Anda.
• NUMBER_VCPUS: total jumlah vCPU dalam komitmen sumber.

• COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, salah satu dari pilihan berikut:

  • accelerator-optimized untuk resource jenis mesin A2
  • accelerator-optimized-a3 untuk resource jenis mesin A3 Edge dan High
  • accelerator-optimized-a3-mega untuk resource jenis mesin A3 Mega
  • compute-optimized untuk resource jenis mesin C2
  • compute-optimized-c2d untuk resource jenis mesin C2D
  • compute-optimized-c3 untuk resource jenis mesin C3
  • compute-optimized-c3d untuk resource jenis mesin C3D
  • compute-optimized-h3 untuk resource jenis mesin H3
  • general-purpose untuk resource jenis mesin N1
  • general-purpose-c4 untuk resource jenis mesin C4
  • general-purpose-c4a untuk resource jenis mesin C4A
  • general-purpose-e2 untuk resource jenis mesin E2
  • general-purpose-n2 untuk resource jenis mesin N2
  • general-purpose-n2d untuk resource mesin N2D
  • general-purpose-n4 untuk resource jenis mesin N4
  • general-purpose-t2d untuk resource jenis mesin Tau T2D
  • graphics-optimized untuk resource jenis mesin G2
  • memory-optimized untuk resource jenis mesin M1 atau M2
  • memory-optimized-m3 untuk resource jenis mesin M3
  • storage-optimized-z3 untuk resource jenis mesin Z3

• REGION: region yang sama dengan commit sumber Anda.

• PROJECT_ID: project ID dari project yang komitmennya ingin Anda gabungkan.

• DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, 12-month atau 36-month.

• MEMORY: total jumlah, dalam MB atau GB, memori dalam komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah GB.

• SOURCE_COMMITMENT_URLS: Tentukan daftar URL komitmen sumber yang berbeda, yang memisahkan setiap URL dengan koma. Jangan tambahkan spasi kosong di antara URL. Dalam daftar, Anda harus menentukan setidaknya dua URL komitmen sumber.

Misalnya, pertimbangkan dua komitmen sumber di region us-east1 dengan resource-nya masing-masing seperti (4 vCPU N2 dan 2048 MB) serta (3 vCPU N2 dan 2048 MB). Durasi setiap komitmen sumber adalah 12 bulan. Perintah gcloud CLI berikut menggabungkan kedua komitmen dan membuat komitmen baru yang disebut merged-commitment, dengan resource-nya yang terdiri dari 7 vCPU N2 dan 4.096 MB dengan durasi 12 bulan:

gcloud compute commitments create merged-commitment \
    --plan=12-month \
    --project=myproject \
    --region=us-east1 \
    --type=general-purpose-n2 \
    --resources=vcpu=7,memory=4096MB \
     --merge-source-commitments=projects/myproject/regions/us-central1/commitments/source-commitment-1,projects/myproject/regions/us-central1/commitments/source-commitment-2

API

Untuk menggabungkan komitmen yang ada menjadi satu komitmen, gunakan metode regionCommitments.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
  "name": COMMITMENT_NAME,
  "plan": DURATION,
  "type": COMMITMENT_TYPE,
  "region": REGION,
  "resources": [
    {
      "type": "vCPUs",
      "amount": NUMBER_VCPUS
    }
    {
      "type": "MEMORY",
      "amount": MEMORY
    }
  ],
  "mergeSourceCommitments": [SOURCE_COMMITMENT_URL ...]
}

Ganti properti berikut:

• PROJECT_ID: project ID dari project yang komitmennya ingin Anda gabungkan.
• REGION: region yang sama dengan commit sumber Anda.

• COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, salah satu dari pilihan berikut:

  • ACCELERATOR_OPTIMIZED untuk resource jenis mesin A2
  • ACCELERATOR_OPTIMIZED_A3 untuk resource jenis mesin A3 Edge dan High
  • ACCELERATOR_OPTIMIZED_A3_MEGA untuk resource jenis mesin A3 Mega
  • COMPUTE_OPTIMIZED untuk resource jenis mesin C2
  • COMPUTE_OPTIMIZED_C2D untuk resource jenis mesin C2D
  • COMPUTE_OPTIMIZED_C3 untuk resource jenis mesin C3
  • COMPUTE_OPTIMIZED_C3D untuk resource jenis mesin C3D
  • COMPUTE_OPTIMIZED_H3 untuk resource jenis mesin H3
  • GENERAL_PURPOSE untuk resource jenis mesin N1
  • GENERAL_PURPOSE_C4 untuk resource jenis mesin C4
  • GENERAL_PURPOSE_C4A untuk resource jenis mesin C4A
  • GENERAL_PURPOSE_E2 untuk resource jenis mesin E2
  • GENERAL_PURPOSE_N2 untuk resource jenis mesin N2
  • GENERAL_PURPOSE_N2D untuk resource mesin N2D
  • GENERAL_PURPOSE_N4 untuk resource jenis mesin N4
  • GENERAL_PURPOSE_T2D untuk resource jenis mesin Tau T2D
  • GRAPHICS_OPTIMIZED untuk resource jenis mesin G2
  • MEMORY_OPTIMIZED untuk resource jenis mesin M1 atau M2
  • MEMORY_OPTIMIZED_M3 untuk resource jenis mesin M3
  • STORAGE_OPTIMIZED_Z3 untuk resource jenis mesin Z3

• DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, TWELVE_MONTH atau THIRTY_SIX_MONTH.

• COMMITMENT_NAME: nama komitmen gabungan baru Anda.

• NUMBER_VCPUS: total jumlah vCPU dalam komitmen sumber.

• MEMORY: total jumlah, dalam MB, memori di komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah MB.

• SOURCE_COMMITMENT_URL: URL komitmen sumber yang ingin Anda gabungkan. Anda harus menentukan daftar yang dipisahkan koma untuk URL komitmen sumber yang berbeda.

Misalnya, pertimbangkan dua komitmen sumber (source-commitment-1 dan source-commitment-2) di region us-east1 dengan resource-nya masing-masing seperti (4 vCPU N2 dan 2048 MB) serta (3 vCPU N2 dan 2048 MB). Permintaan POST berikut menggabungkan source-commitment-1 dan source-commitment-2 menjadi satu komitmen yang disebut merged-commitment:

POST https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments
{
  "name": "merged-commitment",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE_N2",
  "region": "us-east1",
   "resources": [
    {
      "type": "VCPU",
      "amount": "7"
    }
    {
      "type": "MEMORY",
      "amount": "4096"
    }
  ],
  "mergeSourceCommitments": [
         "projects/myproject/regions/us-central1/commitments/source-commitment-1",
         "projects/myproject/regions/us-central1/commitments/source-commitment-2",
         ...
    ]
}

Memisahkan komitmen

Anda dapat mentransfer resource dari komitmen yang ada dan memisahkan komitmen menjadi komitmen yang lebih kecil. Dengan pemisahan, Anda dapat memantau dan mengelola bagian dari satu komitmen besar dalam bentuk komitmen individu yang lebih kecil secara lebih cermat. Misalnya, Anda hanya dapat menetapkan sebagian komitmen untuk diperpanjang otomatis dengan memisahkannya dan mengaktifkan perpanjangan otomatis hanya untuk salah satu komitmen turunan. Dengan pemisahan, Anda juga dapat mendistribusikan diskon abonemen pada tingkat yang lebih terperinci dengan menggunakan atribusi prioritas untuk komitmen terpisah.

Perhatian: Saat Anda memisahkan komitmen, semua aturan atribusi prioritas yang terkait dengan komitmen tersebut akan dihapus dan tidak dapat dipulihkan. Jika ingin terus menggunakan aturan atribusi yang diprioritaskan pada komitmen terpisah, Anda harus membuat ulang aturan tersebut setelah operasi masing-masing.

Cara kerja pemisahan

Saat memisahkan komitmen yang ada (komitmen sumber), Anda mentransfer resource dari komitmen sumber Anda, membuat satu atau beberapa komitmen baru (komitmen terpisah), dan mendistribusikan ulang resource yang ditransfer ke komitmen terpisah baru tersebut. Aktivasi komitmen terpisah baru dan perubahan ukuran komitmen sumber dilakukan pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8, atau UTC-7 selama waktu musim panas) pada hari berikutnya. Compute Engine menetapkan tanggal aktivasi ini sebagai tanggal mulai untuk komitmen terpisah. Setelah menyelesaikan operasi pemisahan, Anda memiliki komitmen berikut:

• Komitmen sumber yang diubah ukurannya dengan resource yang tetap ada setelah pemisahan.
• Komitmen terpisah yang baru dibuat dengan resource yang didistribusikan ulang.

Komitmen sumber, meskipun diubah ukurannya, mempertahankan semua atribut lain, termasuk tanggal mulai dan akhir, serta terus beroperasi seperti biasa. Komitmen terpisah mempertahankan tanggal akhir dan periode kelayakan perpanjangan masa berlaku yang sama dengan komitmen sumber.

Anda hanya dapat membuat satu komitmen terpisah baru pada satu waktu menggunakan Compute Engine API dan gcloud CLI. Anda dapat membuat beberapa komitmen terpisah baru dalam satu operasi menggunakan Konsol Google Cloud.

Anda tidak dapat memisahkan komitmen jika memiliki pemesanan yang terlampir. Untuk mempelajari lebih lanjut komitmen dengan pemesanan terlampir, lihat Menggabungkan pemesanan dengan diskon abonemen.

Contoh komitmen terpisah

Tabel berikut menunjukkan properti komitmen saat komitmen yang ada (source-commitment) dipisah menjadi dua komitmen yang berbeda (source-commitment dan split-commitment yang diubah ukurannya) pada 1 Maret 2022:

	Komitmen sumber (sebelum pemisahan)	Komitmen terpisah	Komitmen sumber (setelah pemisahan)
Nama	komitmen-sumber	komitmen-terpisah	komitmen-sumber
Jenis	N2	N2	N2
Region	us-central-1	us-central-1	us-central-1
Resource	vCPU: 200 Memori: 200 GB	vCPU: 50 Memori: 100 GB	vCPU: 150 Memori: 100 GB
Masa Berlaku	3 tahun	3 tahun	3 tahun
Tanggal mulai^*	1 Januari 2020	2 Maret 2022 (hari setelah pemisahan)	1 Januari 2020
Tanggal akhir^†	1 Januari 2023	1 Januari 2023	1 Januari 2023
Periode kelayakan perpanjangan masa berlaku terbuka hingga	1 Januari 2021	1 Januari 2021	1 Januari 2021

^*Semua komitmen dimulai pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7) pada tanggal mulai yang ditentukan.
^†Semua komitmen berakhir pukul 00.00 Waktu Pasifik AS dan Kanada (UTC-8 atau UTC-7) pada tanggal akhir yang ditentukan.

Implikasi harga

Biaya komitmen adalah jumlah harga diskon dari semua alokasi resource Anda. Memisahkan komitmen akan memengaruhi biaya resource Anda dengan cara berikut:

• Komitmen sumber yang diubah ukurannya: Harga diskon resource dari komitmen sumber yang diubah ukurannya tetap sama.
• Komitmen terpisah: Harga diskon resource komitmen terpisah Anda dapat berubah pada hari komitmen terpisah Anda aktif. Harga diskon baru untuk setiap resource ini tetap sama hingga akhir masa berlaku komitmen terpisah, meskipun harga on-demand berubah.

Namun, jika Anda menggabungkan atau memisahkan salah satu komitmen ini lagi di masa mendatang, harga diskon dapat berubah lagi.

Batasan

• Anda tidak dapat memisahkan komitmen lisensi.
• Anda tidak dapat memisahkan komitmen yang memiliki lampiran pemesanan. Oleh karena itu, Anda tidak dapat memisahkan komitmen yang memiliki GPU, disk SSD Lokal, atau keduanya, karena komitmen dengan resource ini selalu memiliki pemesanan yang terlampir.
• Pada saat membuat komitmen terpisah, Anda tidak dapat membuat pemesanan baru dan melampirkannya ke komitmen tersebut.
• Anda tidak dapat memisahkan komitmen yang telah habis masa berlakunya atau dibatalkan.
• Secara default, saat Anda membuat komitmen terpisah, setelan perpanjangan otomatis akan dinonaktifkan pada komitmen baru meskipun semua komitmen sumber disetel untuk diperpanjang secara otomatis. Jika ingin komitmen terpisah diperpanjang secara otomatis, Anda harus mengaktifkan setelan perpanjangan otomatis pada komitmen tersebut secara manual. Anda dapat melakukannya pada saat pembuatan atau setelah pembuatan.
• Anda hanya dapat membuat satu komitmen terpisah baru pada satu waktu menggunakan Compute Engine API atau gcloud CLI.

Persyaratan

Jika Anda memisahkan komitmen sumber dan membuat satu atau beberapa komitmen terpisah, komitmen sumber dan komitmen terpisah Anda harus memenuhi persyaratan berikut:

• Komitmen terpisah baru harus memiliki project, jenis komitmen, region, dan durasi (atau masa berlaku) yang sama dengan komitmen sumber. Namun, Anda harus memilih nama baru untuk komitmen terpisah.
• Jenis resource yang ditentukan untuk komitmen terpisah baru harus sama persis dengan beberapa atau semua jenis resource di komitmen sumber. Selain itu, jumlah gabungan resource yang Anda tentukan untuk komitmen terpisah baru harus merupakan bagian dari resource dalam komitmen sumber. Anda harus mempertahankan sebagian resource dalam komitmen sumber. Misalnya, anggap saja komitmen sumber Anda adalah untuk 200 vCPU dan 300 GB memori, skenario pengubahan ukuran dan distribusi ulang berikut berlaku:
  • Anda dapat mendistribusikan ulang sebagian dari 200 vCPU dan sebagian dari 300 GB memori ke komitmen terpisah baru.
  • Anda dapat mendistribusikan ulang 200 vCPU seluruhnya, tetapi Anda harus mempertahankan sebagian memori dalam komitmen sumber Anda.
  • Anda dapat mendistribusikan ulang 300 GB memori seluruhnya, tetapi Anda harus mempertahankan sebagian vCPU dalam komitmen sumber Anda.
  • Anda tidak dapat mendistribusikan ulang 200 vCPU dan 300 GB memori seluruhnya ke komitmen terpisah baru
• Komitmen sumber dan terpisah harus ditujukan untuk resource hardware yang berupa vCPU, memori, atau kombinasi keduanya.

Selain itu, untuk menggunakan Google Cloud CLI guna memisahkan komitmen sumber, update Google Cloud CLI ke versi 423.0.0 atau yang lebih baru. Jika Anda mencoba memisahkan komitmen sumber menggunakan versi gcloud CLI sebelumnya, operasi pemisahan akan gagal dan Compute Engine akan menampilkan error.

Membuat komitmen terpisah

Buat satu komitmen terpisah baru dalam satu waktu menggunakan gcloud CLI atau Compute Engine API. Buat beberapa komitmen terpisah baru sekaligus menggunakan Konsol Google Cloud. Sebelum Anda memisahkan komitmen, tinjau batasan untuk pemisahan.

Izin yang diperlukan untuk langkah ini

Untuk menjalankan langkah ini, Anda harus memiliki izin berikut:

• compute.commitments.create di project atau organisasi.

Konsol

1. Di Konsol Google Cloud, pilih project tempat Anda ingin memisahkan komitmen dan buka halaman Committed use discounts.

   Buka halaman Committed use discounts

2. Untuk memulai operasi pemisahan pada komitmen, lakukan salah satu hal berikut di tab Hardware commitments di halaman Commitment list:

   • Dari daftar, pilih komitmen yang ingin dipisahkan, lalu klik Split.
   • Di kolom Name, klik nama komitmen yang ingin dipisahkan. Pada halaman Hardware commitment details yang terbuka, klik Split.

3. Pada tab Resize di halaman Split commitment yang terbuka, lakukan tindakan berikut:

   1. Di kolom vCPUs dan Memory, tentukan jumlah vCPU dan memori yang ingin dipertahankan dalam komitmen awal Anda. Resource yang tersisa dapat didistribusikan ulang ke komitmen terpisah Anda. Resource untuk komitmen sumber tidak boleh kosong setelah Anda mengubah ukurannya.
   2. Klik Next. Tab Redistribute akan terbuka.

4. Pada tab Redistribute di halaman Split commitment, lakukan hal berikut:

   1. Di kolom Name, tentukan nama untuk komitmen terpisah Anda.
   2. Di kolom vCPUs dan Memory, tentukan jumlah vCPU dan memori yang diinginkan dalam komitmen terpisah Anda.
      • Jika Anda ingin membuat beberapa komitmen terpisah, tentukan sebagian saja dari resource yang didistribusikan ulang.
      • Jika tidak, tentukan semua resource yang didistribusikan ulang.
   3. Opsional: Untuk mengaktifkan perpanjangan otomatis di komitmen terpisah Anda, centang kotak Enable auto renew.
   4. Klik Done.
   5. Opsional: Untuk membuat komitmen terpisah tambahan, klik Add an item, lalu ulangi langkah-langkah sebelumnya.
   6. Klik Next. Tab Review akan terbuka.

5. Pada tab Review di halaman Split commitment, lakukan hal berikut:

   1. Tinjau dan konfirmasi detail komitmen yang diubah ukurannya dan komitmen terpisah.
      • Untuk mengubah alokasi resource dari komitmen awal, pilih tab Resize di sisi kiri jendela, lalu ulangi langkah 3.
      • Untuk mengubah distribusi ulang resource di komitmen terpisah, pilih tab Redistribute di sisi kiri jendela, lalu ulangi langkah 4.
   2. Baca Terms and conditions.
   3. Untuk menyelesaikan pembuatan komitmen terpisah dan kembali ke halaman Commitment list, klik Submit.

gcloud

Penting: Untuk menggunakan Google Cloud CLI guna memisahkan komitmen sumber, update Google Cloud CLI ke versi 423.0.0 atau yang lebih baru. Jika Anda mencoba memisahkan komitmen sumber menggunakan versi gcloud CLI sebelumnya, operasi pemisahan akan gagal dan Compute Engine akan menampilkan error.

Untuk memisahkan komitmen yang ada menjadi dua komitmen, gunakan perintah pembuatan komitmen komputasi gcloud dengan flag --split-source-commitment.

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --split-source-commitment=SOURCE_COMMITMENT_URL

Ganti properti berikut:

• COMMITMENT_NAME: nama komitmen terpisah baru Anda.

• COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, salah satu dari pilihan berikut:

  • accelerator-optimized untuk resource jenis mesin A2
  • accelerator-optimized-a3 untuk resource jenis mesin A3 Edge dan High
  • accelerator-optimized-a3-mega untuk resource jenis mesin A3 Mega
  • compute-optimized untuk resource jenis mesin C2
  • compute-optimized-c2d untuk resource jenis mesin C2D
  • compute-optimized-c3 untuk resource jenis mesin C3
  • compute-optimized-c3d untuk resource jenis mesin C3D
  • compute-optimized-h3 untuk resource jenis mesin H3
  • general-purpose untuk resource jenis mesin N1
  • general-purpose-c4 untuk resource jenis mesin C4
  • general-purpose-c4a untuk resource jenis mesin C4A
  • general-purpose-e2 untuk resource jenis mesin E2
  • general-purpose-n2 untuk resource jenis mesin N2
  • general-purpose-n2d untuk resource mesin N2D
  • general-purpose-n4 untuk resource jenis mesin N4
  • general-purpose-t2d untuk resource jenis mesin Tau T2D
  • graphics-optimized untuk resource jenis mesin G2
  • memory-optimized untuk resource jenis mesin M1 atau M2
  • memory-optimized-m3 untuk resource jenis mesin M3
  • storage-optimized-z3 untuk resource jenis mesin Z3

• REGION: region yang sama dengan komitmen sumber Anda.

• PROJECT_ID: project ID dari project yang komitmen sumbernya ingin Anda pisahkan.

• DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, 12-month atau 36-month.

• NUMBER_VCPUS: jumlah vCPU yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Jumlahnya harus berupa bilangan bulat yang lebih kecil dari jumlah vCPU dalam komitmen sumber.

• MEMORY: jumlah memori, dalam MB atau GB, yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Jumlahnya harus lebih kecil dari jumlah memori dalam komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah GB. Memori dapat dibeli dengan kelipatan 0,25 GB.

• SOURCE_COMMITMENT_URL: URL komitmen sumber tempat Anda ingin mengambil resource.

Misalnya, pertimbangkan komitmen sumber (source-commitment) di region us-east1 dengan 3 vCPU N2 dan memori 2048 MB. Perintah gcloud CLI berikut membagi komitmen dengan melakukan hal berikut:

• Mengambil resource dari source-commitment dan membuat komitmen baru split-commitment dengan 1 vCPU N2 dan memori 1.024 MB.
• Mengubah ukuran source-commitment ke resource yang tersisa.

gcloud compute commitments create split-commitment \
    --plan=12-month \
    --type=general-purpose-n2 \
    --region=us-east1 \
    --project=myproject \
    --resources vcpu=1,memory=1024MB \
    --split-source-commitment=projects/myproject/regions/us-central1/commitments/source-commitment

API

Untuk memisahkan komitmen yang ada menjadi dua komitmen, gunakan metode regionCommitments.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
  "name": COMMITMENT_NAME,
  "plan": DURATION,
  "type": COMMITMENT_TYPE,
  "region": REGION,
  "resources": [
    {
      "type": "vCPUs",
      "amount": NUMBER_VCPUS
    }
    {
      "type": "MEMORY",
      "amount": MEMORY
    }
  ],
  "splitSourceCommitment": SOURCE_COMMITMENT_URL
}

Ganti properti berikut:

• PROJECT_ID: project ID dari project yang komitmen sumbernya ingin Anda pisahkan.
• REGION: region yang sama dengan komitmen sumber Anda.
• COMMITMENT_NAME: nama komitmen terpisah baru Anda.

• COMMITMENT_TYPE: jenis komitmen yang sama dengan komitmen sumber Anda, salah satu dari pilihan berikut:

  • ACCELERATOR_OPTIMIZED untuk resource jenis mesin A2
  • ACCELERATOR_OPTIMIZED_A3 untuk resource jenis mesin A3 Edge dan High
  • ACCELERATOR_OPTIMIZED_A3_MEGA untuk resource jenis mesin A3 Mega
  • COMPUTE_OPTIMIZED untuk resource jenis mesin C2
  • COMPUTE_OPTIMIZED_C2D untuk resource jenis mesin C2D
  • COMPUTE_OPTIMIZED_C3 untuk resource jenis mesin C3
  • COMPUTE_OPTIMIZED_C3D untuk resource jenis mesin C3D
  • COMPUTE_OPTIMIZED_H3 untuk resource jenis mesin H3
  • GENERAL_PURPOSE untuk resource jenis mesin N1
  • GENERAL_PURPOSE_C4 untuk resource jenis mesin C4
  • GENERAL_PURPOSE_C4A untuk resource jenis mesin C4A
  • GENERAL_PURPOSE_E2 untuk resource jenis mesin E2
  • GENERAL_PURPOSE_N2 untuk resource jenis mesin N2
  • GENERAL_PURPOSE_N2D untuk resource mesin N2D
  • GENERAL_PURPOSE_N4 untuk resource jenis mesin N4
  • GENERAL_PURPOSE_T2D untuk resource jenis mesin Tau T2D
  • GRAPHICS_OPTIMIZED untuk resource jenis mesin G2
  • MEMORY_OPTIMIZED untuk resource jenis mesin M1 atau M2
  • MEMORY_OPTIMIZED_M3 untuk resource jenis mesin M3
  • STORAGE_OPTIMIZED_Z3 untuk resource jenis mesin Z3

• DURATION: durasi (atau masa berlaku) yang sama dengan komitmen sumber Anda, TWELVE_MONTH atau THIRTY_SIX_MONTH.

• NUMBER_VCPUS: jumlah vCPU yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Jumlahnya harus berupa bilangan bulat yang lebih kecil dari jumlah vCPU dalam komitmen sumber.

• MEMORY: jumlah memori, dalam MB, yang ingin Anda transfer keluar dari komitmen sumber untuk membuat komitmen terpisah baru. Jumlahnya harus lebih kecil dari jumlah memori dalam komitmen sumber. Misalnya, 1.000 MB. Jika unit tidak ditentukan, unit default yang digunakan adalah MB. Memori dapat dibeli dengan kelipatan 0,25 GB.

• SOURCE_COMMITMENT_URL: URL komitmen sumber tempat Anda ingin mentransfer resource.

Misalnya, pertimbangkan komitmen sumber (source-commitment) di region us-east1 dengan 3 vCPU N2 dan memori 2048 MB. Permintaan POST berikut membagi komitmen dengan melakukan hal berikut:

• Mengambil resource dari source-commitment dan membuat komitmen baru split-commitment dengan 1 vCPU N2 dan memori 1.024 MB.
• Mengubah ukuran source-commitment ke resource yang tersisa.

POST https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments
{
  "name": "split-commitment",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE_N2",
  "region": "us-east1",
  "resources": [
    {
      "type": "VCPU",
      "amount": "1"
    }
    {
      "type": "MEMORY",
      "amount": "1024"
    }
  ],
  "splitSourceCommitment": "projects/myproject/regions/us-central1/commitments/source-commitment"
}

Langkah selanjutnya

• Pelajari cara memperpanjang komitmen berbasis resource secara otomatis.
• Pelajari cara memperpanjang jangka waktu komitmen berbasis resource.
• Pelajari cara mengupgrade jangka waktu komitmen berbasis resource.
• Pelajari cara menganalisis efektivitas diskon abonemen berbasis resource.