Потребление ресурсов Azure

Интерфейсы API потребления ресурсов Azure предоставляют программный доступ к сведениям о стоимости и потреблении ресурсов Azure. В настоящее время API поддерживают только корпоративные регистрации, подписки Web Direct (за некоторыми исключениями) и подписки на план Azure CSP. API-интерфейсы постоянно обновляются для поддержки других типов подписок Azure.

Интерфейсы API потребления в Azure обеспечивают доступ к следующим сведениям:

Только для корпоративных клиентов
- прейскурант;
- Бюджеты
- Прогнозы
- Balances
- Метки
- Ценники
Корпоративные клиенты и клиенты Web Direct
- Сведения о резервировании
- Сводные данные о резервировании
- сведения о расходах на Marketplace;
- сведения о потреблении;
- Рекомендации по бронированию

Список неподдерживаемых типов подписок:

MS-AZR-0145P (CSP);
MS-AZR-0146P (CSP);
MS-AZR-159P (CSP);
MS-AZR-0036P (спонсируемая);
MS-AZR-0143P (спонсируемая);
MS-AZR-0015P (внутренняя);
MS-AZR-0144P (DreamSpark).

Работа с биллинговыми периодами и диапазонами дат

Сведения об использовании и расходы Marketplace принимают период выставления счетов или диапазоны дат для определения дат начала и окончания данных об использовании.

Вот поведение API на основе периодов выставления счетов и диапазонов дат запроса:

Запрашиваемый расчётный период	Дата начала работы в запросе	Дата окончания запроса	Поведение API
нет	нет	нет	В ответ возвращаются данные за текущий расчетный период
нет	да	нет	В ответ возвращаются данные за текущий расчетный период
нет	нет	да	В ответ возвращаются данные за текущий расчетный период
нет	да	да	В ответ возвращаются данные за указанные даты начала и окончания
да	нет	нет	В ответ возвращаются данные за указанный расчетный период
да	да	нет	В ответ возвращаются данные за указанный расчетный период
да	нет	да	В ответ возвращаются данные за указанный расчетный период
да	да	да	В ответ возвращаются данные за указанные даты начала и окончания, указанный расчетный период игнорируется

Максимально допустимый диапазон дат составляет 12 месяцев в одном запросе, а данные доступны с 1 мая 2014 года или позже.

Получение списка биллинговых периодов

Чтобы подтвердить действительный расчетный период в запросе, клиент сначала должен получить список доступных периодов по подписке с помощью следующего API

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods?api-version=2017-04-24-preview

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

Данные с опозданием

Для поддержки сторонних сервисов с задержками в отчёте об использовании, дата отчёта об использовании устанавливается на время, когда данные о них были отправлены, а не на время фактического использования, то есть на время потребления.

В результате использование оценивается и применяется к указанному времени. Чтобы представить фактическое время потребления, свойства. Поле AdditionalProperties теперь будет содержать ещё два объекта. ConsumptionBeginTime и ConsumptionEndTime — это новые поля, соответствующие временному окну фактического потребления.

Эти изменения приводят к нескольким ситуациям, которые необходимо учитывать при вызове API с деталями использования:

Отчетность по итогам месяца: Для использования, которое произошло в течение месяца, но было отчитано в следующем месяце, клиентам необходимо посмотреть поле дополнительного Свойства , чтобы назначить использование соответствующего месяца.
Детали использования запроса: Когда вы запрашиваете API с деталями использования по диапазону дат, запрос применяется только к дате отчета об использовании, а не к времени потребления в поле additionalProperties . Для клиентов, желающих сопоставить данные о потреблении с счетами, это обновление не влияет на процесс, так как счет обрабатывает расходы на основе даты отчёта об использовании. Для клиентов, которые хотят сопоставить данные о потреблении с конкретной календарной датой/месяцем, это обновление является неожиданным изменением, и в таких случаях нельзя использовать дату отчёта об использовании, а также дату использования в разделе additionalProperties .

Пример звонка для получения дополнительной информации:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/usageDetails?api-version=2018-03-31&$expand=properties/additionalProperties

Пример фрагмента ответа:

  "properties": {
    "billingPeriodId":"/subscriptions/{subscriptionid}/providers/Microsoft.Billing/billingPeriods/20180501",
    "usageStart":"2018-05-01T00:00:00.0000000Z",
    "usageEnd":"2018-05-01T23:59:59.0000000Z",
    "instanceId":"/subscriptions/{subscriptionid}/resourceGroups/{resourcegroup}/providers/Microsoft.Cdn/profiles/{profile}",
    "instanceName":"{id}",
    "instanceLocation":"SouthCentralUS",
    "meterId":"6b88ada0-cbc0-4874-be0e-23004f8b4de7",
    "usageQuantity":0.002065,
    "pretaxCost":0,
    "currency":"USD",
    "additionalProperties": {
      "Provider": "1",
      "ConsumptionBeginTime": "2018-05-01T19:00:00",
      "ConsumptionEndTime": "2018-05-01T20:00:00"
    }
  }

См. также

Дополнительные сведения об использовании этого API в одном из SDK для конкретных языков см. в следующих разделах

Azure Consumption Python SDK

Azure Consumption CLI

Azure Consumption NodeJS SDK

Azure Consumption Ruby SDK

Last updated on 2026-01-07