Nota
L'accés a aquesta pàgina requereix autorització. Pots provar d'iniciar sessió o canviar de directori.
L'accés a aquesta pàgina requereix autorització. Pots provar de canviar directoris.
En aquest article es proporciona informació general sobre les polítiques de control de versions i els canvis d'última hora per a les diverses eines de programació.
Informació sobre suport i obsolescència
A mesura que es publica una nova versió de l'API REST, les versions anteriors es retiren. Microsoft declara una versió obsoleta almenys 12 mesos abans de retirar un punt final de l'API. Quan una versió està obsoleta, s'admet as-is. Si teniu un problema amb aquesta versió, us demanem que passeu a la versió estable actualment. Quan es retira una versió, no s'admet i aviat s'apagarà.
En incrementar el número de versió de l'API (per exemple, de 2021-10-01 a 2022-04-01), Microsoft s'anuncia que la versió anterior disponible generalment (en aquest exemple, 2021-10-01) queda immediatament obsoleta i es retirarà 12 mesos després de l'anunci. El mateix tractament tenen les versions de versió preliminar pública. Microsoft pot fer excepcions a aquesta política per problemes d'estat i seguretat del servei.
Les diverses eines i SDK que es generen sobre l'API del Power Platform, com ara l'CLI del Power Platform, el connector Admin V2 i el PowerShell, s'actualitzen a les versions més recents de l'API per acció i són transparents per als usuaris finals.
Canvis compatibles i incompatibles
Microsoft proporciona detalls dels canvis de programabilitat en els plans de llançament. Si els canvis són de naturalesa ininterrompuda, la versió de l'API continua sent la mateixa i la versió del PowerShell rep un increment de versió secundària. Si els canvis són de naturalesa trencada, Microsoft incrementa la versió de l'API i la versió principal del PowerShell.
A continuació es presenten exemples de canvis incompatibles:
- L'adreça URL o la sol·licitud/resposta fonamental han canviat.
- S'elimina o es canvia el nom d'una propietat declarada o se'n canvia el tipus.
- L'API o els paràmetres de l'API s'eliminen o es canvien de nom.
- S'afegeix un paràmetre de sol·licitud obligatori.
Aquests són exemples de canvis ininterromputs:
- S'afegeixen propietats que es poden anul·lar o tenen un valor per defecte.
- S'afegeix un membre a una enumeració.
- S'introdueix paginació a les col·leccions existents.
- Es canvien els codis d'error.
- Es canvia l'ordre de les propietats a les sol·licituds o respostes.
Versions disponibles
| Versió | Type | Referència | Data d’obsolescència | Data de retirada |
|---|---|---|---|---|
| 2024-10-01 | Estable | Referència | N/A | N/A |
| 2022-03-01-versió preliminar | Versió preliminar pública | 2022-03-01-vista prèvia Ref | 2025-03-01 | 2026-03-01 |
| 2020-10-01 | Disponible de manera general | 2020-10-01 Referència | N/A | N/A |
Nota
La versió 2020-10-01 disponible de manera general de l'API del Power Platform és específica de l'administració de l'entorn i també s'anomena API de Business Application Platform (BAP). La funcionalitat d'aquest conjunt d'extrems està disponible a les versions més recents de l'API del Power Platform juntament amb moltes característiques addicionals després de la versió 2022-03-01-preview.
Passos següents
Ara que enteneu l'estratègia de control de versions i de suport, veurem l'autenticació amb l'API del Microsoft Power Platform.