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

Обзор миграции с системы отчетности Azure на API Microsoft Cost Management

  • Статья

В этой статье сообщается разработчикам, которые создали пользовательские решения с использованием API для корпоративной отчетности Azure, об важных изменениях. Новые 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 управления затратами Майкрософт можно перейти, на странице Переход с Azure Enterprise Reporting на API управления затратами Microsoft.
  • Настройте авторизацию и аутентификацию службы для 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/скачать
/podrobnaya-statistika/otpravit
/usagedetails
/usagedetailsbycustomdate		 Используйте Microsoft.CostManagement/Exports для всех повторяющихся рабочих нагрузок приема данных.
Используйте отчет Сведения о затратах для небольших наборов данных по запросу.
Переход с API сводки баланса EA /balancesummary Microsoft.Consumption/balances
Миграция из API прейскуранта EA /прайслист Для согласованных цен используйте Microsoft.Consumption/pricesheets/default.
Для розничных цен используйте API розничных цен.
Миграция из API сведений об использовании зарезервированного экземпляра EA /детали_бронирования Microsoft.CostManagement/generateReservationDetailsReport
Миграция от API сводной информации по использованию резервированных экземпляров EA /reservationsummaries Microsoft.Consumption/reservationSummaries
Перейдите с API рекомендаций по зарезервированным экземплярам EA /РекомендацииПоОбщемуБронированию
/РекомендацииДляОдиночныхБронирований		 Microsoft.Consumption/рекомендации по резервированию
Перенос с API начислений за зарезервированные экземпляры EA /reservationcharges Microsoft.Consumption/reservationTransactions

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

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

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

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