Märkus.
Juurdepääs sellele lehele nõuab autoriseerimist. Võite proovida sisse logida või kausta vahetada.
Juurdepääs sellele lehele nõuab autoriseerimist. Võite proovida kausta vahetada.
Selles artiklis antakse ülevaade erinevate programmistatavuse tööriistade versioonimise ja muudatuste poliitikate muutmise kohta.
Olemi tugi ja kõrvaldamine
REST API uue versiooni väljaandmisel kõrvaldatakse varasemad versioonid kasutuselt. Microsoft kuulutab versiooni taunituks vähemalt 12 kuud enne API lõpp-punkti kasutuselt kõrvaldamist. Kui versioon on iganenud, toetatakse seda as-is. Kui teil on selle versiooniga probleeme, palume teil üle minna praegu stabiilsele versioonile. Versiooni kasutuselt kõrvaldamisel 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.
Erinevaid tööriistu ja SDK-sid, mis genereeritakse Power Platform API peale, nagu Power Platform CLI, admin V2 konnektor ja PowerShell, värskendatakse toimingupõhiselt uuematele API versioonidele ja need on lõppkasutajatele läbipaistvad.
Ühilduvad ja murdvad muudatused
Microsoft pakub üksikasju väljalaskeplaanide programmitavusmuudatuste kohta. Kui muudatused pole püsima jäänud, jääb API versioon samaks ja PowerShelli versioon saab vaheversiooni astme. Kui muudatused on looduses katkemas, inkrementab Microsoft 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äited püsimuudatustest.
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Stabiilne | Viide | Pole kohaldatav | Pole kohaldatav |
| 2022-03-01-eelversioon | Avalik eelversioon | 2022-03-01-eelvaade Viide | 2025-03-01 | 2026-03-01 |
| 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 on saadaval Power Platform API uuemates versioonides ja paljud lisafunktsioonid pärast versiooni 2022-03-01-preview.
Järgmised toimingud
Nüüd, kui olete aru saanud versioonimis- ja tugistrateegiast, vaatame, kuidas autentida Microsoft Power Platform'i API.