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

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

Attualmente, solo gli impegni basati sulla spesa per prodotti selezionati possono essere acquistati tramite l'API. Questa procedura descrive come acquistare un impegno basato sulla spesa.

Prima di iniziare

Identifica l'offerta che desideri acquistare

Per acquistare un impegno basato sulla spesa, utilizza un nome Offerta che indica il prodotto che stai acquistando e il periodo dello sconto.

Le seguenti offerte sono disponibili per l'acquisto:

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
Impegno flessibile di Compute Engine 1 anno services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2
Impegno flessibile di Compute Engine 3 anni services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f
AlloyDB per PostgreSQL 1 anno services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c
AlloyDB per PostgreSQL 3 anni services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5
Cloud Bigtable 1 anno services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39
Cloud Bigtable 3 anni services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff
Cloud Run 1 anno services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e
Cloud Run 3 anni services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c
Cloud Spanner 1 anno services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b
Cloud Spanner 3 anni services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603
Cloud SQL 1 anno services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9
Cloud SQL 3 anni services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33
Kubernetes Engine 1 anno services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1
Kubernetes Engine 3 anni services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578
Memorystore 1 anno services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37
Memorystore 3 anni services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354

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 crediti di questo impegno.

Quando acquisti un impegno, devi specificare entrambi i parametri.

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

Prodotto Impegno minimo Impegno massimo Regioni
Motore VMWare 5 $ l'ora 10.000 $ l'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:

  • Il valore hourly_commit che indica il valore monetario dell'impegno.

  • Il 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

Questo 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 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

  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.