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í. 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.
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í.
Dostupné verzie
| Verzia | Type | Odkaz | Dátum ukončenia podpory | Dátum ukončenia používania |
|---|---|---|---|---|
| 2024-10-01 | Stajňa | Referencia | Neaplikovateľné | Neaplikovateľné |
| 1. 3. 2022 – verzia Preview | Verejná verzia Preview | 2022-03-01-preview ref | 2025-03-01 | 2026-03-01 |
| 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. Funkcie tejto množiny koncových bodov sú k dispozícii v novších verziách rozhrania API Power Platformy 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.