Acquistare un'offerta di impegno utilizzando l'API Cloud Commerce Consumer Procurement

Puoi acquistare offerte utilizzando l'API Cloud Commerce Consumer Procurement, un'API per effettuare acquisti su Cloud Marketplace.

Oggi l'API è in modalità di anteprima e solo gli impegni basati sulla spesa possono essere acquistati tramite l'API. Questo tutorial descrive come acquistare un impegno basato sulla spesa.

Prima di iniziare

Identifica l'offerta che vuoi acquistare

Per acquistare un impegno basato sulla spesa, utilizzi un nome offerta che indichi il prodotto che stai acquistando e il periodo di sconto.

È possibile acquistare le seguenti offerte:

Prodotto Termine Nome offerta
Motore VMWare 1 anno services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e
Motore VMWare 3 anni services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c

Identificare i parametri dell'offerta

Gli impegni hanno due parametri:

  • Importo dell'impegno (hourly_commit): il credito applicato al tuo account di fatturazione Cloud ogni ora dopo l'acquisto di questo impegno.
  • Area geografica (region): l'area geografica per cui si applicano questi crediti di impegno.

Quando acquisti un impegno, devi specificare entrambi i parametri.

I prodotti hanno valori e vincoli specifici per i relativi parametri. Ad esempio, se vuoi acquistare VMWare Engine, puoi fare riferimento ai seguenti valori e vincoli:

Prodotto Impegno minimo Impegno massimo Regioni
Motore VMWare 5 $ all'ora 10.000 $ all'ora asia-northeast1
asia-south1
asia-southeast1
australia-southeast1
europe-west2
europe-west3
europe-west4
northamerica-northeast
northamerica-northeast1
southamerica-east1
us-central1
us-east4
us-west2

Acquista l'Offerta

Per acquistare un'Offerta, chiama billingAccounts.orders.place e fornisci i seguenti parametri:

  • hourly_commit che indica il valore in dollari dell'impegno.

  • L'region per cui acquistare l'impegno.

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": "hourly_commit",
        "value": {
            "doubleValue": HOURLY_COMMIT
        }
        }, {
        "name": "region",
        "value": {
            "stringValue": "REGION"
        }
        }],
        "offer": "OFFER_NAME"
    }]
    }
EOF

Restituisce 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 il comando seguente:

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.

Visualizza il tuo ordine

Puoi visualizzare lo stato corrente di un impegno direttamente in Google Cloud Console o chiamando il numero billingAccounts.orders.get. Il campo name dell'ordine creato specifica il nome dell'ordine.

URL

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. Vai a https://console.cloud.google.com/billing.
  2. Seleziona il tuo account di fatturazione Cloud.
  3. Seleziona Impegni dalla barra laterale.
  4. L'impegno acquistato è visibile nella tabella visualizzata.