Menggunakan API untuk membeli komitmen berbasis pembelanjaan

Dokumen ini menjelaskan cara membeli komitmen berbasis pembelanjaan menggunakan Cloud Commerce Consumer Procurement API untuk pembelian Cloud Marketplace.

API ini hanya mendukung pembelian komitmen berbasis pengeluaran, bukan komitmen berbasis resource.

Sebelum memulai

Aktifkan Cloud Commerce Consumer Procurement API untuk project Google Cloud Anda.
Pastikan Anda memiliki salah satu peran Identity and Access Management (IAM) berikut untuk akun Penagihan Cloud yang ingin Anda gunakan untuk membeli komitmen:
- Billing Administrator (roles/billing.admin) untuk akun Penagihan Cloud target ATAU Google Cloud organisasi tempat akun penagihan Anda berada.
- Consumer Procurement Order Administrator (roles/consumerprocurement.orderAdmin) untuk akun Penagihan Cloud target ATAU Google Cloud organisasi tempat akun penagihan Anda berada.

Identifikasi Penawaran yang ingin Anda beli

Untuk membeli komitmen berbasis pembelanjaan, gunakan Nama penawaran yang menunjukkan produk yang Anda beli dan jangka waktu diskon.

Model CUD baru memperkenalkan nama Penawaran baru untuk produk CUD yang ada. Tabel berikut mencantumkan Nama penawaran sebelum dan setelah migrasi ke model CUD berbasis pembelanjaan baru. Anda harus menggunakan nama Penawaran yang cocok dengan model akun Penagihan Cloud Anda.

Penawaran yang diperbarui berikut tersedia untuk dibeli:

Penawaran berikut tidak terpengaruh oleh model CUD baru dan tersedia untuk dibeli:

Produk	Istilah	Nama penawaran
Pencadangan untuk GKE	1 tahun	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Pencadangan untuk GKE	3 tahun	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
Backup and DR (VMWare)	1 tahun	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
Backup and DR (VMWare)	3 tahun	`services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48`
NetApp Volumes	1 tahun	`services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca`
NetApp Volumes	3 tahun	`services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c`

Mengidentifikasi parameter Penawaran

Komitmen memiliki dua parameter:

Jumlah komitmen (hourly_commit): Kredit yang diterapkan ke akun Penagihan Cloud Anda setiap jam setelah Anda membeli komitmen ini.
Dalam program DA lama sebelum migrasi akun otomatis, jumlah komitmen Anda adalah harga on-demand. Untuk mengetahui informasi selengkapnya, lihat DA berbasis pembelanjaan.
Region (region): Region tempat manfaat komitmen ini berlaku.

Saat membeli komitmen, Anda harus menentukan kedua parameter.

Membeli Penawaran

Untuk membeli Penawaran, panggil billingAccounts.orders.place, dan berikan parameter berikut:

hourly_commit yang menunjukkan nilai dolar komitmen.
region yang akan membeli komitmen.

Untuk melakukan pemesanan, jalankan perintah berikut:

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/billingAccounts/BILLING_ACCOUNT_ID/orders:place' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID' \
    -d '@-' <<EOF
    {
    "displayName": "DISPLAY_NAME",
    "lineItemInfo": [{
        "parameters": [{
        "name": "hourly_commit",
        "value": {
            "doubleValue": HOURLY_COMMIT
        }
        }, {
        "name": "region",
        "value": {
            "stringValue": "REGION"
        }
        }],
        "offer": "OFFER_NAME"
    }]
    }
EOF

Perintah ini menampilkan nama operasi yang berjalan lama:

{
    "name": "OPERATION_NAME"
}

Untuk memverifikasi bahwa operasi yang berjalan lama yang ditampilkan berhasil diselesaikan, jalankan perintah berikut:

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/OPERATION_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

Operasi yang berjalan lama akan selesai dalam waktu kurang dari satu detik.

Melihat Pesanan Anda

Anda dapat melihat status komitmen saat ini langsung di konsol Google Cloud , atau dengan memanggil billingAccounts.orders.get. Kolom name dari Pesanan yang dibuat menentukan nama Pesanan.

cURL

Untuk melihat pesanan, jalankan perintah berikut:

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/ORDER_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

Konsol

Di konsol Google Cloud , buka akun Penagihan Cloud Anda.

Buka akun Penagihan Cloud Anda
Pilih Diskon abonemen (CUD) dari sidebar.
Komitmen yang Anda beli akan ditampilkan.