Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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
När en ny version av REST-API:et släpps dras tidigare versioner tillbaka. Microsoft deklarerar en inaktuell version minst 12 månader innan den drar tillbaka en API-slutpunkt. När en version är inaktuell stöds den as-is. Om du har problem med den versionen begär vi att du flyttar till den för närvarande stabila versionen. När en version har dragits tillbaka stöds den inte och kommer snart att stängas av.
Genom att öka versionsnumret för API:et (till exempel från 2021-10-01 till 2022-04-01) Microsoft meddelar att den tidigare allmänt tillgängliga versionen (i det här exemplet 2021-10-01) blir omedelbart inaktuell och kommer att 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 principen för problem med tjänstens hälsa och säkerhet.
De olika verktyg och SDK:er som genereras ovanpå Power Platform-API:et, till exempel Power Platform CLI, Admin V2-anslutningsappen och PowerShell, uppdateras till nyare API-versioner per åtgärd och är transparenta för slutanvändare.
Kompatibla och icke-bakåtkompatibla ändringar
Microsoft tillhandahåller information om programmability-ändringar i lanseringsplanerna. Om ändringarna inte går att bryta i naturen förblir API-versionen densamma och PowerShell-versionen får en delversionsökning. Om ändringarna bryts i naturen ö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 exempel på icke-inbrytningsä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 |
|---|---|---|---|---|
| 2024-10-01 | Stabil | Referens | Inte tillgänglig | Inte tillgänglig |
| 2022-03-01-förhandsversion | Allmänt tillgänglig förhandsversion | 2022-03-01-preview Ref | 2025-03-01 | 2026-03-01 |
| 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 version 2022-03-01-preview.
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.