Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье представлен обзор политик управления версиями и критических изменений для различных инструментов программирования.
Информация о поддержке и устаревании
После выпуска новой версии 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 или имеющие значение по умолчанию.
- Участник добавлен в перечисление.
- Разбиение на страницы введено в существующие коллекции.
- Коды ошибок изменены.
- Изменен порядок свойств в запросах или ответах.
Available versions
| Version | Type | Reference | Deprecation date | Decommission date |
|---|---|---|---|---|
| 2024-10-01 | Stable | Reference | N/A | N/A |
| 2020-10-01 | Generally available | 2020-10-01 Ref | N/A | N/A |
Note
Общедоступная версия Power Platform API 2020-10-01 специфична для управления средой и также часто называется Business Application Platform (BAP) API. Функциональность этого набора конечных точек доступна в новых версиях API Power Platform.
Next steps
Теперь, когда вы понимаете стратегию управления версиями и поддержки, давайте рассмотрим, как аутентифицироваться с помощью API Microsoft Power Platform.