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. Microsoft deklaruje zastaralou verzi nejméně 12 měsíců předtím, než vyřadí API koncový bod. 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) Microsoft oznámí, že předchozí obecně dostupná verze (v tomto příkladu 2021-10-01) je okamžitě zastaralá a bude vyřazena 12 měsíce po oznámení. Stejné zacházení platí pro verze Public Preview. Microsoft může učinit výjimky z této zásady pro problémy se zdravím a zabezpečením služby.
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 jsou změny svou podstatou nefunkční, Microsoft zvýší verzi API a hlavní verzi PowerShellu.
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-náhled Ref | – | – |
| 1. 10. 2020 | Obecně dostupné | 2020-10-01 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.