Versioonimine ja tugi
Selles artiklis antakse ülevaade erinevate programmistatavuse tööriistade versioonimise ja muudatuste poliitikate muutmise kohta.
Olemi tugi ja kõrvaldamine
Power Platform'i API on esimene programmeeritav tööriist, mis saab uusi versioone ja funktsioone enne teisi SDK-sid, nagu PowerShell, halduskonnektorid ja Power Platform CLI. Kuna REST API uus versioon avaldatakse, suletakse varasemad versioonid. Microsoft kuulutab versiooni aegunuks vähemalt 12 kuud enne API lõpp-punkti kasutuselt kõrvaldamist. Kui versioon on iganenud, toetatakse seda endiselt sellisel kujul, nagu see on. Kui teil on selle versiooniga probleeme, palume teil liikuda praegu üldiselt saadaolevale versioonile. Kui versioon on kasutuselt kõrvaldatud, seda ei toetata ja see suletakse peagi.
Suurendades API versiooninumbrit (näiteks 2021-10-01-lt 2022-04-01-le), teatab, Microsoft et varasem üldiselt kättesaadav versioon (antud näites 2021-10-01) on kohe aegunud ja kõrvaldatakse kasutuselt 12 kuud pärast teadaannet. Sama käsitletakse ka avalike eelversioonide puhul. Microsoft võib teha nendest eeskirjadest erandeid teenuse seisundi ja turvalisusega seotud küsimustes.
PowerShelli cmdlet-käskude puhul tehakse väiksemate veaparanduste lahendamiseks kättesaadavaks astmelised versioonid. Peamisi versioone suurendatakse, et need vastaksid uutele API versioonidele.
Ühilduvad ja murdvad muudatused
Microsoft annab väljalaskeplaanides üksikasjad programmeeritavuse muudatuste kohta. Kui muudatused pole olemuselt murdvad, jääb API versioon samaks ja PowerShelli versioon saab vaheversiooni astme. Kui muudatused on oma olemuselt murrangulised, Microsoft suurendatakse API versiooni ja PowerShelli põhiversiooni.
Siin on näiteid purustavataest muudatustest:
- URL-i või aksuaalset päringut/reageeringut muudetakse.
- Väljaaetav atribuut eemaldatakse või nimetatakse ümber või selle tüüpi muudetakse.
- API- või API parameetrid eemaldatakse või nimetatakse ümber.
- Lisatakse nõutav päringu parameeter.
Siin on näiteid mitte-purustavatest muudatustest:
- Atribuudid lisatakse, kui need on tühised või vaikeväärtused.
- Liige lisatakse loendisse.
- Lehestamine on võetud kasutusele olemasolevatesse kogudesse.
- Tõrkekoodid muutuvad.
- Atribuutide järjestust taotlustes või vastustes muudetakse.
Saadaval versioonid
| Versioon | Tüüp | Viide | Iganemisteade | Likvideerimise kuupäev |
|---|---|---|---|---|
| 2022-03-01-eelversioon | Avalik eelversioon | 2022-03-01-eelvaade Viide | Pole kohaldatav | Pole kohaldatav |
| 01.10.2020 | Üldiselt saadaval | 2020-10-01 Viide | Pole kohaldatav | Pole kohaldatav |
Märkus.
2020-10-01 Power Platform'i API üldiselt saadaolev versioon on spetsiifiline keskkonnahalduse jaoks ja seda nimetatakse tavaliselt ka ärirakendusplatvormi (BAP) API-ks. Selle lõpp-punktide komplekti funktsioonid tehakse kättesaadavaks Power Platform'i API uuemates versioonides koos paljude lisafunktsioonidega pärast versiooni 2022-03-01-eelversiooni.
Järgmised toimingud
Nüüd, kui olete aru saanud versioonimis- ja tugistrateegiast, vaatame, kuidas autentida Microsoft Power Platform'i API.