Contrôle de version, support et stratégies de modification importante pour Microsoft GraphVersioning, support, and breaking change policies for Microsoft Graph

Cet article décrit la prise en charge et les stratégies de modification importante pour Microsoft Graph et les versions de l’API Microsoft Graph qui sont actuellement disponibles.This article describes the support and breaking change policies for Microsoft Graph and the versions of the Microsoft Graph API that are currently available.

Stratégie de prise en charge et informations d’obsolescenceSupport policy and deprecation information

Microsoft Graph suit la politique concernant le cycle de vie de Microsoft.Microsoft Graph follows the Microsoft Lifecycle Policy.

Lorsque de nouvelles versions des API REST Microsoft Graph et des kits de développement logiciel Microsoft Graph sont publiées, les versions antérieures sont supprimées. Microsoft déclare une version comme déconseillée au moins 24 mois avant le retrait d’une API ou d’un kit de développement logiciel.As new versions of the Microsoft Graph REST APIs and Microsoft Graph SDKs are released, earlier versions will be retired. Microsoft will declare a version as deprecated at least 24 months in advance of retiring an API or an SDK.

Lorsque nous incrémentons la version principale de l’API (par exemple, de la version 1.0 à la version 2.0), nous annonçons que la version actuelle (dans cet exemple, v1.0) est immédiatement déconseillée et que nous ne la prendrons plus en charge 24 mois après l’annonce.When we increment the major version of the API (for example, from v1.0 to v2.0), we are announcing that the current version (in this example, v1.0) is immediately deprecated and we will no longer support it 24 months after the announcement. Nous pouvons définir des exceptions à cette stratégie en cas de problèmes de sécurité du service ou de fiabilité de l’intégrité.We might make exceptions to this policy for service security or health reliability issues.

Lorsqu’une API est marquée comme obsolète, nous vous recommandons vivement de migrer vers la dernière version dès que possible.When an API is marked as deprecated, we strongly recommend that you migrate to the latest version as soon as possible. Dans certains cas, juste après avoir déconseillé l’utilisation des API d’origine, nous annoncerons que de nouvelles applications doivent commencer à utiliser les nouvelles API.In some cases, we will announce that new applications will have to start using the new APIs a short time after the original APIs are deprecated. Dans ces cas, seules les applications actives qui utilisent actuellement les API déconseillées peuvent continuer à les utiliser.In those cases, only active applications that currently use the deprecated APIs can continue to use them.

Contrat de l’API et modifications qui ne sont pas à compatibilité descendanteAPI contract and non-backward compatible changes

Microsoft Graph possède un journal des modifications entre les versions. Ces modifications sont répertoriées dans le journal des modifications de Microsoft Graph. Lorsque de nouvelles fonctionnalités et données sont ajoutées à Microsoft Graph, nous incrémentons le numéro de version API pour toutes les modifications apportées à l’API qui ne sont pas à compatibilité descendante.Microsoft Graph has a log of changes across versions. These changes are listed in the Microsoft Graph Changelog. As new functionality and data is added to Microsoft Graph, we will increment the API version number for any non-backward compatible changes to the API.

Voici quelques exemples de modifications qui ne sont pas à compatibilité descendante :The following are examples of non-backward compatible changes:

  • Modifications apportées à l’URL ou à une requête/réponse fondamentale associée à une ressourceChanges to the URL or fundamental request/response associated with a resource
  • Suppression, changement de nom ou modification du type d’une propriété déclaréeRemoval, rename, or change to the type of a declared property
  • Suppression ou modification du nom des API ou des paramètres de l’APIRemoval or rename of APIs or API parameters
  • Ajout d’un en-tête de requête requisAddition of a required request header

Voici quelques exemples de modifications à compatibilité descendante :The following are examples of backward compatible changes:

  • Ajout de propriétés qui peuvent avoir la valeur Null ou comportent une valeur par défautAddition of properties that are nullable or have a default value
  • Ajout d’un membre à une énumérationAddition of a member to an enumeration
  • Suppression, changement de nom ou modification du type d’une extension d’ouvertureRemoval, rename, or change to the type of an open extension
  • Suppression, changement de nom ou modification du type d’une annotationRemoval, rename, or change to the type of an annotation
  • Présentation de pagination pour des collections existantesIntroduction of paging to existing collections
  • Modifications apportées aux codes d’erreurChanges to error codes
  • Modifications apportées à l’ordre des propriétésChanges to the order of properties
  • Modifications apportées à la longueur ou au format de chaînes opaques, notamment des ID de ressourceChanges to the length or format of opaque strings, such as resource IDs

Remarque : Au fil du temps, nous mettrons à jour la liste des modifications à compatibilité descendante. Si vous générez vos propres proxys clients (par exemple, les clients WCF), nous vous conseillons de préparer vos applications clientes à recevoir des propriétés et des types dérivés qui n’ont pas été préalablement définis par le service API Microsoft Graph. L’API Microsoft Graph suit les instructions décrites dans la section Contrôle de version des modèles dans les instructions de l’API REST Microsoft.Note: Over time, we will update the list of backward compatible changes. If you generate your own client proxies (like WCF clients), our guidance is that your client applications should be prepared to receive properties and derived types not previously defined by the Microsoft Graph API service. Microsoft Graph API follows the guidance described in the Model Versioning section in the Microsoft REST API guidelines.

VersionsVersions

Les versions suivantes de l’API Microsoft Graph sont actuellement disponibles.The following versions of the Microsoft Graph API are currently available.

Version bêtaBeta version

Présentée sous https://graph.microsoft.com/beta, la version bêta de l’API Microsoft Graph contient des fonctionnalités qui sont actuellement en version préliminaire.Exposed under https://graph.microsoft.com/beta, the Microsoft Graph API beta version contains features that are currently in preview. Pour une documentation de l’API bêta, voir Référence du point de terminaison bêta de Microsoft Graph.For beta API documentation, see Microsoft Graph beta endpoint reference. Prévoyez des modifications importantes de la version bêta de temps à autre.Expect breaking changes to the beta version from time to time. Ne prenez pas une dépendance de production sur les API /bêta.Do not take a production dependency on /beta APIs.

Nous ne fournissons aucune garantie qu’une fonctionnalité bêta sera promue vers la version actuelle. Lorsque l’équipe de l’API Microsoft Graph pense qu’une fonctionnalité bêta est prête pour la disponibilité générale (GA), nous ajoutons cette fonctionnalité à la dernière version actuelle. Si la promotion de la fonctionnalité est susceptible d’entraîner une modification importante dans la version actuelle, le numéro de version est incrémenté, la nouvelle version devenant la version actuelle. Notre communauté de développeurs peut publier une requête de fonctionnalité sur UserVoice, y compris les requêtes de nouvelles fonctionnalités ainsi que les demandes de promotion des API bêta existantes vers la version actuelle.We make no guarantees that a beta feature will be promoted to the current version. When the Microsoft Graph API team believes that a beta feature is ready for general availability (GA), we will add that feature to the latest current version. If the promotion of the feature would result in a breaking change to the current version, the version number will be incremented, with the new version becoming the current version. Our developer community can post feature request on UserVoice, including requests for new features as well as requests to promote existing beta APIs to the current version.

Version actuelleCurrent version

La version actuelle de Microsoft Graph est la version 1.0. Présentée sous https://graph.microsoft.com/v1.0, la version /v1.0 de l’API Microsoft Graph contient des fonctionnalités qui sont généralement disponibles et prêtes pour une utilisation en production. Vous pouvez parcourir la documentation de la version 1.0 des API dans la table des matières.The current version of Microsoft Graph is v1.0. Exposed under https://graph.microsoft.com/v1.0, the Microsoft Graph API /v1.0 version contains features that are generally available and ready for production use. You can browse the documentation for the v1.0 APIs in the table of contents.

Versions déconseillées et non prises en chargeDeprecated and unsupported versions

Il n’existe actuellement aucune version déconseillée de Microsoft Graph.There are currently no deprecated versions of Microsoft Graph.

Conditions d’utilisationTerms of use

En utilisant les API Microsoft Graph, vous acceptez les conditions d’utilisation.By using the Microsoft Graph APIs, you agree to the Terms of Use.

Votre avis compte beaucoup pour nous. Échangez avec nous sur Stack Overflow. Ajoutez la balise {microsoftgraph} à votre question.Your feedback is important to us. Connect with us on StackOverflow. Tag your questions with {MicrosoftGraph}.