API розничных цен Azure для Китая

Статья
06/21/2023

Этот API позволяет получить розничные тарифы для всех служб Azure в Китае без проверки подлинности. Используйте API для изучения цен на службы Azure в разных регионах и разных номерах SKU. Api также может помочь вам создать собственные средства для внутреннего анализа и сравнения цен в разных SKU и регионах. В этой статье рассматриваются сведения, которые относятся только к API розничных цен Azure для использования в Китае.

С помощью ответа API вы получите URL-адрес для скачивания CSV-файла, который включает розничные тарифы для всех служб Azure в Китае.

Розничные цены, показанные в этом документе, являются примерами.

Конечная точка API

https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview

Параметры URI

Имя	В	Обязательно	Тип	Описание
api-version	query	True	строка	Версия API, используемая для этой операции

Ответ

Имя	Тип	Описание
200 ОК	DownloadURL	Все в порядке. Запрос выполнен успешно
Другие коды состояния	ErrorResponse	Сообщение об ошибке с описанием причины сбоя операции.

Пример запроса

https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview

Пример ответа

Status code: 200

{
    "DownloadUrl": "https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>",
    "LastRefreshedAt": "2023-06-02T04:19:45Z",
    "ExpiryTime": ""2023-06-02T06:54:57.1059946Z"}"
}

Определение

Имя	Описание
DownloadURL	URL-адрес для скачивания созданного отчета
ErrorDetails	Сведения об ошибке
ErrorResponse	Ответ об ошибке указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.

DownloadURL

URL-адрес для скачивания созданного отчета.

Имя	Тип	Описание
DownloadUrl	строка	URL-адрес для скачивания созданного отчета
LastRefreshedAt	строка	Время обновления данных в формате UTC. Например, 2023-06-02T04:19:45Z
expiryTime	строка	Время, когда URL-адрес отчета становится недействительным или истекает в формате UTC. Например, 2023-06-02T06:54:57.1059946Z

Загрузка использованияURL

Ниже приведен пример ответа от API.

{"DownloadUrl":"https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>","LastRefreshedAt":"2023-06-02T04:19:45Z","ExpiryTime":"2023-06-02T06:54:57.1059946Z"}

Скопируйте содержимое в кавычки для URL-адреса и вставьте его в адрес браузера. Затем перейдите по адресу, чтобы начать скачивание CSV-файла. Не включайте LastRefreshedAt строки или ExpiryTime . Пример приведен ниже.

https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>

Скачивание файла начинается для AzureRetailPrices.csv.

ErrorDetails

Сведения об ошибке.

Имя	Тип	Описание
code	строка	Код ошибки
message	строка	Сообщение об ошибке, указывающее, почему операция завершилась сбоем

ErrorResponse

Ответ об ошибке указывает, что служба не может обработать входящий запрос. Причина указана в сообщении об ошибке.

Ниже приведены некоторые ответы на ошибки.

429 TooManyRequests — Запрос регулируется. Повторите попытку по окончании периода времени, указанного в заголовке x-ms-ratelimit-microsoft.consumption-retry-after.
503 ServiceUnavailable — Служба временно недоступна. Повторите попытку по окончании периода времени, указанного в заголовке Retry-After.

Имя	Тип	Описание
error	ErrorDetails	Сведения об ошибке

Сведения о свойствах в скачанном CSV-файле

Ниже приведены все сведения о свойствах, которые включены в скачанный CSV-файл.

Приведены примеры цен.

Поле	Примеры значений	Определение
currencyCode	CNY	Валюта, в которой определяются ставки и возвращаются цены. Это всегда CNY для услуг в Китае
tierMinimumUnits	0	Минимальная единица измерения для каждого уровня. Для служб с фиксированной ценой для всех единиц значение всегда равно 0. Для служб с многоуровневыми ценами значением является указание минимальной единицы измерения для каждого уровня.
retailPrice	0.869038	Розничная цена на службы Майкрософт
unitPrice	0.869038	Розничная цена на службы Майкрософт
armRegionName	chinaeast2	Azure Resource Manager регионе, в котором доступна служба
Расположение	CN East 2	Центр обработки данных Azure, в котором развернут ресурс
effectiveStartDate	2020-08-01T00:00:00Z	Показывает дату вступления розничных цен в силу.
meterId	f25b95bd-f9fa-5e85-a3e8-379259ae8dce	Уникальный идентификатор ресурса
meterName	D2/DS2	Имя единицы измерения
Productid	DZH318Z0BPVW	Уникальный идентификатор продукта
skuId	DZH318Z0BPVW/00F9	UniqueID для номера SKU
productName	Windows серии Виртуальные машины D	Название продукта
skuName	D2	Номер SKU
serviceName	Виртуальные машины	Имя службы
serviceFamily	Вычисления	Семейство служб номера SKU
unitOfMeasure	1 час	Как измеряется использование службы
тип	Потребление	Тип ценовых ставок. Поддерживаемые типы: `Reservation`, `ConsumptionSavingsPlanConsumption` и `DevTestConsumption`.
armSkuName	Standard_F16s	Имя номера SKU, зарегистрированного в Azure
Слово	3 года	Длина термина. Это применимо к сроку резервирования или зафиксированного срока для получения ставки SavingsPlan
isPrimaryMeterRegion	True	Указывает, задана ли область измерения в качестве основного единицы измерения. Первичные счетчики используются для оплаты и выставления счетов.

Пример загруженного CSV-файла

Ниже приведен пример данных в CSV-файле после форматирования в виде таблицы.