Versijų kūrimas ir palaikymas

Šiame straipsnyje pateikiama įvairių programavimo įrankių versijų kūrimo ir gedimą sukeliančių keitimų strategijų apžvalga.

Palaikymo ir nerekomendavimo informacija

Išleidus naują REST API versiją, ankstesnės versijos nebenaudojamos. "„Microsoft“" paskelbia, kad versija buvo uždrausta bent prieš 12 mėnesių iki API galinio punkto atsisakymo. Kai versija nebenaudojama, ji palaikoma as-is. Jei susiduriate su problema dėl tos versijos, prašome pereiti prie šiuo metu stabilios versijos. Kai versija nebenaudojama, ji nepalaikoma ir netrukus bus išjungta.

Padidinus API versijos numerį (pvz., nuo 2021-10-01 iki 2022-04-01),pranešama, „Microsoft“ kad ankstesnė visuotinai prieinama versija (šiame pavyzdyje 2021-10-01) iš karto nebenaudojama ir bus pašalinta praėjus 12 mėnesių po pranešimo. „Microsoft“ gali padaryti šios strategijos išimčių dėl tarnybų sveikatos ir saugos problemų.

Įvairūs įrankiai ir SDK, sugeneruoti "Power Platform" API, pvz., "Power Platform CLI", "Admin V2" jungtis ir "PowerShell", atnaujinami į naujesnes API versijas pagal veiksmą ir yra skaidrūs galutiniams vartotojams.

Suderinami ir gedimą sukeliantys keitimai

"„Microsoft“" pateikia išsamią informaciją apie programavimo suderinamumo pakeitimus leidimų planuose. Jei pakeitimai pobūdžio neperkeliami, API versija išlieka tokia pati, o "PowerShell" versija gauna papildomos versijos pokytį. Jei pakeitimai nutraukiami, "„Microsoft“" padidina API versiją ir "PowerShell" pagrindinę versiją.

Čia pateikti didelių pakeitimų pavyzdžiai:

  • Pakeistas URL arba pagrindinė užklausa/atsakas.
  • Pašalinta arba pervadinta deklaruota ypatybė, arba pakeistas jos tipas.
  • Pašalinti arba pervadinti API arba API parametrai.
  • Įtrauktas reikiamas užklausos parametras.

Toliau pateikiami nekeliamų keitimų pavyzdžiai:

  • Įtrauktos nulinės arba numatytąją reikšmę turinčios ypatybės.
  • Į išvardijimą įtrauktas narys.
  • Į esamus rinkinius įtraukta puslapių kaita.
  • Pakeisti klaidų kodai.
  • Pakeista ypatybių tvarka užklausose arba atsakuose.

Available versions

Version Type 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

2020-10-01 visuotinai prieinama "Power Platform" API versija yra skirta aplinkos valdymui ir taip pat paprastai vadinama verslo programų platformos (BAP) API. Šio galinių punktų rinkinio funkcijos pasiekiamos naujesnėse "Power Platform" API versijose.

Next steps

Dabar, kai suprantate versijų kūrimo ir palaikymo strategiją, pereikime prie to, kaip autentifikuoti naudojant „Microsoft Power Platform” API.

  • Last updated on