Utilizzare l'API per acquistare un impegno basato sulla spesa

Questo documento descrive come acquistare un impegno basato sulla spesa utilizzando Cloud Commerce Consumer Procurement API per gli acquisti di Cloud Marketplace.

Questa API supporta solo l'acquisto di impegni basati sulla spesa, non di impegni basati sulle risorse.

Prima di iniziare

Identificare l'offerta che vuoi acquistare

Per acquistare un impegno basato sulla spesa, utilizza un nome dell'offerta che indichi il prodotto che stai acquistando e il termine di sconto. Devi utilizzare il nome dell'offerta che corrisponde al modello del tuo account di fatturazione Cloud.

Le seguenti offerte sono disponibili per l'acquisto e seguono il nuovo modello di consumo (sconto diretto, senza crediti) :

Prodotto Termine Ambito Nome dell'offerta Parametri obbligatori
AlloyDB per PostgreSQL 1 anno Globale services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2 commitment_amount (consigliato)
o hourly_commit
AlloyDB per PostgreSQL 3 anni Globale services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a commitment_amount (consigliato)
o hourly_commit
Backup and RE (Oracle) 1 anno Globale services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82 commitment_amount (consigliato)
o hourly_commit
Backup and RE (Oracle) 3 anni Globale services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354 commitment_amount (consigliato)
o hourly_commit
BigQuery 1 anno Regionale services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724 commitment_amount (consigliato)
o hourly_commit,

region
BigQuery 3 anni Regionale services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a commitment_amount (consigliato)
o hourly_commit,

region
Bigtable 1 anno Globale services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193 commitment_amount (consigliato)
o hourly_commit
Bigtable 3 anni Globale services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996 commitment_amount (consigliato)
o hourly_commit
Cloud Run 3 anni Regionale services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0 commitment_amount (consigliato)
o hourly_commit,

region
Cloud Run anno Regionale services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5 commitment_amount (consigliato)
o hourly_commit,

region
Cloud SQL 1 anno Regionale services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3 commitment_amount (consigliato)
o hourly_commit,

region
Cloud SQL 3 anni Regionale services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8 commitment_amount (consigliato)
o hourly_commit,

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

region
Google Kubernetes Engine 3 anni Regionale services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015 commitment_amount (consigliato)
o hourly_commit,

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

Le seguenti offerte sono disponibili per l'acquisto e seguono il modello di credito legacy (addebito del prezzo di listino + compensazione del credito) :

Prodotto Termine Ambito Nome dell'offerta Parametri obbligatori
Backup and RE (VMWare) 1 anno Regionale services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a hourly_commit,

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

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

Identificare i parametri dell'offerta

Di seguito sono riportati i parametri da impostare per acquistare l'offerta:

  • Commitment_amount (consigliato) o Hourly_commit:

    • Per gli impegni sul nuovo modello di CUD basato sulla spesa: commitment_amount (consigliato) o hourly_commit. Il parametro hourly_commit verrà ritirato e sostituito dal parametro generico commitment_amount in futuro per gli impegni sul nuovo modello. Alcuni CUD supportano una ricorrenza diversa (oraria, mensile e così via) e supporteranno solo il parametro commitment_amount. Controlla la colonna "Parametri obbligatori" nelle tabelle delle offerte per requisiti specifici.

    • Per le offerte non interessate dal nuovo modello di CUD: specifica hourly_commit. Questo rappresenta il credito applicato al tuo account di fatturazione Cloud ogni ora. I CUD legacy non supportano commitment_amount.

  • Regione (region): la regione a cui si applicano i vantaggi di questo impegno.

    • Per gli impegni regionali: specifica la regione di destinazione (ad esempio us-central1). Per trovare le cartelle e le regioni supportate per ogni prodotto, consulta la documentazione del prodotto o la panoramica degli sconti per impegno di utilizzo.
    • Per gli impegni globali: ometti questo parametro, poiché gli impegni globali si applicano a tutte le regioni.

Acquistare l'offerta

Per acquistare un'offerta, chiama billingAccounts.orders.place, e fornisci i seguenti parametri nel corpo della richiesta:

  • Il parametro del valore dell'impegno corrispondente al tipo di CUD:

    • Per gli impegni sul nuovo modello di CUD basato sulla spesa: fornisci commitment_amount (consigliato) o hourly_commit (ritirato, verrà rimosso in futuro). Per le nuove offerte CUD (come AI Platform), devi specificare commitment_amount.
    • Per i CUD legacy: fornisci hourly_commit.

  • La region (solo per gli impegni regionali). Se stai acquistando un impegno globale, ometti il parametro region.

Per effettuare un ordine, esegui questo comando:

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

Viene restituito il nome di un'operazione a lunga esecuzione:

{
    "name": "OPERATION_NAME"
}

Per verificare che l'operazione a lunga esecuzione restituita sia stata completata correttamente, esegui questo comando:

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'

L'operazione a lunga esecuzione dovrebbe essere completata in meno di un secondo.

Visualizzare l'ordine

Puoi visualizzare lo stato attuale di un impegno direttamente nella Google Cloud console o chiamando billingAccounts.orders.get. Il campo name dell'ordine creato specifica il nome dell'ordine.

cURL

Per visualizzare un ordine, esegui questo comando:

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'

Console

  1. Nella Google Cloud console, vai al tuo account di fatturazione Cloud.

    Vai al tuo account di fatturazione Cloud

  2. Seleziona Sconti per impegno di utilizzo (CUD) dalla barra laterale.

  3. Vengono visualizzati gli impegni acquistati.