Versjonskontroll og støtte
Denne artikkelen gir en oversikt over versjonskontroll og policyer for ødeleggende endringer for de ulike verktøyene for programmerbarhet.
Informasjon om støtte og avvikling
Power Platform-API-en er det første programmerbarhetsverktøyet som får nye versjoner og funksjoner før andre SDK-er, for eksempel PowerShell, administrasjonskoblinger og Power Platform CLI. Når en ny versjon av REST-API blir utgitt, blir tidligere versjoner trukket tilbake. Microsoft vil erklære en versjon avskrevet minst 12 måneder før den trekker tilbake et API-endepunkt. Når en versjon blir avskrevet, støttes den fortsatt som den er. Hvis du får problemer med denne versjonen, ber vi deg om å gå over til den gjeldende, allment tilgjengelige versjonen. Når en versjon er trukket tilbake, støttes den ikke og blir snart deaktivert.
Ved å øke versjonsnummeret til API-en (for eksempel fra 2021-10-01 til 2022-04-01), Microsoft kunngjør at den forrige generelt tilgjengelige versjonen (i dette eksemplet 2021-10-01) umiddelbart avskrives og vil bli trukket tilbake 12 måneder etter kunngjøringen. Det samme gjelder for offentlige forhåndsversjoner. Microsoft kan gjøre unntak fra denne policyen for tjenestetilstand og sikkerhetsproblemer.
For PowerShell-cmdleter gjøres trinnvise versjoner tilgjengelige for å løse mindre feilrettinger. Hovedversjoner økes slik at de samsvarer med de nye API-versjonene.
Kompatible og ødeleggende endringer
Microsoft vil gi detaljer om programmerbarhetsendringer i utgivelsesplanene. Hvis endringene ikke ødelegger noe, forblir API-versjonen den samme, og PowerShell-versjonen får en underordnet versjonsøkning. Hvis endringene bryter i naturen,vil Microsoft øke API-versjonen og PowerShell-hovedversjonen.
Her er noen eksempler på endringer som ødelegger noe:
- URL-adressen eller grunnleggende forespørsel/svar endres.
- En deklarert egenskap fjernes eller gis nytt navn, eller typen endres.
- APIen eller API-parametere fjernes eller gis nytt navn.
- En obligatorisk forespørselsparameter legges til.
Her er noen eksempler på endringer som ikke ødelegger noe:
- Egenskaper legges til som kan nullsettes eller ha en standardverdi.
- Et medlem blir lagt til i en opplisting.
- Sideveksling innføres for eksisterende samlinger.
- Feilkoder endres.
- Rekkefølgen på egenskapene i forespørsler eller svar endres.
Tilgjengelige versjoner
| Versjon | Type | Referanse | Avskrivningsdato | Avviklingsdato |
|---|---|---|---|---|
| 2022-03-01-preview | Offentlig forhåndsversjon | 2022-03-01-forhåndsvisning Ref | Ikke tilgjengelig | Ikke tilgjengelig |
| 2020-10-01 | Tilgjengelig | 2020-10-01 Referanse | Ikke tilgjengelig | Ikke tilgjengelig |
Merk
Den allment tilgjengelige versjonen 2020-10-01 av Power Platform-API-en gjelder miljøadministrasjon og kan også kalles API-en for forretningsprogramplattformen. Funksjonaliteten til dette settet med endepunkter blir gjort tilgjengelig i nyere versjoner av Power Platform-API-en sammen med mange tilleggsfunksjoner etter versjon 2022-03-01-preview.
Neste trinn
Nå som du forstår versjonskontroll- og kundestøttestrategien, kan vi gå gjennom hvordan du autentiserer med Microsoft Power Platform-API-en.