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

Статья
02/03/2024

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

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

Только для пользователей Enterprise:
- прейскурант;
- сведения о бюджете;
- Прогнозы
- сведения о балансе.
- Теги
- Теги затрат
Для пользователей Enterprise и 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 сведений об использовании:

Отчеты о конце месяца. Для использования, которое произошло в течение месяца, но было сообщено в течение следующего месяца, клиентам потребуется просмотреть поле AdditionalProperties , чтобы назначить использование соответствующему месяцу.
Сведения об использовании запроса. При запросе 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 для конкретного языка см. в следующих статьях:

API потребления ресурсов Azure — пакет SDK для Python

API потребления ресурсов Azure — CLI

Пакет SDK API потребления ресурсов Azure для NodeJS

API потребления ресурсов Azure — пакет SDK для Ruby

Поделиться через