Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
Ez a cikk áttekintést ad a különböző programozási eszközök verziószámozási és kompatibilitástörő változás irányelveiről.
Támogatási és elavulási információk
A REST API új verziójának megjelenésekor a korábbi verziók kivonásra kerülnek. A Microsoft legalább 12 hónappal az API-végpont kivonása előtt deklarál egy elavult verziót. Ha egy verzió elavult, az as-istámogatott. Ha az adott verzióval kapcsolatos probléma merül fel, azt kérjük, hogy lépjen a jelenleg stabil verzióra. Ha egy verziót kivonnak, az nem támogatott, és hamarosan ki lesz kapcsolva.
Az API verziószámának növelésével (például 2021-10-01-ről 2022-04-01-re) bejelenti, Microsoft hogy a korábbi általánosan elérhető verzió (ebben a példában 2021-10-01) azonnal elavult, és a bejelentés után 12 hónappal ki lesz vezetve. Ugyanez érvényes a nyilvános előzetes verziókra is. Microsoft A szolgáltatás állapotával és biztonságával kapcsolatos problémák esetén kivételeket tehet ez alól a szabályzat alól.
A Power Platform API-n, például a Power Platform CLI-n, a felügyeleti V2-összekötőn és a PowerShellen létrehozott különböző eszközök és SDK-k műveletenként frissülnek az újabb API-verziókra, és átláthatók a végfelhasználók számára.
Kompatibilis és kompatibilitástörő változások
A Microsoft részletesen ismerteti a kiadási csomagok programozhatósági változásait. Ha a módosítások nem törnek meg, az API-verzió változatlan marad, és a PowerShell-verzió egy kisebb verziónövekményt kap. Ha a módosítások a természetüket megtörik, a Microsoft növeli az API-verziót és a PowerShell főverziót.
Íme néhány példa a kompatibilitástörő változásokra:
- Megváltozik az URL-cím vagy az alapvető kérés/válasz.
- A deklarált tulajdonságot eltávolítják vagy átnevezik, vagy annak típusa megváltozik.
- Eltávolították vagy átnevezik az API-t vagy az API-paramétereket.
- Hozzáadnak egy kötelező kérési paramétert.
Íme néhány példa a nem törhető módosításokra:
- Tulajdonságokat adnak hozzá, amelyek nullázhatók, vagy alapértelmezett értékkel rendelkeznek.
- A tagokat hozzáadják egy felsoroláshoz.
- Oldalszámozást vezetnek be a meglévő gyűjtemények számára.
- A hibakódok módosulnak.
- A tulajdonságok sorrendje megváltozik a kérelmekben és a válaszokban.
Elérhető verziók
| Verzió | Típus | Referencia | Elavulás dátuma | Kivezetés dátuma |
|---|---|---|---|---|
| 2024-10-01 | Stabil | Utalás | n/a | n/a |
| 2022. 03. 01. előzetes verzió | Nyilvános előzetes verzió | 2022-03-01-előnézet Ref | 2025-03-01 | 2026-03-01 |
| 2020. 10. 01. | Általánosan elérhető | 2020.10.01. | n/a | n/a |
Feljegyzés
A 2020-10-01 Power Platform API általánosan elérhető verziója a környezet kezelésére jellemző, és általában Üzleti alkalmazás platform (BAP) API. A végpontok ezen készletének funkciói a Power Platform API újabb verzióiban, valamint a 2022-03-01-preview verzió után számos további funkcióval együtt elérhetővé válnak.
További lépések
Most, hogy már megértette a verziószámozási és támogatási stratégiát, végigjárjuk a Microsoft Power Platform API használatával történő hitelesítést.