Переход с API сведений об использовании потребления

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

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

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

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

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

Назначения миграции

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

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

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

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

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

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

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

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

Клиенты с Соглашением 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-файлах, созданных Exports и API сведений о затратах. Поля, которым требуется сопоставление из-за различий между решениями, отображаются полужирным шрифтом.

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

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

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