Menggunakan API untuk membeli komitmen berbasis pembelanjaan

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

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

Sebelum memulai

Mengidentifikasi Penawaran yang ingin Anda beli

Untuk membeli komitmen berbasis pengeluaran, gunakan Nama penawaran yang menunjukkan produk yang Anda beli dan jangka waktu diskon. Anda harus menggunakan Nama penawaran yang cocok dengan model akun Penagihan Cloud Anda.

Penawaran berikut tersedia untuk dibeli, dan mengikuti model pemakaian baru (diskon langsung, tanpa kredit) :

Produk Istilah Cakupan Nama penawaran Parameter yang diperlukan
AlloyDB untuk PostgreSQL 1 tahun Global services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2 commitment_amount (direkomendasikan)
atau hourly_commit
AlloyDB untuk PostgreSQL 3 tahun Global services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a commitment_amount (direkomendasikan)
atau hourly_commit
Backup and DR (Oracle) 1 tahun Global services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82 commitment_amount (direkomendasikan)
atau hourly_commit
Backup and DR (Oracle) 3 tahun Global services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354 commitment_amount (direkomendasikan)
atau hourly_commit
BigQuery 1 tahun Regional services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724 commitment_amount (direkomendasikan)
atau hourly_commit,

region
BigQuery 3 tahun Regional services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a commitment_amount (direkomendasikan)
atau hourly_commit,

region
Bigtable 1 tahun Global services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193 commitment_amount (direkomendasikan)
atau hourly_commit
Bigtable 3 tahun Global services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996 commitment_amount (direkomendasikan)
atau hourly_commit
Cloud Run 3 tahun Regional services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0 commitment_amount (direkomendasikan)
atau hourly_commit,

region
Cloud Run tahun Regional services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5 commitment_amount (direkomendasikan)
atau hourly_commit,

region
Cloud SQL 1 tahun Regional services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3 commitment_amount (direkomendasikan)
atau hourly_commit,

region
Cloud SQL 3 tahun Regional services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8 commitment_amount (direkomendasikan)
atau hourly_commit,

region
Komitmen fleksibel Compute Engine 1 tahun Global services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93 commitment_amount (direkomendasikan)
atau hourly_commit
Komitmen fleksibel Compute Engine 3 tahun Global services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1 commitment_amount (direkomendasikan)
atau hourly_commit
Dataflow 1 tahun Global services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95 commitment_amount (direkomendasikan)
atau hourly_commit
Dataflow 3 tahun Global services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573 commitment_amount (direkomendasikan)
atau hourly_commit
Firestore 1 tahun Global services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21 commitment_amount (direkomendasikan)
atau hourly_commit
Firestore 3 tahun Global services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300 commitment_amount (direkomendasikan)
atau hourly_commit
Paket Hemat Fleksibel Gemini Enterprise 1 tahun Global services/aiplatform.googleapis.com/standardOffers/740fd2e8-ff1d-4304-9e85-61c0f8d75811 commitment_amount
Paket Hemat Fleksibel Gemini Enterprise 3 tahun Global services/aiplatform.googleapis.com/standardOffers/4733352d-24b5-4609-b3ff-d2a694f51654 commitment_amount
Google Kubernetes Engine 1 tahun Regional services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44 commitment_amount (direkomendasikan)
atau hourly_commit,

region
Google Kubernetes Engine 3 tahun Regional services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015 commitment_amount (direkomendasikan)
atau hourly_commit,

region
Managed Service untuk Apache Kafka 1 tahun Global services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956 commitment_amount (direkomendasikan)
atau hourly_commit
Managed Service untuk Apache Kafka 3 tahun Global services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66 commitment_amount (direkomendasikan)
atau hourly_commit
Memorystore untuk Redis 1 tahun Global services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456 commitment_amount (direkomendasikan)
atau hourly_commit
Memorystore 3 tahun Global services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f commitment_amount (direkomendasikan)
atau hourly_commit
Spanner 1 tahun Global services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403 commitment_amount (direkomendasikan)
atau hourly_commit
Spanner 3 tahun Global services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf commitment_amount (direkomendasikan)
atau hourly_commit

Penawaran berikut tersedia untuk dibeli, dan mengikuti model kredit lama (biaya harga jual + offset kredit) :

Produk Istilah Cakupan Nama penawaran Parameter yang diperlukan
Backup and DR (VMWare) 1 tahun Regional services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a hourly_commit,

region
Backup and DR (VMWare) 3 tahun Regional services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48 hourly_commit,

region
NetApp Volumes 1 tahun Global services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca hourly_commit
NetApp Volumes 3 tahun Global services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c hourly_commit

Mengidentifikasi parameter Penawaran

Berikut adalah parameter yang harus Anda tetapkan untuk membeli penawaran:

  • Commitment_amount (direkomendasikan) atau Hourly_commit:

    • Untuk komitmen pada model DA berbasis pengeluaran baru: commitment_amount (direkomendasikan) atau hourly_commit. Parameter hourly_commit pada akhirnya akan dihentikan dan diganti dengan parameter commitment_amount generik di masa mendatang untuk komitmen pada model baru. Beberapa DA mendukung pengulangan yang berbeda (per jam, bulanan, dll.), dan hanya akan mendukung parameter commitment_amount. Periksa kolom "Parameter yang diperlukan" di tabel Penawaran untuk mengetahui persyaratan tertentu.

    • Untuk penawaran yang tidak terpengaruh oleh model DA baru: Tentukan hourly_commit. Hal ini menunjukkan kredit yang diterapkan ke akun Penagihan Cloud Anda setiap jam. DA lama tidak mendukung commitment_amount.

  • Region (region): Region tempat manfaat komitmen ini berlaku.

    • Untuk komitmen regional: Tentukan region target (misalnya, us-central1). Untuk menemukan folder dan region yang didukung untuk setiap produk, lihat dokumentasi produk tersebut atau Ringkasan diskon abonemen.
    • Untuk komitmen global: Jangan sertakan parameter ini, karena komitmen global berlaku di semua region.

Membeli Penawaran

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

  • Parameter nilai komitmen yang cocok dengan jenis DA Anda:

    • Untuk komitmen pada model DA berbasis pengeluaran baru: Berikan commitment_amount (direkomendasikan) atau hourly_commit (tidak digunakan lagi, akan dihapus di masa mendatang). Untuk penawaran DA baru (seperti AI Platform), Anda harus menentukan commitment_amount.
    • Untuk DA lama: Berikan hourly_commit.

  • region (hanya untuk komitmen regional). Jika Anda membeli komitmen global, jangan sertakan parameter region.

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": "commitment_amount",
        "value": {
            "doubleValue": COMMITMENT_AMOUNT
        }
        }, {
        "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.

Melihat Pesanan Anda

Anda dapat melihat status komitmen saat ini langsung di Google Cloud konsol, 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

  1. Di Google Cloud konsol, buka akun Penagihan Cloud Anda.

    Buka akun Penagihan Cloud Anda

  2. Pilih Diskon abonemen (DA) dari sidebar.

  3. Komitmen yang Anda beli akan ditampilkan.