Нотатка
Доступ до цієї сторінки потребує авторизації. Можна спробувати ввійти або змінити каталоги.
Доступ до цієї сторінки потребує авторизації. Можна спробувати змінити каталоги.
У цій статті наведено огляд політик керування версіями та критичних змін для різноманітних інструментів програмування.
Інформація про підтримку та вилучення
Після випуску нової версії API REST старіші версії списуються. Корпорація Майкрософт заявляє, що версія застаріла принаймні за 12 місяців до виходу кінцевої точки API. Якщо версію вилучено, вона підтримується as-is. Якщо у вас виникла проблема з цією версією, ми просимо перейти до поточної стабільної версії. Після списання версії вона не підтримується, і незабаром її буде вимкнуто.
Збільшуючи номер версії API (наприклад, з 2021-10-01 до 2022-04-01), Microsoft оголошується, що попередня загальнодоступна версія (в даному прикладі 2021-10-01) негайно вважається застарілою і буде припинена через 12 місяців після оголошення. Microsoft може робити винятки з цієї політики з питань справності та безпеки служб.
Різні інструменти та SDK, створені на основі API платформи Power Platform, наприклад Power Platform CLI, з'єднувача для адміністраторів 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.