Melihat komitmen berbasis resource

Compute Engine memungkinkan Anda melihat daftar semua komitmen berbasis resource yang Anda beli atau mengambil properti mendetail dari komitmen tertentu.

Anda dapat melihat komitmen ini menggunakan konsol Google Cloud , gcloud CLI, atau REST.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init
  • Tetapkan region dan zona default.

    • REST

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

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk melihat komitmen berbasis resource, minta administrator untuk memberi Anda peran IAM Compute Viewer (roles/compute.viewer) atau Compute Admin (roles/compute.admin) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin compute.commitments.get dan compute.commitments.list, yang diperlukan untuk melihat komitmen berbasis resource.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Melihat daftar komitmen

Anda dapat melihat daftar semua komitmen dalam project menggunakan konsolGoogle Cloud , gcloud CLI, atau REST.

Konsol

  1. Di konsol Google Cloud , buka halaman Committed use discounts. Buka halaman Diskon abonemen

  2. Untuk melihat daftar komitmen untuk kategori tertentu, pilih salah satu tab berikut:

    • Hardware commitments: Pilih tab ini untuk melihat komitmen untuk resource hardware, seperti vCPU, memori, GPU, disk SSD Lokal, dan sole-tenant node.
    • Komitmen lisensi software: Pilih tab ini untuk melihat komitmen lisensi OS.
    • Komitmen penyimpanan blok: Pilih tab ini untuk melihat komitmen kapasitas Exapool.

gcloud

Untuk mencantumkan semua komitmen di region tertentu, gunakan perintah gcloud compute commitments list:

gcloud compute commitments list \
    --regions=REGION \
    --project=PROJECT_ID

Ganti kode berikut:

  • REGION: region yang komitmennya ingin Anda lihat.
  • PROJECT_ID: project ID.

Contoh

Misalnya, untuk mencantumkan komitmen dalam region us-central1 menggunakan project project-list-example, jalankan perintah berikut:

gcloud compute commitments list \
    --regions=us-central1 \
    --project=project-list-example

REST

Untuk mencantumkan komitmen di region tertentu, buat permintaan GET ke metode regionCommitments.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

Untuk mencantumkan komitmen di semua region dalam project Anda, buat permintaan GET ke metode regionCommitments.aggregatedList:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments

Ganti kode berikut:

  • PROJECT_ID: project ID untuk project yang ingin Anda lihat komitmennya.
  • REGION: region tempat Anda ingin melihat komitmen.

Melihat detail komitmen tertentu

Anda dapat melihat properti mendetail dari komitmen, seperti berikut:

  • Status
  • Paket komitmen
  • Waktu mulai dan berakhir komitmen
  • Setelan perpanjangan otomatis
  • Jenis dan jumlah resource yang di-commit

Anda dapat melihat komitmen menggunakan konsol Google Cloud , gcloud CLI, atau REST.

Konsol

  1. Di konsol Google Cloud , buka halaman Committed use discounts. Buka halaman Diskon abonemen

  2. Pilih tab untuk kategori komitmen yang ingin Anda lihat:

    • Untuk melihat komitmen resource hardware, klik tab Hardware commitments. Komitmen hardware mencakup vCPU, memori, GPU, disk SSD Lokal, dan sole-tenant node.
    • Untuk melihat komitmen lisensi software premium, pilih tab Software license commitments. Komitmen lisensi mencakup lisensi sistem operasi (OS), seperti SUSE Linux Enterprise Server (SLES), SLES untuk SAP, atau Red Hat Enterprise Linux (RHEL).
    • Untuk melihat komitmen untuk storage pool yang terpasang ke jaringan, pilih tab Block storage commitments. Komitmen block storage mencakup kapasitas Exapool.

  3. Untuk melihat halaman detail komitmen, klik nama komitmen.

gcloud

Untuk mendeskripsikan komitmen tertentu, gunakan perintah gcloud compute commitments describe:

gcloud compute commitments describe COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID

Ganti kode berikut:

  • COMMITMENT_NAME: nama komitmen Anda.
  • REGION: region tempat komitmen berada.
  • PROJECT_ID: project ID.

Contoh

Contoh berikut menjelaskan komitmen dalam project myproject dan region us-central1.

Contoh 1: Menjelaskan komitmen hardware

Untuk mendeskripsikan komitmen hardware yang ada (example-hardware-commitment), jalankan perintah berikut:

gcloud compute commitments describe example-hardware-commitment \
    --region=us-central1 \
    --project=myproject

Perintah ini menampilkan properti komitmen Anda, mirip dengan berikut ini:

autoRenew: true
category: MACHINE
creationTimestamp: '2025-05-15T09:30:00.000-07:00'
endTimestamp: '2026-05-15T09:30:00.000-07:00'
kind: compute#commitment
name: example-hardware-commitment
plan: TWELVE_MONTH
region: https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1
resources:
- amount: '4'
  type: VCPU
- amount: '16384'
  type: MEMORY
status: ACTIVE
type: GENERAL_PURPOSE

Contoh 2: Menjelaskan komitmen penyimpanan blok

Untuk mendeskripsikan komitmen block storage yang ada (example-block-storage-commitment), jalankan perintah gcloud beta compute commitments describe:

gcloud beta compute commitments describe example-block-storage-commitment \
    --region=us-central1 \
    --project=myproject

Perintah ini menampilkan properti komitmen Anda, yang menetapkan hubungan komitmen dengan Exapool, mirip dengan berikut ini:

autoRenew: true
category: PERSISTENT_DISK
creationTimestamp: '2025-08-20T14:45:00.000-07:00'
endTimestamp: '2026-08-20T14:45:00.000-07:00'
kind: compute#commitment
name: example-block-storage-commitment
persistentDiskResources:
- amount: '102400'
  dimensionType: CAPACITY_OPTIMIZED
  productType: HYPERDISK_EXAPOOL_BALANCED
plan: TWELVE_MONTH
region: https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1
status: ACTIVE

REST

Buat permintaan GET ke metode regionCommitments.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME

Ganti kode berikut:

  • PROJECT_ID: Project ID milik Anda.
  • REGION: region tempat komitmen dibeli.
  • COMMITMENT_NAME: nama komitmen Anda.

Contoh

Contoh berikut mengambil detail komitmen dalam project myproject dan region us-central1.

Contoh 1: Menjelaskan komitmen hardware

Untuk mengambil properti komitmen hardware (example-hardware-commitment), buat permintaan GET berikut:

GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment

Responsnya berisi properti komitmen hardware Anda, yang mirip dengan output berikut:

{
  "autoRenew": true,
  "category": "MACHINE",
  "creationTimestamp": "2025-05-15T09:30:00.000-07:00",
  "endTimestamp": "2026-05-15T09:30:00.000-07:00",
  "kind": "compute#commitment",
  "name": "example-hardware-commitment",
  "plan": "TWELVE_MONTH",
  "region": "https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1",
  "resources": [
    {
      "amount": "4",
      "type": "VCPU"
    },
    {
      "amount": "16384",
      "type": "MEMORY"
    }
  ],
  "status": "ACTIVE",
  "type": "GENERAL_PURPOSE"
}

Contoh 2: Menjelaskan komitmen penyimpanan blok

Untuk mengambil properti komitmen block storage (example-block-storage-commitment), buat permintaan GET berikut ke metode beta regionCommitments.get:

GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment

Respons berisi properti yang mewakili kapasitas komitmen block storage Anda, mirip dengan output JSON berikut:

{
  "autoRenew": true,
  "category": "PERSISTENT_DISK",
  "creationTimestamp": "2025-08-20T14:45:00.000-07:00",
  "endTimestamp": "2026-08-20T14:45:00.000-07:00",
  "kind": "compute#commitment",
  "name": "example-block-storage-commitment",
  "persistentDiskResources": [
    {
      "amount": "102400",
      "dimensionType": "CAPACITY_OPTIMIZED",
      "productType": "HYPERDISK_EXAPOOL_BALANCED"
    }
  ],
  "plan": "TWELVE_MONTH",
  "region": "https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1",
  "status": "ACTIVE"
}