Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
Comme une nouvelle version de l’API REST est publiée, les versions antérieures sont supprimées. Microsoft déclare une version déconseillée au moins 12 mois avant de mettre hors service un point de terminaison d’API. Lorsqu’une version est déconseillée, elle est prise en charge as-is. Si vous rencontrez un problème avec cette version, nous vous demandons de passer à la version actuellement stable. Lorsqu’une version est supprimée, elle n’est pas prise en charge et sera bientôt arrêté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.
Les différents outils et kits SDK générés par-dessus l’API Power Platform, comme l’interface CLI Power Platform, le connecteur Admin V2 et PowerShell, sont mis à jour vers des versions d’API plus récentes par action et sont transparents pour les utilisateurs finaux.
Modifications compatibles et révolutionnaires
Microsoft fournit des détails sur les modifications de programmabilité dans les plans de publication. Si les modifications ne sont pas insécables, la version de l’API reste la même et la version de PowerShell reçoit un incrément de version mineure. Si les modifications se décomposent en nature, Microsoft incrémente la version de l’API et la version principale de PowerShell.
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 modifications non cassantes :
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Stable | Référence | S.O. | S.O. |
| 01/03/2022-Version préliminaire | Version préliminaire publique | 2022-03-01-aperçu Réf | 2025-03-01 | 2026-03-01 |
| 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. Les fonctionnalités de cet ensemble de points de terminaison sont disponibles dans les versions plus récentes de l’API Power Platform, ainsi que de nombreuses fonctionnalités supplémentaires après la version 2022-03-01-preview.
É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.