Gambaran umum Azure Retail Prices

Artikel
07/06/2022
4 menit untuk membaca

Pelanggan Azure telah mencari cara terprogram untuk mengambil harga ritel untuk semua layanan Azure. Sekarang Anda dapat menggunakan RETAIL Rates Prices API untuk mendapatkan harga ritel untuk semua layanan Azure. Sebelumnya, satu-satunya cara Anda dapat mengambil harga untuk layanan Azure adalah dengan menggunakan Kalkulator Harga Azure atau menggunakan portal Microsoft Azure. API ini memberi Anda pengalaman yang tidak diautentikasi untuk mendapatkan tarif ritel untuk semua layanan Azure. Gunakan API untuk mengeksplorasi harga untuk layanan Azure terhadap berbagai wilayah dan SKU yang berbeda. API terprogram juga dapat membantu Anda membuat alat Sendiri untuk analisis internal dan perbandingan harga di seluruh SKU dan wilayah.

Penting

Mata uang yang digunakan Microsoft untuk harga semua layanan Azure adalah USD. Harga yang ditunjukkan dalam mata uang USD adalah harga ritel Microsoft. Harga non-USD lainnya yang dikembalikan oleh API adalah untuk referensi Anda untuk membantu Anda memperkirakan pengeluaran anggaran.

Versi pratinjau

Anda dapat menggunakan versi API pratinjau 2021-10-01 yang baru di https://prices.azure.com/api/retail/prices?api-version=2021-10-01-preview. Versi pratinjau kompatibel dengan versi sebelumnya. URL mengembalikan set meteran lengkap, termasuk pengukur utama dan pengukur non-primer.

Menggunakan salah satu https://prices.azure.com/api/retail/prices atau https://prices.azure.com/api/retail/prices?api-version=2021-10-01-preview mengembalikan set meter penuh.

Anda dapat membatasi respons untuk hanya mengambil harga meteran primer dengan:

https://prices.azure.com/api/retail/prices?api-version=2021-10-01-preview&meterRegion=’primary’

Titik akhir API

https://prices.azure.com/api/retail/prices

Panggilan sampel API

Berikut adalah beberapa contohnya:

Contoh panggilan yang difilter hanya untuk komputer virtual

https://prices.azure.com/api/retail/prices?$filter=serviceName eq 'Virtual Machines'

Contoh panggilan yang difilter hanya untuk reservasi

https://prices.azure.com/api/retail/prices?$filter=priceType eq 'Reservation'

Contoh panggilan yang difilter untuk komputer virtual instans cadangan

https://prices.azure.com/api/retail/prices?$filter=serviceName eq 'Virtual Machines' and priceType eq 'Reservation'

Contoh panggilan yang difilter untuk sumber daya komputasi

https://prices.azure.com/api/retail/prices?$filter=serviceFamily eq 'Compute'

Contoh panggilan yang difilter untuk komputasi dengan mata uang dalam euro

https://prices.azure.com/api/retail/prices?currencyCode='EUR'&$filter=serviceFamily eq 'Compute'

Contoh respons API

Berikut adalah contoh respons API, tanpa harga reservasi.

{
            "currencyCode": "USD",
            "tierMinimumUnits": 0.0,
            "retailPrice": 0.176346,
            "unitPrice": 0.176346,
            "armRegionName": "westeurope",
            "location": "EU West",
            "effectiveStartDate": "2020-08-01T00:00:00Z",
            "meterId": "000a794b-bdb0-58be-a0cd-0c3a0f222923",
            "meterName": "F16s Spot",
            "productId": "DZH318Z0BQPS",
            "skuId": "DZH318Z0BQPS/00TG",
            "productName": "Virtual Machines FS Series Windows",
            "skuName": "F16s Spot",
            "serviceName": "Virtual Machines",
            "serviceId": "DZH313Z7MMC8",
            "serviceFamily": "Compute",
            "unitOfMeasure": "1 Hour",
            "type": "DevTestConsumption",
            "isPrimaryMeterRegion": true,
            "armSkuName": "Standard_F16s"
        }

Berikut adalah contoh respons API dengan harga reservasi dan jangka waktu dalam respons.

{
            "currencyCode": "USD",
            "tierMinimumUnits": 0.0,
            "reservationTerm": "1 Year",
            "retailPrice": 25007.0,
            "unitPrice": 25007.0,
            "armRegionName": "southcentralus",
            "location": "US South Central",
            "effectiveStartDate": "2020-08-01T00:00:00Z",
            "meterId": "0016083a-928f-56fd-8eeb-39287dcf676d",
            "meterName": "E64 v4",
            "productId": "DZH318Z0D1L7",
            "skuId": "DZH318Z0D1L7/018J",
            "productName": "Virtual Machines Ev4 Series",
            "skuName": "E64 v4",
            "serviceName": "Virtual Machines",
            "serviceId": "DZH313Z7MMC8",
            "serviceFamily": "Compute",
            "unitOfMeasure": "1 Hour",
            "type": "Reservation",
            "isPrimaryMeterRegion": true,
            "armSkuName": "Standard_E64_v4"
        }

Berikut adalah respons sampel dengan mata uang non-USD.

{
  "currencyCode": "EUR",
  "tierMinimumUnits": 0,
  "retailPrice": 0.6176,
  "unitPrice": 0.6176,
  "armRegionName": "westeurope",
  "location": "EU West",
  "effectiveStartDate": "2021-04-01T00:00:00Z",
  "meterId": "000a794b-bdb0-58be-a0cd-0c3a0f222923",
  "meterName": "F16s Spot",
  "productId": "DZH318Z0BQPS",
  "skuId": "DZH318Z0BQPS/00TG",
  "productName": "Virtual Machines FS Series Windows",
  "skuName": "F16s Spot",
  "serviceName": "Virtual Machines",
  "serviceId": "DZH313Z7MMC8",
  "serviceFamily": "Compute",
  "unitOfMeasure": "1 Hour",
  "type": "Consumption",
  "isPrimaryMeterRegion": true,
  "armSkuName": "Standard_F16s"
}

Penomoran halaman respons API

Respons API menyediakan penomoran halaman. Untuk setiap permintaan API, maksimal 100 rekaman dikembalikan. Di akhir respons API, ia memiliki tautan ke halaman berikutnya. Contohnya:

"NextPageLink": https://prices.azure.com:443/api/retail/prices?$fliter=serviceName%20eq%20%27Virtual%20Machines%27&$skip=100

Detail properti API

Berikut adalah semua detail properti yang merupakan bagian dari respons API.

Bidang	Contoh Nilai	Definisi
`currencyCode`	USD	Mata uang di mana tarif ditentukan dan mengembalikan harga dalam USD kecuali ditentukan.
`tierMinimumUnits`	0	Unit konsumsi minimum untuk memanfaatkan harga
`reservationTerm`	1 tahun	Jangka waktu reservasi – satu tahun atau tiga tahun
`retailPrice`	0.176346	Harga tanpa diskon
`unitPrice`	0.176346
`armRegionName`	`westeurope`	Wilayah ARM tempat layanan tersedia. Versi ini hanya mendukung harga di Commercial Cloud.
`Location`	Eropa Barat	Pusat data Azure tempat sumber daya disebarkan
`effectiveStartDate`	2020-08-01T00:00:00Z	Bidang opsional. Menunjukkan tanggal kapan harga eceran efektif.
`meterId`	000a794b-bdb0-58be-a0cd-0c3a0f222923	Pengidentifikasi unik sumber daya
`meterName`	F16s Spot	Nama meteran
`productid`	DZH318Z0BQPS	UniqueID produk
`skuId`	DZH318Z0BQPS/00TG	UniqueID untuk SKU
`productName`	Windows Seri FS Virtual Machines	Nama produk
`skuName`	F16s Spot	Nama SKU
`serviceName`	Komputer Virtual	Nama layanan
`serviceId`	DZH313Z7MMC8	UniqueID layanan
`serviceFamily`	Compute	Keluarga layanan SKU
`unitOfMeasure`	1 jam	Cara penggunaan diukur untuk layanan
`Type`	DevTestConsumption	Jenis konsumsi meteran. Jenis lainnya adalah Reservasi, Konsumsi.
`isPrimaryMeterRegion`	True	Menunjukkan apakah wilayah pengukur ditetapkan sebagai meter utama atau tidak. Pengukur utama digunakan untuk biaya dan penagihan.
`armSkuName`	Standar_F16s	Nama SKU yang terdaftar di Azure

Filter API

Filter didukung untuk bidang berikut:

armRegionName
Location
meterId
meterName
productid
skuId
productName
skuName
serviceName
serviceId
serviceFamily
priceType
armSkuName

Anda menambahkan filter ke titik akhir API, seperti yang ditunjukkan dalam panggilan sampel API.

Mata uang yang didukung

Anda menambahkan kode mata uang ke titik akhir API, seperti yang ditunjukkan dalam panggilan sampel API.

Kode mata uang	Detail
USD	Dolar AS
BIAYA AUD	Dolar Australia
BIAYA BRL	Real Brasil
CAD	Dolar Kanada
BIAYA CHF	Franc Swiss
BIAYA CNY	Yuan Cina
DKK	Krone Denmark
EUR	Euro
BIAYA GBP	Pound Inggris
BIAYA INR	Rupee India
JPY	Yen Jepang
KRW	Won Korea
BIAYA NOK	Krone Norwegia
BIAYA NZD	Dolar Selandia Baru
BIAYA RUB	Rubel Rusia
BIAYA SEK	Krona Swedia
BIAYA TWD	Dolar Taiwan

Langkah berikutnya

Pelajari tentang API Cost Management lainnya.