Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
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í
Keďže sa vydáva nová verzia rozhrania REST API, staršie verzie sa vyradia. Spoločnosť Microsoft deklaruje verziu zastaranú najmenej 12 mesiacov predtým, ako odíde do dôchodku koncový bod rozhrania API. Keď je verzia zastaraná, je podporovaná as-is. Ak sa u vás v tejto verzii čelí problému, požiadame vás o prechod na aktuálne stabilnú verziu. Keď sa verzia vyradí, 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í. Microsoft môže urobiť výnimky z tejto politiky pre problémy so zdravím a bezpečnosťou služby.
Rôzne nástroje a súpravy SDK, ktoré sa generujú na základe rozhrania API power platformy, ako je napríklad Power Platform CLI, konektor Admin V2 a PowerShell, sa aktualizujú na novšie verzie rozhrania API pre jednotlivé akcie a sú transparentné pre koncových používateľov.
Kompatibilné a zlomové zmeny
Spoločnosť Microsoft poskytuje podrobnosti o zmenách možnosti programovania v plánoch vydania. Ak sú zmeny v prírode nerozbitné, verzia rozhrania API zostáva rovnaká a verzia prostredia PowerShell dostane menší prírastok verzie. Ak sú zmeny v prírode, Microsoft zvýši verziu rozhrania API a hlavnú verziu prostredia 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 nerozbitný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í.
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
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. Funkcionalita tejto sady koncových bodov je sprístupnená v novších verziách Power Platform API.
Next steps
Teraz, keď rozumiete stratégii vytvárania verzií a podpore, poďme si predstaviť, ako sa overovať pomocou Microsoft Power Platform API.