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í. 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.
Available versions
| Version | Typ | 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
Obecně dostupná verze Power Platform API z roku 2020-10-01 je specifická pro správu prostředí a běžně se také označuje jako Business Application Platform (BAP) API. Funkce této sady koncových bodů jsou dostupné v novějších verzích API Power Platform.
Next steps
Nyní, když rozumíte strategii správy verzí a podpory, projděme ověřování pomocí API Microsoft Power Platform.