Переход с API данных о потреблении ресурсов

В этой статье рассматривается миграция с API сведений о потреблении и использовании, которое планируется к устареванию. Точная дата устаревания по-прежнему определяется. Рекомендуется не создавать конвейеры отчетов с помощью этого API и как можно скорее перейти от него.

API отчетов по корпоративному соглашению (EA), которые используют ключ API для проверки подлинности и доступны через URI-адрес consumption.azure.com, выводятся из эксплуатации. Клиенты EA, использующие эти API, должны перенестися в API сведений о затратах управления затратами. Эти старые API отчетов EA доступны только клиентам с Соглашение Enterprise.

Если вы используете API сведений об использовании потребления, рекомендуется, но не требуется перенести его в API сведений о затратах.

API управления потреблением и затратами доступны для клиентов с Корпоративным соглашением (EA) и Клиентским соглашением Microsoft (MCA). Клиенты Azure Government, которые остаются в рамках соглашения EA, не заметят негативных изменений.

При миграции из EA в MCA мы рекомендуем перейти с API сведений об использовании в рамках EA на API сведений о затратах в управлении затратами и использовать функцию экспорта.

Направления миграции

Прочитайте статью Выбор решения управления затратами перед тем, как выбрать подходящее решение для вашей рабочей нагрузки. В общем случае рекомендуем использовать Exports, если у вас есть текущие потребности в приеме данных или крупный ежемесячный набор данных об использовании. Для получения дополнительной информации см. статью Данные о деталях использования загрузки.

Если у вас есть меньший набор данных об использовании или сценарий, который не соответствует экспорту, рассмотрите возможность использования отчета "Сведения о затратах". Дополнительные сведения см. в статье Получение небольших наборов данных о затратах по запросу.

Преимущества переноса

Новые решения предоставляют множество преимуществ по сравнению с API сведений об использовании потребления. Ниже приведена сводка.

• Один набор данных для всех сведений об использовании. Сведения об использовании Azure и Azure Marketplace были объединены в один набор данных. Это сокращает количество API, которые необходимо вызвать, чтобы увидеть все ваши затраты.
• Масштабируемость - Marketplaces API устарел, так как он использует шаблон вызова, который не способен масштабироваться с увеличением использования Azure. Набор данных сведений об использовании может получить большую величину при развертывании дополнительных ресурсов в облаке. Marketplaces API — это синхронный API с разбивкой на страницы, поэтому он не оптимизирован для эффективной передачи больших объемов данных по сети с высокой эффективностью и надежностью. Экспорты и API для Сведения о затратах являются асинхронными. Они предоставляют CSV-файл, который можно скачать напрямую по сети.
• Улучшения API. Экспорт и API данных о затратах — это решения, которые Azure будет поддерживать в дальнейшем. Все новые функции будут интегрированы в них.
• Согласованность схемы. Отчет Сведения о затратах и Exports предоставляют файлы с соответствующими полями, чтобы вы могли переходить с одного решения на другое в зависимости от ситуации.
• Интеграция распределения стоимости — клиенты с Соглашением Enterprise и Клиентским соглашением Майкрософт, использующие Экспорт или API сведений о затратах, могут просматривать расходы с учетом добавленных ими правил распределения стоимости. Дополнительные сведения о распределении затрат см. в статье Распределение затрат.

Различия между полями

В следующей таблице перечислены различия в полях между API сведений об использовании потребления и API экспорта/экономических данных. Экспорт и API сведений о стоимости предоставляют загрузку CSV-файлов вместо ответа в формате JSON с разбивкой на страницы, который предоставляется API использования.

Соглашение Enterprise: сопоставление полей

Клиенты корпоративного соглашения, использующие API сведений о потреблении, имеют записи об использовании типа legacy. Все клиенты с Соглашением Enterprise имеют записи такого рода из-за базовой системы выставления счетов, которая используется для них. Ниже приведен пример записи сведений об использовании прежних версий:

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "legacy",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Полный пример устаревшей записи сведений об использовании показан в разделе Сведения об использовании — Список — REST API (потребление Azure)

Сопоставление между старыми и новыми полями показано в следующей таблице. Новые свойства доступны в CSV-файлах, созданных с помощью Exports и API детализации затрат. Дополнительные сведения о полях см. в разделе Понимание полей сведений об использовании.

Полужирные имена свойств не изменяются.

Клиентское соглашение Майкрософт: сопоставление полей

Клиенты Майкрософт по Клиентскому соглашению, использующие API сведений о потреблении, имеют записи о потреблении типа modern. Все клиенты по Клиентскому соглашению Майкрософт имеют такие записи благодаря используемой для них базовой системе выставления счетов. Ниже приведен пример записи сведений об использовании MCA:

{  

  "value": [  

      {  

          "id": "{id}", 

          "name": "{name}",  

          "type": "Microsoft.Consumption/usageDetails",  

          "kind": "modern",  

          "tags": {  

               "env": "newcrp",  

               "dev": "tools"  

          },  

          "properties": {  

…... 

      } 

} 

Полный пример устаревшей записи сведений об использовании показан в разделе Сведения об использовании — Список — REST API (потребление Azure)

Сопоставление между старыми и новыми полями показано в следующей таблице. Новые свойства доступны в CSV-файлах, созданных экспортом и API сведений о затратах. Поля, которым требуется сопоставление из-за различий между решениями, отображаются полужирным шрифтом.

Дополнительные сведения см. в полях Сведений об использовании.

Связанный контент

• Дополнительные сведения об автоматизации управления затратами и выставлением счетов см. в обзоре автоматизации управления затратами.