Správa verzí a podpora
Tento článek poskytuje přehled zásad správy verzí a změn způsobujících chybu pro různé nástroje programovatelnosti.
Informace o podpoře a ukončení podpory
API Power Platform je první programovatelný nástroj, který získává nové verze a funkce před jinými sadami SDK, jako je PowerShell, Management Connectors a rozhraní příkazového řádku Power Platform. S vydáním nové verze REST API budou starší verze vyřazeny. Společnost Microsoft prohlásí verzi za zastaralou nejméně 12 měsíců před ukončením podpory koncového bodu rozhraní API. Když je verze zastaralá, je stále podporována tak, jak je. Pokud narazíte na problém s touto verzí, požádáme vás o přechod na aktuálně obecně dostupnou verzi. Když je verze vyřazena, není podporována a brzy bude ukončena.
Zvýšením čísla verze rozhraní API (například z 2021-10-01 na 2022-04-01) společnost Microsoft oznamuje, že předchozí obecně dostupná verze (v tomto příkladu 2021-10-01) je okamžitě zastaralá a bude vyřazena 12 měsíců po oznámení. Stejné zacházení platí pro verze Public Preview. Společnost Microsoft může udělit výjimky z této zásady pro problémy se stavem služby a zabezpečením.
Pro rutiny PowerShell budou k dispozici přírůstkové verze řešící drobné opravy chyb. Hlavní verze budou navýšeny tak, aby odpovídaly novým verzím API, které se vyskytují.
Kompatibilní změny a změny způsobující chybu
Microsoft poskytne podrobnosti o změnách programovatelnosti v plánech vydání. Pokud změny nezpůsobují chybu, verze rozhraní API zůstane stejná a verze PowerShell obdrží menší přírůstek verze. Pokud změny způsobují chybu, Microsoft zvýší verzi rozhraní API a hlavní verzi prostředí PowerShell.
Zde jsou příklady změn způsobujících chybu:
- Je změněna adresa URL nebo základní požadavek/odpověď.
- Deklarovaná vlastnost je odebrána nebo přejmenována nebo je změněn její typ.
- Rozhraní API nebo parametry rozhraní API jsou odebrány nebo přejmenovány.
- Je přidán povinný parametr žádosti.
Zde jsou příklady změn nezpůsobujících chybu:
- Jsou přidány vlastnosti, které mají povolenu hodnotu Null nebo mají výchozí hodnotu.
- Do výčtu je přidán člen.
- Do stávajících kolekcí je zavedeno stránkování.
- Jsou změněny chybové kódy.
- Změní se pořadí vlastností v požadavcích nebo odpovědích.
Dostupné verze
| Verze | Typ | Reference | Datum konce podpory | Datum vyřazení |
|---|---|---|---|---|
| 2022-03-01-preview | Public Preview | 2022-03-01-preview Ref | – | – |
| 1. 10. 2020 | Obecně dostupné | 1. 10. 2020 ref. | – | – |
Poznámka:
Obecně dostupná verze 1. 10. 2020 rozhraní API Power Platform je specifická pro správu prostředí a běžně se také označuje jako API Business Application Platform (BAP). Funkčnost této sady koncových bodů bude zpřístupněna v novějších verzích rozhraní API Power Platform spolu s mnoha dalšími funkcemi po verzi 2022-03-01-preview.
Další kroky
Nyní, když rozumíte strategii správy verzí a podpory, projděme ověřování pomocí API Microsoft Power Platform.