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 erklærer en versjon avskrevet minst 12 måneder før de 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.
Når Microsoft øker versjonsnummeret for API-en (for eksempel fra 2021-10-01 til 2022-04-01), kunngjør de at den tidligere allment tilgjengelige versjonen (2021-10-01 i dette eksemplet) blir avskrevet umiddelbart og trukket tilbake om 12 måneder etter kunngjøringen. Det samme gjelder for offentlige forhåndsversjoner. Microsoft kan gjøre unntak fra denne policyen i tilfelle problemer med tjenestetilstand og -sikkerhet.
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 gir detaljer om endringer i programmerbarhet i versjonsplanene. Hvis endringene ikke ødelegger noe, forblir API-versjonen den samme, og PowerShell-versjonen får en underordnet versjonsøkning. Hvis endringene er ødeleggende, økes API-versjonen og PowerShell-hovedversjonen trinnvis.
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-preview Ref | Ikke tilgjengelig | Ikke tilgjengelig |
2020-10-01 | Tilgjengelig | 2020-10-01 Ref | 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.