Versionshantering och support
Den här artikeln ger en översikt över policyer för versionshantering och icke-bakåtkompatibel ändring för de olika programmeringsverktygen.
Support och information om utfasning
Power Platform API är det första programmeringsverktyget för att få nya versioner och funktioner före andra SDK:er som PowerShell, Management Connectors och Power Platform CLI. När en ny version av REST-API lanseras dras tidigare versioner tillbaka. Microsoft anger att en version har inaktiverats minst 12 månader innan ett API-program för slutpunkt. När en version har inaktiverats stöds den fortfarande som den är. Om det uppstår problem med den versionen begär vi att du flyttar till den för närvarande allmänt tillgängliga versionen. När en version dras tillbaka stöds den inte och kommer snart att stängas av.
Genom att öka versionsnumret för API (till exempel från 2021-10-01 till 2022-04-01) meddelar Microsoft att den tidigare, allmänt tillgängliga versionen (i det här exemplet 2021-10-01) omedelbart tas bort och dras tillbaka 12 månader efter meddelandet. Samma sak gäller för offentliga förhandsversioner. Microsoft kan göra undantag från den här policyn för problem som rör tjänst hälsa och säkerhet.
För PowerShell-cmdlet görs versioner tillgängliga för att lösa mindre felkorrigeringar. Större versioner ökas så att de överensstämmer med de nya API-versionerna som förekommer.
Kompatibla och icke-bakåtkompatibla ändringar
Microsoft kommer att tillhandahålla information om programmerbarhetsändringar i lanseringsplaner. Om ändringarna inte förändras förblir API-versionen densamma och PowerShell-versionen får en mindre versionsökning. Om ändringarna bryts ökar Microsoft API-versionen och PowerShell-huvudversionen.
Här är några exempel på icke-bakåtkompatibla ändringar:
- URL:en eller den grundläggande förfrågan/svaret ändras.
- En egenskap som används för att göra detta tas bort eller byter namn, eller så ändras egenskapens typ.
- API- eller API-parametrarna tas bort eller byter namn.
- En önskad parameter för begäran läggs till.
Här är några exempel på icke-bakåtkompatibla ändringar:
- Egenskaper läggs till som kan vara null eller har ett standardvärde.
- En medlem läggs till i en uppräkning.
- Sidnumrering introduceras i befintliga samlingar.
- Felkoder ändras.
- Egenskapsordningen för förfrågningar eller svar ändras.
Tillgängliga versioner
| Version | Type | Referens | Utfasningsdatum | Inaktiveringsdatum |
|---|---|---|---|---|
| 2022-03-01-förhandsversion | Allmänt tillgänglig förhandsversion | 2022-03-01 exempelvisning | Inte tillgänglig | Inte tillgänglig |
| 2020-10-01 | Allmänt tillgängligt | 2020-10-01 Ref | Inte tillgänglig | Inte tillgänglig |
Kommentar
Den 2020-10-01 tillgängliga versionen av Power Platform API är specifik för miljöhantering och kallas även BAP (Business Application Platform) API. Funktionerna i den här uppsättningen slutpunkter görs tillgängliga i de nyare versionerna av Power Platform API tillsammans med många ytterligare funktioner efter 2022-03-01-förhandsgranskning.
Nästa steg
Nu när du förstår versionshanteringen och supportstrategin ska vi gå igenom hur du autentiserar med Microsoft Power Platform API.