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. Tas pats pasakytina ir apie viešas peržiūros versijas. 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.

Galimos versijos

Versija	Tipas	Nuoroda	Nerekomendavimo data	Nustojimo naudoti data
2024-10-01	Arklidė	Nuoroda	Nėra	Nėra
2022-03-01 – peržiūra	Viešoji peržiūros versija	2022-03-01 peržiūros nuoroda	2025-03-01	2026-03-01
2020-10-01	Bendrai pasiekiama	2020-10-01 nuoroda	Nėra	Nėra

Pastaba.

2020-10-01 visuotinai prieinama „Power Platform“ API versija yra skirta tik aplinkos valdymui ir dažnai vadinama verslo programų platformos (BAP) API. Šio galinių punktų rinkinio funkcijos pasiekiamos naujesnėse "Power Platform" API versijose kartu su daug papildomų funkcijų po 2022-03-01-preview versijos.

Paskesni veiksmai

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

• Autentifikavimas
• Autentifikavimas (senstelėjęs)