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

Переход с API-интерфейсов для корпоративной отчетности на API-интерфейсы Управления затратами Майкрософт

  • Статья

В этой статье разработчики сообщают разработчикам, которые создали пользовательские решения с помощью API отчетов Azure Enterprise о важных изменениях. Новые API управления затратами Майкрософт теперь предлагают расширенные возможности и поддержку субъектов-служб, что делает их более надежным выбором для ваших проектов.

Основные моменты:

  • Рекомендуется выполнить миграцию. Настоятельно рекомендуется перенести пользовательские решения в API управления затратами Майкрософт. Они активно разрабатываются и предлагают улучшенные функциональные возможности.
  • Дата выхода на пенсию. Все API-интерфейсы отчетов Azure Enterprise не удаляются.

Эта статья содержит следующее:

  • Общие сведения о различиях между API-интерфейсами Отчетов Azure Enterprise и API управления затратами.
  • Рекомендации о том, что следует ожидать при миграции в API управления затратами.
  • Сведения о новых возможностях, доступных с помощью API управления затратами.

Вызов действия:

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

Отличия между API

В указанных ниже сведениях описываются различия между старыми API-интерфейсами для корпоративной отчетности Azure и более новыми API-интерфейсами Управления затратами.

Использование API-интерфейсы для корпоративной отчетности Azure API-интерфейсы Управления затратами Майкрософт
Проверка подлинности Ключ API, подготовленный в портал Azure Проверка подлинности Microsoft Entra с помощью маркеров пользователей или субъектов-служб. Вместо ключей API теперь используются субъекты-службы.
Области и разрешения Все запросы находятся в области регистрации. Назначение разрешений для ключей API определяет, какие данные возвращаются: для всей регистрации, для отдела или для определенной учетной записи. Аутентификация пользователя не используется. Пользователям или субъектам-службам назначается доступ к области регистрации, отдела или учетной записи.
Конечная точка URI https://consumption.azure.com https://management.azure.com
Состояние разработки Нет, API-интерфейсы не удаляются. В активной разработке
Доступные интерфейсы API Ограничены тем, что уже доступно. Для каждого API EA доступны эквивалентные API на замену. Также доступны дополнительные API управления затратами, в том числе:
– бюджетов;
– оповещений;
– экспорта.

Контрольный список действий по миграции

  • Ознакомьтесь с REST API Azure Resource Manager.
  • Определите, какие API-интерфейсы корпоративной отчетности вы используете, и узнайте, какие API управления затратами можно перейти к API управления затратами Из Azure Enterprise в API управления затратами Майкрософт.
  • Настройте авторизацию и аутентификацию службы для API-интерфейсов Управления затратами. Дополнительные сведения см. в статье Назначение разрешений API ACM.
  • Протестируйте работу с API-интерфейсами и обновите программный код, чтобы заменить вызовы API для корпоративной отчетности вызовами API Управления затратами.
  • Обновите механизм обработки ошибок так, чтобы он использовал новые коды ошибок. Ниже приведены некоторые рекомендации.
    • API-интерфейсы Управления затратами имеют период ожидания 60 секунд.
    • API-интерфейсы Управления затратами не имеют ограничений. При превышении этих ограничений появляются 429 throttling error. Следите за тем, чтобы ваши решения не отправляли слишком много вызовов API в течение короткого периода времени.
  • Ознакомьтесь с другими API Управления затратами, которые предоставляются через Azure Resource Manager, и оцените возможность их использования в будущем. Дополнительные сведения см. в статье "Миграция из отчетов Azure Enterprise в API управления затратами Майкрософт".

Сопоставление API-интерфейсов для корпоративной отчетности с новыми API-интерфейсами Управления затратами

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

Сценарий API-интерфейсы для корпоративной отчетности API-интерфейсы Управления затратами
Переход с API сведений об использовании EA /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 Используйте Microsoft.CostManagement/Exports для всех повторяющихся рабочих нагрузок приема данных.
Используйте отчет Сведения о затратах для небольших наборов данных по запросу.
Миграция из API сводки баланса EA /balancesummary Microsoft.Consumption/balances
Миграция из API прейскуранта EA /pricesheet Для согласованных цен используйте Microsoft.Consumption/pricesheets/default.
Для розничных цен используйте API розничных цен.
Миграция из API сведений об использовании зарезервированного экземпляра EA /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
Миграция из API сводки по использованию зарезервированного экземпляра EA /reservationsummaries Microsoft.Consumption/reservationSummaries
Миграция из API рекомендаций зарезервированного экземпляра EA /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
Миграция из API оплаты зарезервированного экземпляра EA /reservationcharges Microsoft.Consumption/reservationTransactions

Использование дополнительных API Управления затратами

После перехода на API-интерфейсы Управления затратами для имеющихся сценариев создания отчетов вы можете настроить использование и других API-интерфейсов. Эти API также доступны через Azure Resource Manager и могут быть автоматизированы с использованием аутентификации на основе субъекта-службы. Ниже приведен краткий обзор новых возможностей.

  • Бюджеты — используйте для установки порогов для упреждающего мониторинга затрат, оповещения релевантных участников и автоматизации действий в ответ на нарушение порогов.
  • Оповещения — используйте для просмотра сведений об оповещениях, в том числе в отношении бюджета, счетов, кредитов и квот.
  • Экспорты — используйте для создания расписаний регулярного экспорта данных о расходах в выбранную учетную запись хранения Azure. Это рекомендуемое решение для клиентов с большим присутствием в Azure, которые хотят анализировать данные и использовать их в собственных внутренних системах.

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