Acquista un impegno basato sulla spesa

Al momento, questa API supporta solo l'acquisto di impegni basati sulla spesa, non di 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 l'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 mostra i nomi delle offerte prima e dopo l'attivazione del 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 di CUD e sono disponibili per l'acquisto:

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.

• 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'account 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.

Visualizzare l'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 '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'