Versionsstyring og support
Denne artikel indeholder en oversigt over versioner og politikker for vigtige ændringer for de forskellige programmeringsværktøjer.
Oplysninger om understøttelse og udfasning
Power Platform API'en er det første programværktøj, der modtager nye versioner og funktioner før andre SDK'er som PowerShell, Management Connectors og Power Platform CLI. Når der udgives en ny version REST API'en, udfases tidligere versioner. Microsoft erklærer en version, der er udfaset mindst 12 måneder, før den udfaser et API-slutpunkt. Når en version er udfaset, understøttes den stadig, som den er. Hvis der opstår problemer med den pågældende version, bliver du anmodet om at gå til den version, der i øjeblikket er generelt tilgængelig. Når en version er udfaset, understøttes den ikke, og den lukkes snart.
Ved at øge versionsnummeret på API'en (f.eks. fra 2021-10-01 til 2022-04-01),meddeler, Microsoft at den tidligere generelt tilgængelige version (i dette eksempel 2021-10-01) straks udfases og vil blive udfaset 12 måneder efter meddelelsen. Der er samme sker for offentlige forhåndsversioner. Microsoft kan gøre undtagelser fra denne politik for tjenestetilstands- og sikkerhedsproblemer.
I forbindelse med PowerShell-cmdletter bliver trinvise versioner tilgængelige til løsning af mindre fejlrettelser. Større versioner øges, så de svarer til de nye API-versioner, der opstår.
Kompatible og vigtige ændringer
Microsoft vil give oplysninger om ændringer i programmerbarheden i udgivelsesplanerne. Hvis ændringerne ikke er vigtige, forbliver API-versionen den samme, og PowerShell-versionen modtager en mindre versionsstigning. Hvis ændringerne ikke bryder i karakter, Microsoft øges API-versionen og PowerShell-hovedversionen.
Her er nogle eksempler på vigtige ændringer:
- URL-adressen eller grundlæggende forespørgsel/svar er ændret.
- En erklæret egenskab er fjernet eller omdøbt, eller typen er ændret.
- API'en- eller API-parametrene er fjernet eller omdøbt.
- En obligatorisk anmodningsparameter er tilføjet.
Her er nogle eksempler på ikke-vigtige ændringer:
- Der er tilføjet egenskaber, som kan være nul, eller som har en standardværdi.
- Et medlem er føjet til en optælling.
- Sideinddeling er introduceret for eksisterende samlinger.
- Fejlkoder er ændret.
- Rækkefølgen af egenskaber i forespørgsler eller svar er ændret.
Tilgængelige versioner
| Version | Type | Reference | Dato for udfasning | Dato ude af drift |
|---|---|---|---|---|
| 2022-03-01-forhåndsversion | Offentlig forhåndsversion | 2022-03-01-forhåndsvisning Ref | I/R | I/R |
| 01-10-2020 | Generelt tilgængelig | 2020-10-01 Ref | I/R | I/R |
Bemærk
Den tilgængelige version Power Platform af API fra 01-10-2020 er specifik for miljøstyring og kaldes også BAP-API 'en (Business Application Platform). Funktionaliteten af dette sæt slutpunkter bliver gjort tilgængelig i de nyere versioner af Power Platform API sammen med mange ekstra funktioner efter 01-03-2022-forhåndsversion.
Næste trin
Nu, hvor du forstår strategien for versionsstyring og understøttelse, kan vi se nærmere på, hvordan du godkender med Microsoft Power Platform API.