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


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

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

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

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 месяцев после объявления. То же самое относится и к общедоступным предварительным версиям. Microsoft могут быть сделаны исключения из этой политики в случае проблем с работоспособностью и безопасностью услуг.

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

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

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

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

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

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

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

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

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

Заметка

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

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

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