Partager via

Contrôle de version et support

  • Article

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 un point de terminaison de l’API. 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, du 01/10/2021 au 01/04/2022), Microsoft annonce que la version précédente généralement disponible (dans cet exemple, 01/10/2021) 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 peut faire des exceptions à cette stratégie pour des problèmes d’intégrité 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 mise en production. 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 révolutionnaire, Microsoft incrémentera 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 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-preview Ref S.O. S.O.
2020-10-01 Généralement disponible Réf. 01-10-2020 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.