Vytváranie verzií a podpora
Tento článok poskytuje prehľad o verziách a porušovaní zásad zmien pre rôzne programovacie nástroje.
Informácie o podpore a zastarávaní
Rozhranie Power Platform API je prvý programovací nástroj, ktorý dostáva nové verzie a funkcie pred inými súpravami SDK, ako sú PowerShell, Management Connectors a Power Platform CLI. Po vydaní novej verzie REST API budú staršie verzie vyradené. Microsoft vyhlási verziu za zastaranú najmenej 12 mesiacov predtým, ako vyradí koncový bod API. Keď je verzia zastaraná, je stále podporovaná tak, ako je. Ak narazíte na problém s touto verziou, požiadame vás, aby ste prešli na aktuálne všeobecne dostupnú verziu. Keď je verzia vyradená, nie je podporovaná a čoskoro bude vypnutá.
Zvýšením čísla verzie rozhrania API (napríklad z 2021-10-01 na 2022-04-01) Microsoft oznamuje, že predchádzajúca všeobecne dostupná verzia (v tomto príklade 2021-10-01) je okamžite zastaraná a bude vyradená 12 mesiacov po oznámení. Rovnaké zaobchádzanie sa používa pre verejné verzie Preview. Microsoft môže urobiť výnimky z tejto politiky pre problémy so zdravím a bezpečnosťou služby.
Pre rutiny cmdlet PowerShell budú k dispozícii prírastkové verzie na riešenie drobných opráv chýb. Hlavné verzie sa budú zvyšovať tak, aby zodpovedali novým verziám API, ktoré sa objavia.
Kompatibilné a zlomové zmeny
Microsoft poskytne podrobnosti o zmenách programovateľnosti v plánoch vydania. Ak zmeny nemajú zásadný charakter, verzia API zostane rovnaká a verzia PowerShell dostane prírastok vedľajšej verzie. Ak sú zmeny svojou podstatou nefunkčné, Microsoft zvýši verziu API a hlavnú verziu PowerShell.
Tu sú príklady zásadných zmien:
- URL alebo základná požiadavka/odpoveď sa zmenila.
- Deklarovaná vlastnosť je odstránená alebo premenovaná alebo je zmenený jej typ.
- API alebo parametre API sú odstránené alebo premenované.
- Je pridaný požadovaný parameter žiadosti.
Tu sú príklady nezásadných zmien:
- Pridajú sa vlastnosti, ktoré majú povolenú hodnotu Null alebo majú predvolenú hodnotu.
- Člen je pridaný do enumerácie.
- Stránkovanie je zavedené do existujúcich zbierok.
- Chybové kódy sú zmenené.
- Poradie vlastností v žiadostiach alebo odpovediach sa mení.
Dostupné verzie
| Verzia | Type | Odkaz | Dátum ukončenia podpory | Dátum ukončenia používania |
|---|---|---|---|---|
| 1. 3. 2022 – verzia Preview | Verejná verzia Preview | 2022-03-01-preview Ref | Neaplikovateľné | Neaplikovateľné |
| 2020-10-01 | Všeobecne dostupné | 2020-10-01 Ref | Neaplikovateľné | Neaplikovateľné |
Poznámka
Všeobecne dostupná verzia Power Platform API 2020-10-01 je špecifická pre správu prostredia a bežne sa označuje aj ako Business Application Platform (BAP) API. Funkčnosť tejto množiny koncových bodov bude sprístupnená v novších verziách Power Platform API spolu s mnohými ďalšími funkciami po verzii 2022-03-01-preview.
Ďalšie kroky
Teraz, keď rozumiete stratégii vytvárania verzií a podpore, poďme si predstaviť, ako sa overovať pomocou Microsoft Power Platform API.