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

Al momento, tramite l'API è possibile acquistare solo impegni basati sulla spesa per prodotti selezionati. Questa procedura dettagliata descrive come acquistare un impegno basato sulla spesa.

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 della fatturazione (roles/billing.admin) per l'account di fatturazione Cloud di destinazione OPPURE per l'organizzazione Google Cloud in cui si trova il tuo account di fatturazione.

  • Amministratore degli ordini di acquisto per i consumatori (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.

Identifica 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 dello sconto.

Le seguenti offerte sono disponibili per l'acquisto:

Identifica 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 per cui si applicano i crediti di questo impegno.

Quando acquisti un impegno, devi specificare entrambi i parametri.

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.

• Il region per cui acquistare l'impegno.

Per effettuare un ordine, esegui il seguente 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 lungo termine restituita sia stata completata correttamente, esegui il seguente 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 l'ordine

Puoi visualizzare lo stato corrente 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'