Verziószámozás és támogatás

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. 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.

Available versions

Version Típus 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

A 2020-10-01-es általánosan elérhető Power Platform API verzió kifejezetten környezetkezelésre specializálódott, és gyakran Business Application Platform (BAP) API-ként is emlegetik. Ennek a végpontkészletnek a funkcionalitása elérhető a Power Platform API újabb verzióiban.

Next steps

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.

  • Last updated on