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

Управление версиями и поддержка

  • Статья

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

Информация о поддержке и устаревании

Power Platform API — это первый инструмент программирования, который получает новые версии и функции раньше, чем другие SDK, такие как PowerShell, соединители управления и Power Platform CLI. По мере выпуска новой версии REST API более ранние версии будут удалены. Microsoft объявит версию устаревшей как минимум за 12 месяцев до прекращения использования конечной точки API. Когда версия устарела, она по-прежнему поддерживается как есть. Если у вас возникнут проблемы с этой версией, мы попросим вас перейти на текущую общедоступную версию. Когда версия устаревает, она не поддерживается и вскоре будет отключена.

Увеличивая номер версии API (например, с 2021-10-01 до 2022-04-01), Microsoft объявляет, что предыдущая общедоступная версия (в данном примере 2021-10-01) немедленно устаревает и будет удалена через 12 месяцев после объявления. То же самое относится и к общедоступным предварительным версиям. Корпорация Майкрософт может делать исключения из этой политики для проблем с работоспособностью и безопасностью служб.

Для командлетов PowerShell будут доступны инкрементные версии для устранения мелких ошибок. Основные версии будут увеличиваться в соответствии с новыми версиями API.

Совместимость и критические изменения

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

Вот примеры критических изменений:

  • URL-адрес или основной запрос/ответ изменен.
  • Объявленное свойство удаляется или переименовывается, либо изменяется его тип.
  • API или параметры API удалены или переименованы.
  • Добавлен обязательный параметр запроса.

Вот примеры некритических изменений:

  • Добавляются свойства, допускающие значение NULL или имеющие значение по умолчанию.
  • Участник добавлен в перечисление.
  • Разбиение на страницы введено в существующие коллекции.
  • Коды ошибок изменены.
  • Изменен порядок свойств в запросах или ответах.

Доступные версии

Версия Тип Ссылка Дата устаревания Дата вывода из эксплуатации
2022-03-01-preview Общедоступная предварительная версия 2022-03-01-preview Ref Неприменимо Неприменимо
01.10.2020 Общедоступная версия 01.10.2020 Ссылка Неприменимо Неприменимо

Заметка

01.10.2020 Общедоступная версия Power Platform API предназначена для управления средой и также обычно называется API платформы бизнес-приложений (BAP). Функциональность этого набора конечных точек будет доступна в более новых версиях Power Platform API вместе со многими дополнительными функциями после версии 2022-03-01-preview.

Следующие шаги

Теперь, когда вы понимаете стратегию управления версиями и поддержки, давайте рассмотрим, как аутентифицироваться с помощью API Microsoft Power Platform.