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

• Attiva l'API Cloud Commerce Consumer Procurement per il tuo progetto Google Cloud.

• Assicurati di avere uno dei seguenti ruoli Identity and Access Management (IAM) per l'account di fatturazione Cloud che vuoi utilizzare per acquistare l'impegno:

  • Amministratore di 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 per l'approvvigionamento dei consumatori (roles/consumerprocurement.orderAdmin) per l'account di fatturazione Cloud target 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, utilizzi un nome offerta che indichi il prodotto che stai acquistando e il periodo di sconto.

È possibile acquistare le seguenti offerte:

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:

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 'http://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 'http://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.

curl 'http://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/ORDER_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'