Бележка
Достъпът до тази страница изисква удостоверяване. Можете да опитате да влезете или да промените директориите.
Достъпът до тази страница изисква удостоверяване. Можете да опитате да промените директориите.
Тази статия предоставя преглед на версиите и нарушаването на политиките за промяна на различните инструменти за програмируемост.
Информация за поддръжка и отхвърляне
Когато се издава нова версия на REST API, по-ранните версии се оттеглят. Microsoft декларира версия, отхвърлена най-малко 12 месеца, преди да оттегли крайна точка на API. Когато дадена версия е отхвърлена, тя се поддържа as-is. Ако се сблъскате с проблем с тази версия, изискваме да преминете към текущата стабилна версия. Когато дадена версия бъде оттеглена, тя не се поддържа и скоро ще бъде изключена.
Чрез увеличаване на номера на версията на API (например от 2021-10-01 на 2022-04-01),обявява Microsoft , че предишната общодостъпна версия (в този пример 2021-10-01) е незабавно отхвърлена и ще бъде оттеглена 12 месеца след обявяването. Microsoft може да направи изключения от тази политика за проблеми със здравето и сигурността на услугите.
Различните инструменти и SDK, които се генерират в горната част на API на Power Platform, като CLI за Power Platform, конектора за Администратор V2 и PowerShell, се актуализират до по-нови версии на API на базата на действие и са прозрачни за крайните потребители.
Съвместими и счупващи промени
Microsoft предоставя подробни данни за промените в програмируемостта в плановете за издаване. Ако промените по своето естество са непрекъсваеми, версията на API остава същата и версията на PowerShell получава нарастване на второстепенната версия. Ако промените са в естеството си, Microsoft увеличава версията на API и основната версия на PowerShell.
Ето примери за деструктивни промени:
- URL адресът или основната заявка/отговор се променят.
- Декларираното свойство се премахва или преименува или се променя неговият тип.
- API или параметрите на API се премахват или преименуват.
- Добавен е задължителен параметър на заявка.
Ето примери за непрекъсващи промени:
- Добавят се свойства, които могат да бъдат занулени или имат стойност по подразбиране.
- Член се добавя към изброяване.
- Страниране се въвежда в съществуващите колекции.
- Кодовете за грешки се променят.
- Редът на свойствата в заявките или отговорите се променя.
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. Функционалността на този набор от крайни точки е достъпна в по-новите версии на Power Platform API.
Next steps
След като разбрахте стратегията за управление на версиите и поддръжката, нека разгледаме как да се удостоверите с Microsoft Power Platform API.