Utilizzare l'API per acquistare un impegno basato sulla spesa

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

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

Prima di iniziare

Abilita l'API Cloud Commerce Consumer Procurement per il tuo progetto Google Cloud .
Assicurati di disporre di uno dei seguenti ruoli Identity and Access Management (IAM) per l'account di fatturazione Cloud che vuoi utilizzare per acquistare l'impegno:
- Amministratore fatturazione (roles/billing.admin) per l'account di fatturazione Cloud di destinazione OPPURE l'organizzazione Google Cloud in cui si trova il tuo account di fatturazione.
- Amministratore ordini approvvigionamento consumer (roles/consumerprocurement.orderAdmin) per l'account di fatturazione Cloud di destinazione OPPURE l'organizzazione Google Cloud in cui si trova il tuo account di fatturazione.

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.

Il nuovo modello di CUD introduce nuovi nomi di offerta per i prodotti CUD esistenti. La tabella seguente riporta i nomi delle offerte prima e dopo la migrazione al nuovo modello di CUD basato sulla spesa. Devi utilizzare il nome dell'offerta che corrisponde al modello del tuo account di fatturazione Cloud.

Sono disponibili per l'acquisto le seguenti offerte aggiornate:

Le seguenti offerte non sono interessate dal nuovo modello CUD e sono disponibili per l'acquisto:

Prodotto	Termine	Nome dell'offerta
Backup per GKE	1 anno	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Backup per GKE	3 anni	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
Backup e RE (VMWare)	1 anno	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
Backup e RE (VMWare)	3 anni	`services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48`
NetApp Volumes	1 anno	`services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca`
NetApp Volumes	3 anni	`services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c`

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.
Nel programma CUD legacy prima della migrazione automatica dell'account, l'importo dell'impegno era invece il prezzo on demand. Per saperne di più, consulta la sezione Sconti per impegno di utilizzo (CUD) basati sulla spesa.
Regione (region): la regione a cui si applicano i vantaggi di questo impegno.

Quando acquisti un impegno, devi specificare entrambi i parametri.

Acquista l'offerta

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

Il valore 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 di lunga durata 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.

Visualizza il tuo ordine

Puoi visualizzare lo stato attuale di un impegno direttamente nella console Google Cloud 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

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

Vai al tuo account di fatturazione Cloud
Seleziona Sconti per impegno di utilizzo (CUD) dalla barra laterale.
Vengono visualizzati gli impegni acquistati.