Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье представлен обзор политик управления версиями и критических изменений для различных инструментов программирования.
Информация о поддержке и устаревании
После выпуска новой версии REST API более ранние версии удаляются. Корпорация Майкрософт объявляет нерекомендуемую версию не менее 12 месяцев, прежде чем она удаляет конечную точку API. Если версия устарела, она поддерживается as-is. Если у вас возникла проблема с этой версией, мы запросим переход к текущей стабильной версии. Если версия прекращена, она не поддерживается и скоро будет отключена.
Увеличивая номер версии API (например, с 2021-10-01 до 2022-04-01), Microsoft объявляется, что предыдущая общедоступная версия (в этом примере 2021-10-01) немедленно устарела и будет удалена через 12 месяцев после объявления. То же самое относится и к общедоступным предварительным версиям. Microsoft могут быть сделаны исключения из этой политики в случае проблем с работоспособностью и безопасностью услуг.
Различные средства и пакеты SDK, созданные на основе API Power Platform, например Power Platform CLI, соединителя Admin V2 и PowerShell, обновляются до более новых версий API на основе каждого действия и прозрачны для конечных пользователей.
Совместимость и критические изменения
Корпорация Майкрософт предоставляет сведения о изменениях в программе в планах выпуска. Если изменения неразрывны в природе, версия API остается той же, а версия PowerShell получает дополнительный шаг. Если изменения нарушаются в природе, корпорация Майкрософт увеличивает версию API и основную версию PowerShell.
Вот примеры критических изменений:
- URL-адрес или основной запрос/ответ изменен.
- Объявленное свойство удаляется или переименовывается, либо изменяется его тип.
- API или параметры API удалены или переименованы.
- Добавлен обязательный параметр запроса.
Ниже приведены примеры неразрывных изменений:
- Добавляются свойства, допускающие значение NULL или имеющие значение по умолчанию.
- Участник добавлен в перечисление.
- Разбиение на страницы введено в существующие коллекции.
- Коды ошибок изменены.
- Изменен порядок свойств в запросах или ответах.
Доступные версии
| Версия | Тип | Ссылка | Дата устаревания | Дата вывода из эксплуатации |
|---|---|---|---|---|
| 2024-10-01 | Стабильный | Справочные материалы | Неприменимо | Неприменимо |
| 2022-03-01-preview | Общедоступная предварительная версия | 2022-03-01-предварительный просмотр Ссылка | 2025-03-01 | 2026-03-01 |
| 01.10.2020 | Общедоступная версия | 2020-10-01 Ссылка | Неприменимо | Неприменимо |
Заметка
01.10.2020 Общедоступная версия Power Platform API предназначена для управления средой и также обычно называется API платформы бизнес-приложений (BAP). Функциональные возможности этого набора конечных точек доступны в более новых версиях API Power Platform, а также множество дополнительных функций после версии 2022-03-01-preview.
Следующие шаги
Теперь, когда вы понимаете стратегию управления версиями и поддержки, давайте рассмотрим, как аутентифицироваться с помощью API Microsoft Power Platform.