Membeli Penawaran komitmen menggunakan Cloud Commerce Consumer Procurement API

Saat ini, hanya komitmen berbasis pengeluaran untuk produk tertentu yang dapat dibeli melalui API. Petunjuk ini menjelaskan cara membeli komitmen berbasis pembelanjaan.

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 digunakan untuk membeli komitmen:

  • Billing Administrator (roles/billing.admin) untuk akun Penagihan Cloud target ATAU organisasi Google Cloud tempat akun penagihan Anda berada.

  • Administrator Pesanan Pengadaan Konsumen (roles/consumerprocurement.orderAdmin) untuk akun Penagihan Cloud target ATAU organisasi Google Cloud tempat akun penagihan Anda berada.

Identifikasi Penawaran yang ingin Anda beli

Untuk membeli komitmen berbasis pembelanjaan, Anda menggunakan nama Penawaran yang menunjukkan produk yang Anda beli beserta jangka waktu diskonnya.

Penawaran berikut tersedia untuk dibeli:

Mengidentifikasi parameter Offer

Komitmen memiliki dua parameter:

• Jumlah komitmen (hourly_commit): Kredit yang diterapkan ke akun Penagihan Cloud Anda setiap jam setelah Anda membeli komitmen ini.
• Region (region): Wilayah tempat kredit komitmen ini berlaku.

Saat membeli komitmen, Anda harus menentukan kedua parameter.

Produk memiliki nilai dan batasan tertentu untuk parameternya. Misalnya, jika ingin membeli VMWare Engine, Anda dapat melihat nilai dan batasan berikut:

Beli Penawaran

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

• hourly_commit yang menunjukkan nilai dolar komitmen.

• region untuk 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

Tindakan ini akan 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.

Lihat Pesanan Anda

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

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'