Contrôle de version et support
Cet article fournit une vue d’ensemble des stratégies de contrôle de version et de modification de rupture pour les différents outils de programmabilité.
Informations relatives au support et à la désapprobation
L’API Power Platform est le premier outil de programmabilité à recevoir de nouvelles versions et fonctionnalités avant d’autres SDK comme PowerShell, Management Connectors et CLI Power Platform. À mesure qu’une nouvelle version de l’API REST est publiée, les versions antérieures seront supprimées. Microsoft déclarera une version obsolète au moins 12 mois avant de retirer une API point de terminaison. Lorsqu’une version est obsolète, elle est toujours prise en charge telle quelle. Si vous rencontrez un problème avec cette version, nous vous demanderons de passer à la version généralement disponible actuellement. Lorsqu’une version est retirée, elle n’est pas prise en charge et sera bientôt désactivée.
En incrémentant le numéro de version de l’API (par exemple, de 2021-10-01 à 2022-04-01), Microsoft annonce que la version généralement disponible précédente (dans cet exemple, 2021-10-01) est immédiatement obsolète et sera retirée 12 mois après l’annonce. Le même traitement est appliqué aux versions de prévisualisation publiques. Microsoft pourrait faire des exceptions à cette politique pour des raisons de santé et de sécurité du service.
Pour les applets de commande PowerShell, des versions incrémentielles seront mises à disposition pour résoudre les correctifs de bogues mineurs. Les versions majeures seront incrémentées pour correspondre aux nouvelles versions d’API qui se produisent.
Modifications compatibles et révolutionnaires
Microsoft fournira des détails sur les changements de programmabilité dans les plans de publication . Si les modifications sont de nature insécable, la version de l’API restera la même et la version PowerShell recevra un incrément de version mineure. Si les modifications sont de nature disruptive, Microsoft la version de l’API et la version principale de PowerShell seront incrémentées.
Voici des exemples de changements révolutionnaires :
- L’URL ou la demande / réponse fondamentale est modifiée.
- Une propriété déclarée est supprimée ou renommée, ou son type est modifié.
- L’API ou les paramètres API sont supprimés ou renommés.
- Un paramètre de demande requis est ajouté.
Voici des exemples de changements non-révolutionnaires :
- Des propriétés sont ajoutées qui peuvent être nulles ou qui ont une valeur par défaut.
- Un membre est ajouté à une énumération.
- La pagination est introduite dans les collections existantes.
- Les codes d’erreur sont modifiés.
- L’ordre des propriétés dans les demandes ou les réponses est modifié.
Versions disponibles
| Version | Type | Référence | Date d’abandon | Date de désactivation |
|---|---|---|---|---|
| 01/03/2022-Version préliminaire | Version préliminaire publique | 2022-03-01-aperçu Réf | S.O. | S.O. |
| 2020-10-01 | Généralement disponible | 2020-10-01 Réf. | S.O. | S.O. |
Note
La version généralement disponible 01/10/2020 de l’API Power Platform est spécifique à la gestion de l’environnement et est également communément appelée API de la plate-forme d’application métier. La fonctionnalité de cet ensemble de points de terminaison sera disponible dans les nouvelles versions de l’API Power Platform ainsi que de nombreuses fonctionnalités supplémentaires après la version 01/03/2022-version préliminaire.
Étapes suivantes
Maintenant que vous comprenez la stratégie de gestion des versions et de support, voyons comment s’authentifier avec l’API Microsoft Power Platform.