Керування версіями та підтримка
У цій статті наведено огляд політик керування версіями та критичних змін для різноманітних інструментів програмування.
Інформація про підтримку та вилучення
API Power Platform — це засіб програмування для отримання нових версій та функцій, до якого рекомендовано звернутися в першу чергу, до інших пакетів SDK, таких як PowerShell, з’єднувачі керування та CLI Power Platform. У разі випуску нових версій 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 Посилання | Немає | Немає |
Нотатка
Загальнодоступна версія 2020-10-01 API Power Platform спеціально призначена для керування середовищами. Вона зазвичай називається API платформи бізнес-програм (BAP). Функціональні можливості цього набору кінцевих точок стануть доступні в нових версіях API Power Platform разом із багатьма додатковими функціями після завершення попереднього перегляду версії 2022-03-01.
Наступні кроки
Тепер, коли ви розумієте стратегію керування версіями та підтримкою, розгляньмо, як пройти процедуру автентифікації за допомогою API Microsoft Power Platform.