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
Abilitare l'API Cloud Commerce Consumer Procurement per il tuo progetto Google Cloud.
Assicurati di disporre di uno dei seguenti ruoli di 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 l'account di fatturazione.
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
- Vai a https://console.cloud.google.com/billing.
- Seleziona il tuo account di fatturazione Cloud.
- Seleziona Impegni dalla barra laterale.
- L'impegno acquistato è visibile nella tabella visualizzata.