Google Cloud Pricing API adalah kumpulan resource API yang membantu Anda mendapatkan harga dan informasi lain untuk layanan Google Cloud.
Halaman ini menunjukkan beberapa contoh permintaan API yang dapat Anda buat untuk mendapatkan informasi layanan dan SKU yang tercantum secara publik, serta layanan dan SKU yang hanya tersedia untuk akun Penagihan Cloud Anda sebagai bagian dari kontrak dengan Google Cloud.
Anda dapat menggunakan Pricing API untuk mendapatkan daftar layanan, atau harga
unit penyimpanan persediaan (SKU) tertentu. SKU akan mengidentifikasi secara jelas resource
yang dapat Anda beli. Contoh SKU adalah Nvidia Tesla K80 GPU attached to
Spot Preemptible VMs running in Warsaw
. Jika memiliki kontrak dengan harga kustom,
Anda juga dapat menggunakan Pricing API untuk mendapatkan harga khusus
yang terkait dengan akun Penagihan Cloud Anda.
Untuk mengetahui daftar lengkap resource yang tersedia dalam Pricing API, serta informasi format permintaan dan respons yang mendetail, lihat referensi API.
Sebelum memulai
Aktifkan API Cloud Billing.
Mendapatkan informasi layanan publik dan harga
Contoh berikut menunjukkan panggilan API yang dapat Anda gunakan untuk mendapatkan informasi SKU dan layanan Google Cloud yang tercantum secara publik.
Untuk mendapatkan informasi layanan publik, SKU, atau harga, Anda harus membuat kunci API.
Mendapatkan daftar layanan Google Cloud publik
Contoh berikut mencantumkan semua layanan Google Cloud publik, termasuk metadata untuk setiap layanan.
Anda tidak memerlukan izin IAM tertentu untuk melakukan panggilan API ini.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- API_KEY: Kunci Google Cloud API.
- PAGE_SIZE (Opsional): Jumlah layanan yang akan ditampilkan. Jumlah default-nya adalah 50.
- PAGE_TOKEN (Opsional): Token halaman, yang Anda dapatkan
dari
nextPageToken
dalam respons sebelumnya.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
"https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"
PowerShell
Jalankan perintah berikut:
$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
Respons berisi daftar layanan, dan informasi setiap layanan. Contoh di bawah ini menunjukkan format untuk Compute Engine.
Hasil akan diberi nomor halaman dan dibatasi hingga 50 layanan per halaman. Respons
berisi nextPageToken
yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan
pageToken=PAGE_TOKEN
.
Untuk mengurangi jumlah SKU per halaman, tetapkan
pageSize=PAGE_SIZE
. Setelah semua item tercantum, tidak akan
ada token yang ditampilkan.
{ "services": [ { "name": "services/6F81-5844-456A", "serviceId": "6F81-5844-456A", "displayName": "Compute Engine", }, ... ] "nextPageToken": "alphanumeric-page-token" }
Mendapatkan daftar SKU untuk layanan Google Cloud publik
Contoh berikut mencantumkan SKU publik untuk layanan tertentu.
Anda tidak memerlukan izin IAM tertentu untuk melakukan panggilan API ini.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- API_KEY: Kunci Google Cloud API.
- FILTER: Layanan untuk memfilter SKU. Misalnya, jika ingin mencantumkan SKU untuk Compute Engine, gunakan filter
service="services/DA34-426B-A397"
. - PAGE_SIZE (Opsional): Jumlah maksimum SKU untuk ditampilkan. Jumlah default-nya adalah 50, dan maksimum 5.000.
- PAGE_TOKEN (Opsional): Token halaman, yang ada di
nextPageToken
dalam respons.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
"https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER"
PowerShell
Jalankan perintah berikut:
$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
yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan
pageToken=PAGE_TOKEN
.
Untuk mengubah jumlah SKU per halaman, tetapkan
pageSize=PAGE_SIZE
. Setelah semua item
tercantum, tidak akan ada token yang ditampilkan.
{ "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" }
Mendapatkan harga untuk semua SKU Google Cloud publik
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- SKU_ID: ID SKU tertentu untuk mendapatkan harganya. Guna mendapatkan harga semua SKU, gunakan `-`.
- API_KEY: Kunci Google Cloud API.
- PAGE_SIZE (Opsional): Jumlah layanan yang akan ditampilkan. Jumlah default-nya adalah 50.
- PAGE_TOKEN (Opsional): Token halaman, yang Anda dapatkan
dari
nextPageToken
dalam respons sebelumnya.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
"https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"
PowerShell
Jalankan perintah berikut:
$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
Respons berisi informasi harga untuk setiap ID SKU.Contoh di bawah menunjukkan format untuk semua SKU publik, dengan ukuran halaman `2`.
Hasilnya telah dipaginasi, dan secara default, berisi 50 harga per halaman. Respons
berisi nextPageToken
yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan
pageToken=PAGE_TOKEN
.
Untuk mengurangi jumlah hasil per halaman, tetapkan
pageSize=PAGE_SIZE
. Setelah semua item tercantum, tidak akan
ada token yang ditampilkan.
{ "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" }
Mendapatkan harga SKU publik
Contoh berikut menampilkan cara mendapatkan harga SKU yang tercantum secara publik. Anda bisa mendapatkan daftar lengkap ID SKU Google Cloud di halaman SKU.
Anda tidak memerlukan izin IAM tertentu untuk melakukan panggilan API ini.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- API_KEY: Kunci Google Cloud API.
- SKU_ID: ID SKU, yang bisa Anda dapatkan menggunakan metode
skus.list
. ID adalah string setelah IDskus/
. - CURRENCY: (Opsional) Kode mata uang ISO-4217 untuk harga. Jika tidak ditentukan, harga akan menggunakan mata uang yang sama seperti yang ada digunakan di akun Penagihan Cloud Anda.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
"https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY"
PowerShell
Jalankan perintah berikut:
$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" } } }
Mendapatkan informasi khusus untuk akun Penagihan Cloud Anda
Contoh berikut menunjukkan panggilan API yang mendapatkan informasi khusus akun Penagihan Cloud Anda, seperti SKU tertentu atau informasi harga yang mungkin menjadi bagian dari kontrak harga kustom Anda.
Bergantung pada resource API yang digunakan, Anda harus memiliki izin berikut untuk akun Penagihan Cloud:
Untuk mendapatkan informasi layanan menggunakan
billingAccounts.services
, Anda memerlukan:billing.billingAccountServices.get
billing.billingAccountServices.list
Untuk mendapatkan informasi SKU menggunakan
billingAccounts.skus
, Anda memerlukan:billing.billingAccountSkus.get
billing.billingAccountSkus.list
Untuk mendapatkan informasi Grup SKU menggunakan
billingAccounts.skugroups
, Anda memerlukan:billing.billingAccountSkuGroups.get
billing.billingAccountSkuGroups.list
Untuk mendapatkan informasi SKU yang menjadi bagian dari Grup SKU menggunakan
billingAccounts.skugroups.skus
, Anda memerlukan:billing.billingAccountSkuGroupSkus.get
billing.billingAccountSkuGroupSkus.list
Untuk mendapatkan informasi harga SKU yang menggunakan
billingAccounts.skus.price
, Anda memerlukan:billing.billingAccountPrice.get
Jika Anda memanggil API menggunakan akun layanan, akun layanan tersebut harus memiliki izin.
Peran yang telah ditetapkan berikut memiliki izin untuk mendapatkan informasi khusus terkait akun Penagihan Cloud Anda:
- Billing Account Administrator
- Billing Account Viewer
Mendapatkan daftar grup SKU untuk akun Penagihan Cloud Anda
Jika Anda memiliki kontrak harga dengan Google Cloud, kontrak Anda mungkin merujuk pada grup SKU, yang berisi SKU yang termasuk dalam kategori tertentu. Misalnya, grup SKU BigQuery berisi SKU untuk analisis dan penyimpanan BigQuery di berbagai lokasi.
Contoh berikut mencantumkan grup SKU yang tersedia untuk akun Penagihan Cloud Anda.
Untuk melakukan panggilan API ini, Anda memerlukan izin IAM billing.billingAccountSkuGroups.list
di akun Penagihan Cloud Anda.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- BILLING_ACCOUNT_ID: ID akun Penagihan Cloud.
- PAGE_SIZE (Opsional): Jumlah maksimum grup SKU untuk ditampilkan. Jumlah default-nya adalah 50, dan maksimum 5.000.
- PAGE_TOKEN (Opsional): Token halaman, yang ada di
nextPageToken
dalam respons.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
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
Jalankan perintah berikut:
$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
Respon adalah daftar grup SKU, dalam format yang ditunjukkan di bawah ini.
Hasil akan diberi nomor halaman dan dibatasi hingga 50 grup SKU per halaman. Respons
berisi nextPageToken
yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan
pageToken=PAGE_TOKEN
.
Untuk mengurangi jumlah SKU per halaman, tetapkan
pageSize=PAGE_SIZE
. Setelah semua item tercantum, tidak akan
ada token yang ditampilkan.
{ "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" }
Mendapatkan daftar SKU dalam grup SKU untuk akun Penagihan Cloud Anda
Contoh berikut mencantumkan SKU dalam grup SKU yang mungkin menjadi bagian dari kontrak harga kustom Anda.
Untuk melakukan panggilan API ini, Anda memerlukan izin IAM billing.billingAccountSkuGroupSkus.list
di akun Penagihan Cloud Anda.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- SKU_GROUP_ID: ID grup SKU, yang Anda dapatkan dari
billingAccount.skuGroups.list method
. - BILLING_ACCOUNT_ID: ID akun Penagihan Cloud.
- PAGE_SIZE (Opsional): Jumlah grup SKU yang akan didapatkan. Jumlah default-nya adalah 5.000.
- PAGE_TOKEN (Opsional): Token halaman, yang ada di
nextPageToken
dalam respons.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
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
Jalankan perintah berikut:
$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
Contoh berikut menampilkan 2 SKU pertama untuk grup SKU Network Data Transfer
, dengan ID 28934b47-792e-4afa-a025-7720d410482f
.
Hasil akan diberi nomor halaman dan dibatasi hingga 5.000 grup SKU per halaman. Respons
berisi nextPageToken
yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan
pageToken=PAGE_TOKEN
.
Untuk mengurangi jumlah SKU per halaman, tetapkan
pageSize=PAGE_SIZE
. Setelah semua item tercantum, tidak akan
ada token yang ditampilkan.
{ "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" }
Dapatkan harga semua SKU Google Cloud untuk akun Penagihan Cloud Anda
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- SKU_ID: ID SKU tertentu untuk mendapatkan harganya. Guna mendapatkan harga semua SKU, gunakan `-`.
- API_KEY: Kunci Google Cloud API.
- PAGE_SIZE (Opsional): Jumlah layanan yang akan ditampilkan. Jumlah default-nya adalah 50.
- PAGE_TOKEN (Opsional): Token halaman, yang Anda dapatkan
dari
nextPageToken
dalam respons sebelumnya.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
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
Jalankan perintah berikut:
$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
Respons berisi daftar ID SKU dan harganya, termasuk SKU yang hanya tersedia untuk akun Penagihan Cloud Anda, dan informasi harga untuk setiap SKU. Contoh di bawah menunjukkan format untuk semua SKU, dengan ukuran halaman `2`.
Hasilnya telah dipaginasi, dan secara default, berisi 50 harga per halaman. Respons
berisi nextPageToken
yang dapat Anda gunakan untuk mendapatkan halaman hasil berikutnya. Untuk mengambil batch berikutnya, tetapkan
pageToken=PAGE_TOKEN
.
Untuk mengubah jumlah hasil per halaman, tetapkan
pageSize=PAGE_SIZE
. Setelah semua item tercantum, tidak akan
ada token yang ditampilkan.
{ "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" }
Mendapatkan harga SKU untuk akun Penagihan Cloud Anda
Contoh berikut menampilkan harga yang Anda bayar untuk SKU. Jika SKU adalah bagian dari kontrak harga kustom, respons akan menyertakan informasi diskon harga jual.
Untuk melakukan panggilan API ini, Anda memerlukan izin IAM billing.billingAccountPrice.get
di akun Penagihan Cloud Anda.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- SKU_ID: ID SKU, yang bisa Anda dapatkan menggunakan metode
billingAccounts.skus
. ID adalah string setelah IDskus/
. - BILLING_ACCOUNT_ID: ID akun Penagihan Cloud.
- CURRENCY: (Opsional) Kode mata uang ISO-4217 untuk harga. Jika tidak ditentukan, harga akan menggunakan mata uang yang sama seperti yang ada digunakan di akun Penagihan Cloud Anda.
Metode HTTP dan URL:
GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
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
Jalankan perintah berikut:
$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
.
Contoh berikut menunjukkan detail harga untuk ID SKU 0012-B7F2-DD14
. Dalam contoh ini, akun Penagihan Cloud memiliki kontrak harga, tetapi membayar harga jual untuk SKU ini.
{ "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": {} } }
Topik terkait
Mendapatkan informasi SKU Google Cloud publik yang mendetail.
Mendapatkan informasi grup SKU Google Cloud publik yang mendetail