Membeli Penawaran komitmen dengan menggunakan Cloud Commerce Consumer Procurement API

Anda dapat membeli penawaran menggunakan Cloud Commerce Consumer Procurement API, yaitu API untuk melakukan pembelian di Cloud Marketplace.

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

Sebelum memulai

Identifikasi Penawaran yang ingin Anda beli

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

Penawaran berikut tersedia untuk dibeli:

Produk Istilah Nama penawaran
AlloyDB untuk PostgreSQL 1 tahun services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c
AlloyDB untuk PostgreSQL 3 tahun services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5
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 1 tahun services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a
Backup and DR 3 tahun services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48
Bigtable 1 tahun services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39
Bigtable 3 tahun services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff
Cloud Run 1 tahun services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e
Cloud Run 3 tahun services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c
Komitmen fleksibel Compute Engine 1 tahun services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2
Komitmen fleksibel Compute Engine 3 tahun services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f
Google Kubernetes Engine 1 tahun services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1
Google Kubernetes Engine 3 tahun services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578
Dataflow 1 tahun services/dataflow.googleapis.com/standardOffers/42ae4415-0361-404f-8bc5-1e7c041c2d82
Dataflow 3 tahun services/dataflow.googleapis.com/standardOffers/cac998b8-3d49-4672-ae5b-e5b3c56e05f2
Memorystore 1 tahun services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37
Memorystore 3 tahun services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354
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
Spanner 1 tahun services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b
Spanner 3 tahun services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603
Cloud SQL 1 tahun services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9
Cloud SQL 3 tahun services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33

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.
  • Region (region): Region tempat kredit komitmen ini berlaku.

Saat membeli komitmen, Anda harus menentukan kedua parameter tersebut.

Membeli Penawaran

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

  • hourly_commit yang menunjukkan nilai dolar komitmen.

  • region yang akan dibeli komitmennya.

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 berdurasi 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 dapat melihat status komitmen saat ini secara 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

  1. Buka https://console.cloud.google.com/billing.
  2. Pilih akun Penagihan Cloud Anda.
  3. Pilih Komitmen dari sidebar.
  4. Komitmen yang Anda beli akan terlihat di tabel yang ditampilkan.