Piezīmes
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt pierakstīties vai mainīt direktorijus.
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt mainīt direktorijus.
Šajā rakstā sniegts pārskats par versiju izveidi un izmaiņu politiku attiecībā uz dažādiem programmējamības rīkiem.
Atbalsta un novecošanas informācija
Izlaižot jaunu REST API versiju, iepriekšējās versijas tiek pārtrauktas. Microsoft paziņo, ka versija ir novecojusi vismaz 12 mēnešus pirms API galapunkta pārtraukšanas. Ja versija ir novecojusi, tā tiek atbalstīta as-is. Ja rodas problēmas ar šo versiju, lūdzam pāriet uz pašreizējo stabilo versiju. Kad versija tiek pārtraukta, tā netiek atbalstīta un drīz tiks izslēgta.
Palielinot API versijas numuru (piemēram, no 2021-10-01 uz 2022-04-01), tiek paziņots, Microsoft ka iepriekšējā vispārpieejamā versija (šajā piemērā 2021-10-01) ir nekavējoties novecojusi un tiks pārtraukta 12 mēnešus pēc paziņojuma. Microsoft var pieļaut izņēmumus šajā politikā attiecībā uz pakalpojumu veselības un drošības jautājumiem.
Dažādi rīki un SDK, kas tiek ģenerēti virs Power Platform API, piemēram, Power Platform CLI, Admin V2 savienotājs un PowerShell, tiek atjaunināti uz jaunākām API versijām katrai darbībai un ir pārredzami lietotājiem.
Saderīgas un jaunākās izmaiņas
Microsoft sniedz detalizētu informāciju par programmējamības izmaiņām laidiena plānos. Ja izmaiņas pēc būtības ir nepārtrauktas, API versija paliek nemainīga, un PowerShell versija saņem nelielu versijas palielinājumu. Ja izmaiņas ir pārtrauktas, Microsoft palielina API versiju un PowerShell galveno versiju.
Tālāk ir sniegti minētie izmaiņu piemēri:
- Tiek mainīts vietrādis URL vai papildu pieprasījums/atbilde.
- Tiek noņemts vai pārdēvēts deklaratīvais rekvizīts vai arī mainīts tā veids.
- API vai API parametri tiek noņemti vai pārdēvēti.
- Ir pievienots nepieciešamais pieprasījuma parametrs.
Tālāk ir norādīti nepārtrauktu izmaiņu piemēri.
- Tiek pievienoti rekvizīti, kuru vērtība ir nulle vai noklusējuma vērtība.
- Dalībnieks tiek pievienots uzskaitījumam.
- Tiek iepazīta lapošana esošajās kolekcijās.
- Kļūdu kodi tiek mainīti.
- Pieprasījumu vai atbilžu rekvizītu secība tiek mainīta.
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
Power Platform API 2020-10-01 vispārpieejamā versija ir specifiska vides pārvaldībai, un to parasti dēvē arī par biznesa lietojumprogrammu platformas (Business Application Platform — BAP) API. Šīs galapunktu kopas funkcionalitāte ir pieejama jaunākajās Power Platform API versijās.
Next steps
Tagad, kad izprotat versiju un atbalsta stratēģiju, apskatīsim, kā veikt autentifikāciju ar Microsoft Power Platform API.