Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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
Jak je vydána nová verze rozhraní REST API, starší verze se vyřadí z důchodu. Microsoft deklaruje verzi, která je zastaralá nejméně 12 měsíců, než vyřadí koncový bod rozhraní API. Pokud je verze zastaralá, podporuje se as-is. Pokud narazíte na problém s danou verzí, požádáme vás, abyste přešli na aktuálně stabilní verzi. Když je verze vyřazená, nepodporuje se a brzy se vypne.
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.
Různé nástroje a sady SDK, které se generují nad rozhraním API platformy Power Platform, jako je Power Platform CLI, konektor pro správu V2 a PowerShell, se aktualizují na novější verze rozhraní API na základě akce a jsou pro koncové uživatele transparentní.
Kompatibilní změny a změny způsobující chybu
Společnost Microsoft poskytuje podrobnosti o programovatelných změnách v plánech vydaných verzí. Pokud změny nejsou v podstatě zásadní, verze rozhraní API zůstane stejná a verze PowerShellu obdrží přírůstek podverze. Pokud jsou změny v podstatě zásadní, Microsoft zvýší verzi rozhraní 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.
Tady jsou příklady nefunkčních změn:
- 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í |
|---|---|---|---|---|
| 2024-10-01 | Stabilní | Odkaz | – | – |
| 2022-03-01-preview | Public Preview | 2022-03-01-náhled Ref | 2025-03-01 | 2026-03-01 |
| 1. 10. 2020 | Obecně dostupné | 2020-10-01 Odkaz | – | – |
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). Funkce této sady koncových bodů jsou k dispozici 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.