Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
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
Etter hvert som en ny versjon av REST-API-en utgis, blir tidligere versjoner fjernet. Microsoft erklærer en versjon avskrevet minst 12 måneder før den trekker tilbake et API-endepunkt. Når en versjon er avskrevet, støttes den as-is. Hvis du står overfor et problem med denne versjonen, ber vi om at du flytter til den stabile versjonen. Når en versjon trekkes tilbake, støttes den ikke og vil snart bli slått av.
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.
De ulike verktøyene og SDK-ene som genereres oppå API-en for Power Platform, for eksempel Power Platform CLI, Admin V2-koblingen og PowerShell, oppdateres til nyere API-versjoner per handling og er gjennomsiktige for sluttbrukere.
Kompatible og ødeleggende endringer
Microsoft gir detaljer om programmerbarhetsendringer i utgivelsesplanene. Hvis endringene ikke brytes i naturen, forblir API-versjonen den samme, og PowerShell-versjonen mottar en mindre versjon. Hvis endringene bryter i naturen, øker Microsoft API-versjonen og Hovedversjonen av PowerShell.
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 eksempler på ikke-brytende endringer:
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Stall | referanse | Ikke tilgjengelig | Ikke tilgjengelig |
| 2022-03-01-preview | Offentlig forhåndsversjon | 2022-03-01-forhåndsvisning Ref | 2025-03-01 | 2026-03-01 |
| 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 gjøres tilgjengelig i de nyere versjonene av Power Platform API sammen med mange tilleggsfunksjoner etter versjon 2022-03-01-forhåndsvisning.
Neste trinn
Nå som du forstår versjonskontroll- og kundestøttestrategien, kan vi gå gjennom hvordan du autentiserer med Microsoft Power Platform-API-en.