L'API Google Cloud Pricing è un insieme di risorse API che consente di ottenere i prezzi e altre informazioni per i servizi Google Cloud.
Questa pagina mostra alcuni esempi di richieste API che puoi effettuare per ottenere informazioni sui servizi e sugli SKU pubblicamente disponibili, nonché sui servizi e sugli SKU disponibili solo per il tuo account di fatturazione Cloud nell'ambito di un contratto con Google Cloud.
Puoi utilizzare l'API dei prezzi per ottenere un elenco di servizi o il prezzo di uno specifico SKU (codice identificativo dell'unità). Uno SKU identifica distintamente
una risorsa che puoi acquistare. Un esempio di SKU è Nvidia Tesla T4 GPU attached to
Spot Preemptible VMs running in Warsaw
. Se hai un contratto con prezzi personalizzati, puoi utilizzare anche l'API dei prezzi per ottenere i prezzi personalizzati associati al tuo account di fatturazione Cloud.
Per un elenco completo delle risorse disponibili nell'API dei prezzi e per informazioni dettagliate sui formati di richiesta e risposta, consulta la documentazione sulle API.
Prima di iniziare
Attiva l'API Cloud Billing.
Ricevere informazioni su servizi e prezzi pubblici
Gli esempi seguenti mostrano le chiamate API che puoi utilizzare per ricevere informazioni elencate pubblicamente sui servizi e sugli SKU di Google Cloud.
Per ottenere informazioni su servizi pubblici, SKU o prezzi, devi creare una chiave API.
Recupera un elenco dei servizi Google Cloud pubblici
L'esempio seguente elenca tutti i servizi Google Cloud pubblici, inclusi i metadati per ogni servizio.
Non hai bisogno di autorizzazioni IAM specifiche per effettuare questa chiamata API.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- API_KEY: la tua chiave API Google Cloud.
- PAGE_SIZE (facoltativo): il numero di servizi da restituire. Il valore predefinito è 50.
- PAGE_TOKEN (facoltativo): il token di pagina, che ricevi
da
nextPageToken
in una risposta precedente.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
"https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"
PowerShell
Esegui questo comando:
$headers = @{ }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content
La risposta contiene un elenco di servizi e informazioni su ogni servizio. L'esempio seguente mostra il formato per Compute Engine.
I risultati sono impaginati e sono limitati a 50 servizi per pagina. La
risposta include un nextPageToken
che puoi utilizzare per ottenere la pagina di risultati successiva. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN
.
Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE
. Una volta elencati tutti gli elementi, non viene restituito alcun token.
{ "services": [ { "name": "services/6F81-5844-456A", "serviceId": "6F81-5844-456A", "displayName": "Compute Engine", }, ... ] "nextPageToken": "alphanumeric-page-token" }
Recupera un elenco di SKU per un servizio Google Cloud pubblico
Nell'esempio seguente sono elencati gli SKU pubblici per un servizio specificato.
Non hai bisogno di autorizzazioni IAM specifiche per effettuare questa chiamata API.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- API_KEY: la tua chiave API Google Cloud.
- FILTER: i servizi in base ai quali filtrare gli SKU. Ad esempio, per elencare gli SKU per Compute Engine, utilizza il filtro
service="services/6F81-5844-456A"
. - PAGE_SIZE (Facoltativo): il numero massimo di SKU da restituire. Il valore predefinito è 50 e il massimo è 5000.
- PAGE_TOKEN (facoltativo): il token di pagina, che si trova in
nextPageToken
nella risposta.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
"https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER"
PowerShell
Esegui questo comando:
$headers = @{ }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER" | Select-Object -Expand Content
nextPageToken
che puoi utilizzare per ottenere la pagina di risultati successiva. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN
.
Per modificare il numero di SKU per pagina, imposta pageSize=PAGE_SIZE
. Una volta che tutti gli elementi sono stati elencati, non viene restituito alcun token.
{ "skus": [ { "name": "skus/0008-F633-76AA", "skuId": "0008-F633-76AA", "displayName": "Example L4 GPU attached to Spot Preemptible VMs running in Hong Kong", "service": "6F81-5844-456A", "productTaxonomy": { "taxonomyCategories": [ { "category": "GCP" }, { "category": "Compute" }, { "category": "GPUs" }, { "category": "GPUs Preemptible" }, { "category": "L4" } ] }, "geoTaxonomy": { "type": "REGIONAL", "regionalMetadata": { "region": { "region": "asia-east2" } } } }, { "name": "skus/000F-0B14-D302", "skuId": "000F-0B14-D302", "displayName": "Example Sole Tenancy Instance Ram running in Turin", "service": "6F81-5844-456A", "productTaxonomy": { "taxonomyCategories": [ { "category": "GCP" }, { "category": "Compute" }, { "category": "GCE" }, { "category": "VMs On Demand" }, { "category": "Memory: Per GB" }, { "category": "C3" } ] }, "geoTaxonomy": { "type": "REGIONAL", "regionalMetadata": { "region": { "region": "europe-west12" } } } } ], "nextPageToken": "alphanumeric-nextpageToken" }
Richiedi i prezzi per tutti gli SKU di Google Cloud pubblici
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- SKU_ID: un ID SKU specifico di cui ottenere il prezzo. Per ottenere i prezzi per tutti gli SKU, utilizza "-".
- API_KEY: la tua chiave API Google Cloud.
- PAGE_SIZE (facoltativo): il numero di servizi da restituire. Il valore predefinito è 50.
- PAGE_TOKEN (facoltativo): il token di pagina, che ricevi
da
nextPageToken
in una risposta precedente.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
"https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"
PowerShell
Esegui questo comando:
$headers = @{ }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content
La risposta contiene informazioni sui prezzi per ogni ID SKU.L'esempio seguente mostra il formato di tutti gli SKU pubblici, con una dimensione di pagina pari a "2".
I risultati sono impaginati e, per impostazione predefinita, contengono 50 prezzi per pagina. La
risposta include un nextPageToken
che puoi utilizzare per ottenere la pagina di risultati successiva. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN
.
Per ridurre il numero di risultati per pagina, imposta pageSize=PAGE_SIZE
. Una volta elencati tutti gli elementi, non viene restituito alcun token.
{ "prices": [ { "name": "skus/0000-9B70-F099/price", "currencyCode": "USD", "valueType": "rate", "rate": { "tiers": [ { "startAmount": { "value": "0" }, "listPrice": { "currencyCode": "USD", "nanos": 690000000 } } ], "unitInfo": { "unit": "h", "unitDescription": "hour", "unitQuantity": { "value": "1" } }, "aggregationInfo": { "level": "LEVEL_ACCOUNT", "interval": "INTERVAL_MONTHLY" } } }, { "name": "skus/0002-17F9-0731/price", "currencyCode": "USD", "valueType": "rate", "rate": { "tiers": [ { "startAmount": { "value": "0" }, "listPrice": { "currencyCode": "USD" } }, { "startAmount": { "value": "1" }, "listPrice": { "currencyCode": "USD", "nanos": 390000000 } }, { "startAmount": { "value": "1024" }, "listPrice": { "currencyCode": "USD", "nanos": 340000000 } } ], "unitInfo": { "unit": "GiBy.mo", "unitDescription": "gibibyte month", "unitQuantity": { "value": "1" } }, "aggregationInfo": { "level": "LEVEL_ACCOUNT", "interval": "INTERVAL_MONTHLY" } } } ], "nextPageToken": "1234alphanumericCode" }
Richiedi il prezzo di uno SKU pubblico
L'esempio seguente restituisce il prezzo di uno SKU elencato al pubblico. Puoi trovare un elenco completo degli ID SKU di Google Cloud nella pagina degli SKU.
Non hai bisogno di autorizzazioni IAM specifiche per effettuare questa chiamata API.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- API_KEY: la tua chiave API Google Cloud.
- SKU_ID: l'identificatore SKU, che puoi ottenere utilizzando il metodo
skus.list
. L'ID è la stringa che segue l'identificatoreskus/
. - (Facoltativo) CURRENCY: il codice valuta ISO-4217 del prezzo. Se non specificato, il prezzo è nella stessa valuta del tuo account di fatturazione Cloud.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
"https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY"
PowerShell
Esegui questo comando:
$headers = @{ }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY" | Select-Object -Expand Content
0012-B7F2-DD14
.
{ "name": "skus/0012-B7F2-DD14/price", "currencyCode": "USD", "valueType": "rate", "rate": { "tiers": [ { "startAmount": { "value": "0" }, "listPrice": { "currencyCode": "USD", "nanos": 1397000 } } ], "unitInfo": { "unit": "GiBy.h", "unitDescription": "gibibyte hour", "unitQuantity": { "value": "1" } }, "aggregationInfo": { "level": "ACCOUNT", "interval": "MONTHLY" } } }
Ottieni informazioni specifiche per il tuo account di fatturazione Cloud
Gli esempi seguenti mostrano chiamate API che ricevono informazioni specifiche per il tuo account di fatturazione Cloud, ad esempio SKU specifici o informazioni sui prezzi che potrebbero far parte del contratto con prezzi personalizzati.
A seconda della risorsa API che utilizzi, devi disporre di queste autorizzazioni per l'account di fatturazione Cloud:
Per ottenere informazioni sui servizi che utilizzano
billingAccounts.services
, devi avere:billing.billingAccountServices.get
billing.billingAccountServices.list
Per ottenere informazioni sugli SKU utilizzando
billingAccounts.skus
, devi avere:billing.billingAccountSkus.get
billing.billingAccountSkus.list
Per ottenere informazioni sui gruppi di SKU che utilizzano
billingAccounts.skugroups
, hai bisogno di:billing.billingAccountSkuGroups.get
billing.billingAccountSkuGroups.list
Per ottenere informazioni sugli SKU che fanno parte dei gruppi di SKU che utilizzano
billingAccounts.skugroups.skus
, devi avere:billing.billingAccountSkuGroupSkus.get
billing.billingAccountSkuGroupSkus.list
Per ottenere informazioni sui prezzi degli SKU utilizzando
billingAccounts.skus.price
, hai bisogno di:billing.billingAccountPrice.get
Se chiami l'API utilizzando un account di servizio, quest'ultimo deve disporre delle autorizzazioni.
I seguenti ruoli predefiniti hanno le autorizzazioni necessarie per ottenere informazioni specifiche per il tuo account di fatturazione Cloud:
- Amministratore account di fatturazione
- Visualizzatore account di fatturazione
Crea un elenco di gruppi di SKU per il tuo account di fatturazione Cloud
Se hai un contratto relativo ai prezzi con Google Cloud, il tuo contratto potrebbe fare riferimento a gruppi di SKU, che contengono SKU che rientrano in una categoria specifica. Ad esempio, il gruppo di SKU BigQuery contiene SKU per l'analisi e l'archiviazione di BigQuery in varie località.
Nell'esempio seguente sono elencati i gruppi di SKU disponibili per il tuo account di fatturazione Cloud.
Per effettuare questa chiamata API, devi disporre dell'autorizzazione IAM billing.billingAccountSkuGroups.list
per il tuo account di fatturazione Cloud.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- BILLING_ACCOUNT_ID: il tuo ID account di fatturazione Cloud.
- PAGE_SIZE (Facoltativo): il numero massimo di gruppi di SKU da restituire. Il valore predefinito è 50 e il massimo è 5000.
- PAGE_TOKEN (facoltativo): il token di pagina, che si trova in
nextPageToken
nella risposta.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content
La risposta è un elenco di gruppi di SKU nel formato mostrato di seguito.
I risultati sono impaginati e sono limitati a 50 gruppi di SKU per pagina. La
risposta include un nextPageToken
che puoi utilizzare per ottenere la pagina di risultati successiva. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN
.
Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE
. Una volta elencati tutti gli elementi, non viene restituito alcun token.
{ "billingAccountSkuGroups": [ { "name": "billingAccounts/012345-567890-ABCDEF/skuGroups/001234-group-id-1", "displayName": "SKU group name 1" }, { "name": "billingAccounts/012345-567890-ABCDEF/skuGroups/0045657-group-id-2", "displayName": "SKU group name 2" }, ... "nextPageToken": "A1234-alphanumeric-page-token" }
Recupera un elenco di SKU in un gruppo di SKU per il tuo account di fatturazione Cloud
Nell'esempio seguente sono elencati gli SKU di un gruppo di SKU che potrebbero far parte del tuo contratto con prezzi personalizzati.
Per effettuare questa chiamata API, devi disporre dell'autorizzazione IAM billing.billingAccountSkuGroupSkus.list
per il tuo account di fatturazione Cloud.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- SKU_GROUP_ID: l'ID gruppo di SKU che ottieni da
billingAccount.skuGroups.list method
. - BILLING_ACCOUNT_ID: il tuo ID account di fatturazione Cloud.
- PAGE_SIZE (facoltativo): il numero di gruppi di SKU da ricevere. Il valore predefinito è 5000.
- PAGE_TOKEN (facoltativo): il token di pagina, che si trova in
nextPageToken
nella risposta.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content
L'esempio seguente mostra i primi due SKU per il gruppo di SKU Network Data Transfer
, con l'ID 28934b47-792e-4afa-a025-7720d410482f
.
I risultati sono impaginati e sono limitati a 5000 gruppi di SKU per pagina. La
risposta include un nextPageToken
che puoi utilizzare per ottenere la pagina di risultati successiva. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN
.
Per ridurre il numero di SKU per pagina, imposta pageSize=PAGE_SIZE
. Una volta elencati tutti gli elementi, non viene restituito alcun token.
{ "billingAccountSkuGroupSkus": [ { "name": "billingAccounts/12345-ABCDE-EXAMPLE/skuGroups/28934b47-792e-4afa-a025-7720d410482f/skus/0009-6F35-3126", "skuId": "0009-6F35-3126", "displayName": "Network Internet Data Transfer from EMEA to Seoul", "service": "9662-B51E-5089", "productTaxonomy": { "taxonomyCategories": [ { "category": "GCP" }, { "category": "Network" }, { "category": "Data Transfer" }, { "category": "Cloud SQL" }, { "category": "Premium" } ] }, "geoTaxonomy": { "type": "REGIONAL", "regionalMetadata": { "region": { "region": "europe-west1" } } } }, { "name": "billingAccounts/12345-ABCDE-EXAMPLE/skuGroups/28934b47-792e-4afa-a025-7720d410482f/skus/000B-47CC-2924", "skuId": "000B-47CC-2924", "displayName": "API Gateway Network Internet Data Transfer Intercontinental from/to Oceania", "service": "36A9-155B-23F0", "productTaxonomy": { "taxonomyCategories": [ { "category": "GCP" }, { "category": "Network" }, { "category": "Data Transfer" }, { "category": "API Gateway" }, { "category": "Premium" } ] }, "geoTaxonomy": {} } ], "nextPageToken": "alphanumeric-nextPageToken" }
Richiedi i prezzi per tutti gli SKU di Google Cloud per il tuo account di fatturazione Cloud
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- SKU_ID: un ID SKU specifico di cui ottenere il prezzo. Per ottenere i prezzi per tutti gli SKU, utilizza "-".
- API_KEY: la tua chiave API Google Cloud.
- PAGE_SIZE (facoltativo): il numero di servizi da restituire. Il valore predefinito è 50.
- PAGE_TOKEN (facoltativo): il token di pagina, che ricevi
da
nextPageToken
in una risposta precedente.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content
La risposta contiene un elenco di ID SKU e i relativi prezzi, inclusi gli SKU disponibili solo per il tuo account di fatturazione Cloud e informazioni sui prezzi per ogni SKU. L'esempio seguente mostra il formato per tutti gli SKU, con una dimensione di pagina pari a "2".
I risultati sono impaginati e, per impostazione predefinita, contengono 50 prezzi per pagina. La
risposta include un nextPageToken
che puoi utilizzare per ottenere la pagina di risultati successiva. Per recuperare il batch successivo, imposta pageToken=PAGE_TOKEN
.
Per modificare il numero di risultati per pagina, imposta pageSize=PAGE_SIZE
. Una volta elencati tutti gli elementi, non viene restituito alcun token.
{ "billingAccountPrices": [ { "name": "billingAccounts/01ABCD-EFGH23-UVWXYZ/skus/0000-9B70-F099/price", "currencyCode": "USD", "valueType": "rate", "rate": { "tiers": [ { "startAmount": { "value": "0" }, "listPrice": { "currencyCode": "USD", "nanos": 690000000 }, "contractPrice": { "currencyCode": "USD", "nanos": 690000000 }, "effectiveDiscountPercent": { "value": "0" } } ], "unitInfo": { "unit": "h", "unitDescription": "hour", "unitQuantity": { "value": "1" } }, "aggregationInfo": { "level": "LEVEL_ACCOUNT", "interval": "INTERVAL_MONTHLY" } }, "priceReason": { "type": "default-price", "defaultPrice": {} } }, { "name": "billingAccounts/01ABCD-EFGH23-UVWXYZ/skus/0002-17F9-0731/price", "currencyCode": "USD", "valueType": "rate", "rate": { "tiers": [ { "startAmount": { "value": "0" }, "listPrice": { "currencyCode": "USD" }, "contractPrice": { "currencyCode": "USD" }, "effectiveDiscountPercent": { "value": "0" } }, { "startAmount": { "value": "1" }, "listPrice": { "currencyCode": "USD", "nanos": 390000000 }, "contractPrice": { "currencyCode": "USD", "nanos": 390000000 }, "effectiveDiscountPercent": { "value": "0" } }, { "startAmount": { "value": "1024" }, "listPrice": { "currencyCode": "USD", "nanos": 340000000 }, "contractPrice": { "currencyCode": "USD", "nanos": 340000000 }, "effectiveDiscountPercent": { "value": "0" } } ], "unitInfo": { "unit": "GiBy.mo", "unitDescription": "gibibyte month", "unitQuantity": { "value": "1" } }, "aggregationInfo": { "level": "LEVEL_ACCOUNT", "interval": "INTERVAL_MONTHLY" } }, "priceReason": { "type": "default-price", "defaultPrice": {} } } ], "nextPageToken": "1234alphanumericCode" }
Verifica i prezzi per gli SKU per il tuo account di fatturazione Cloud
L'esempio seguente restituisce il prezzo che stai pagando per uno SKU. Se lo SKU fa parte di un contratto con prezzi personalizzati, la risposta include informazioni sullo sconto sul prezzo di listino.
Per effettuare questa chiamata API, devi disporre dell'autorizzazione IAM billing.billingAccountPrice.get
per il tuo account di fatturazione Cloud.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- SKU_ID: l'identificatore SKU, che puoi ottenere utilizzando il metodo
billingAccounts.skus
. L'ID è la stringa che segue l'identificatoreskus/
. - BILLING_ACCOUNT_ID: il tuo ID account di fatturazione Cloud.
- (Facoltativo) CURRENCY: il codice valuta ISO-4217 del prezzo. Se non specificato, il prezzo è nella stessa valuta del tuo account di fatturazione Cloud.
Metodo HTTP e URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY
Per inviare la richiesta, scegli una delle seguenti opzioni:
arricciatura
Esegui questo comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY"
PowerShell
Esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY" | Select-Object -Expand Content
priceReason
.
L'esempio seguente mostra i dettagli dei prezzi per l'ID SKU 0012-B7F2-DD14
. In questo esempio, l'account di fatturazione Cloud ha un contratto di prezzi, ma paga il prezzo di listino per questo SKU.
{ "name": "billingAccounts/015978-D9414D-B80267/skus/0012-B7F2-DD14/price", "currencyCode": "USD", "valueType": "rate", "rate": { "tiers": [ { "startAmount": { "value": "0" }, "listPrice": { "currencyCode": "USD", "nanos": 1270000 }, "contractPrice": { "currencyCode": "USD", "nanos": 1270000 } } ], "unitInfo": { "unit": "GiBy.h", "unitDescription": "gibibyte hour", "unitQuantity": { "value": "1" } }, "aggregationInfo": { "level": "ACCOUNT", "interval": "MONTHLY" } }, "priceReason": { "type": "default-price", "defaultPrice": {} } }
Argomenti correlati
Esportare i dati dei prezzi di fatturazione Cloud in BigQuery
Visualizzare e scaricare i listini prezzi nel report sulla tabella dei prezzi
Informazioni dettagliate sugli SKU di Google Cloud pubblici.
Informazioni dettagliate sui gruppi di SKU di Google Cloud pubblici