Versionsverwaltung, Support und Richtlinien für wesentliche Änderungen für Microsoft GraphVersioning, support, and breaking change policies for Microsoft Graph

In diesem Artikel werden der Support und die Richtlinien für wesentliche Änderungen für Microsoft Graph sowie die Versionen der Microsoft Graph-API beschrieben, die derzeit verfügbar sind.This article describes the support and breaking change policies for Microsoft Graph and the versions of the Microsoft Graph API that are currently available.

Supportrichtlinie und Informationen zu veralteten FunktionenSupport policy and deprecation information

Microsoft Graph folgt der Microsoft-Lebenszyklusrichtlinie.Microsoft Graph follows the Microsoft Lifecycle Policy.

Wenn neue Versionen der Microsoft Graph REST-APIs und Microsoft Graph-SDKs veröffentlicht werden, werden frühere Versionen eingestellt. Microsoft erklärt eine Version mindestens 24 Monate vor der Einstellung einer API oder eines SDKs als veraltet.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.

Wenn wir die Hauptversion der API erhöhen (z. B. von v1.0 auf v2.0), wird angekündigt, dass die aktuelle Version (in diesem Beispiel v1.0) sofort veraltet ist und dass diese 24 Monate nach der Ankündigung nicht mehr unterstützt wird.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. Aus Gründen der Dienstsicherheit oder aufgrund von Problemen mit der Integritätszuverlässigkeit werden wir möglicherweise Ausnahmen im Hinblick auf diese Richtlinie machen.We might make exceptions to this policy for service security or health reliability issues.

Wenn eine API als veraltet gekennzeichnet ist, wird dringend empfohlen, dass Sie so bald wie möglich zur neuesten Version migrieren.When an API is marked as deprecated, we strongly recommend that you migrate to the latest version as soon as possible. In einigen Fällen werden wir angeben, dass neue Anwendungen mit der Verwendung der neuen APIs beginnen müssen, kurz nachdem die ursprünglichen APIs veraltet sind.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. In diesen Fällen können nur aktive Anwendungen, die derzeit die veralteten APIs verwenden, diese weiterhin verwenden.In those cases, only active applications that currently use the deprecated APIs can continue to use them.

Änderungen am API-Vertrag und nicht abwärtskompatible ÄnderungenAPI contract and non-backward compatible changes

Microsoft Graph verfügt über die unterschiedlichen Versionen hinweg über ein Änderungsprotokoll. Diese Änderungen sind im Microsoft Graph-Änderungsprotokoll aufgeführt. Wenn Microsoft Graph neue Funktionen und Daten hinzugefügt werden, wird die API-Versionsnummer für alle nicht abwärtskompatiblen Änderungen an der API erhöht.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.

Nachfolgend finden Sie Beispiele für nicht abwärtskompatible Änderungen:The following are examples of non-backward compatible changes:

  • Änderungen an der URL oder an grundlegenden Anforderungen/Antworten im Zusammenhang mit einer RessourceChanges to the URL or fundamental request/response associated with a resource
  • Entfernen, Umbenennen oder Ändern des Typs einer deklarierten EigenschaftRemoval, rename, or change to the type of a declared property
  • Entfernen oder Umbenennen von APIs oder API-ParameternRemoval or rename of APIs or API parameters
  • Hinzufügen eines erforderlichen AnforderungsheadersAddition of a required request header

Nachfolgend finden Sie Beispiele für abwärtskompatible Änderungen:The following are examples of backward compatible changes:

  • Hinzufügen von Eigenschaften, die Nullwerte zulassen oder einen Standardwert aufweisenAddition of properties that are nullable or have a default value
  • Hinzufügen eines Elements zu einer AufzählungAddition of a member to an enumeration
  • Entfernen, Umbenennen oder Ändern des Typs einer offenen ErweiterungRemoval, rename, or change to the type of an open extension
  • Entfernen, Umbenennen oder Ändern des Typs einer AnmerkungRemoval, rename, or change to the type of an annotation
  • Einführung der Auslagerung in vorhandene SammlungenIntroduction of paging to existing collections
  • Änderungen an FehlercodesChanges to error codes
  • Änderungen an der Reihenfolge von EigenschaftenChanges to the order of properties
  • Änderungen an der Länge oder am Format von verschlüsselten Zeichenfolgen, z. B. Ressourcen-IDsChanges to the length or format of opaque strings, such as resource IDs

Hinweis: Die Liste von abwärtskompatiblen Änderungen wird im Laufe der Zeit aktualisiert. Wenn Sie Ihre eigenen Clientproxys (z. B. WCF-Clients) generieren, wird empfohlen, dass Ihre Clientanwendungen auf das Empfangen von Eigenschaften und abgeleiteten Typen vorbereitet sein sollten, die zuvor nicht vom Microsoft Graph-API-Dienst definiert wurden. Die Microsoft Graph-API befolgt die im Abschnitt Modellversionsverwaltung der Microsoft REST-API-Richtlinien beschriebene Anleitung.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.

VersionenVersions

Die folgenden Versionen der Microsoft Graph-API stehen derzeit zur Verfügung.The following versions of the Microsoft Graph API are currently available.

BetaversionBeta version

Die Microsoft Graph-API-Betaversion, die unter https://graph.microsoft.com/beta verfügbar gemacht wird, enthält Features, die sich derzeit_** in der Vorschau befinden**_.Exposed under https://graph.microsoft.com/beta, the Microsoft Graph API beta version contains features that are currently in preview. Dokumentation zur Beta-API finden Sie in der Microsoft Graph-Beta-Endpunktreferenz.For beta API documentation, see Microsoft Graph beta endpoint reference. Von Zeit zu Zeit ist mit wesentlichen Änderungen an der Betaversion zu rechnen.Expect breaking changes to the beta version from time to time. Verwenden Sie keine Produktionsabhängigkeit in Beta-APIs.Do not take a production dependency on /beta APIs.

Wir übernehmen keine Garantie dafür, dass eine Betafunktion für die aktuelle Version höher gestuft wird. Wenn das Microsoft Graph-API-Team der Meinung ist, dass eine Betafunktion für die allgemeine Verfügbarkeit (GA) bereit ist, wird diese Funktion der neuesten aktuellen Version hinzugefügt. Wenn die Höherstufung der Funktion zu einer wesentlichen Änderung an der aktuellen Version führen würde, wird die Versionsnummer erhöht, und die neue Version wird die aktuelle Version. Unsere Entwickler-Community kann unter UserVoice Featureanforderungen veröffentlichen, einschließlich Anforderungen für neue Features sowie Anforderungen zur Höherstufung vorhandener Beta-APIs in die aktuelle Version.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.

Aktuelle VersionCurrent version

Die aktuelle Version von Microsoft Graph ist Version 1.0. Die Version Microsoft Graph-API /v1.0, die unter https://graph.microsoft.com/v1.0 verfügbar gemacht wird, enthält Features, die allgemein verfügbar und bereit für die Produktionsverwendung sind. Sie können die Dokumentation nach den v1.0-APIs im Inhaltsverzeichnis durchsuchen.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.

Veraltete und nicht unterstützte VersionenDeprecated and unsupported versions

Es gibt zurzeit keine veralteten Versionen von Microsoft Graph.There are currently no deprecated versions of Microsoft Graph.

NutzungsbedingungenTerms of use

Durch Verwendung der Microsoft Graph-APIs stimmen Sie den Microsoft APIs-Nutzungsbedingungen zu.By using the Microsoft Graph APIs, you agree to the Terms of Use.

Ihr Feedback ist uns wichtig. Nehmen Sie auf StackOverflow Kontakt mit uns auf. Taggen Sie Ihre Fragen mit {MicrosoftGraph}.Your feedback is important to us. Connect with us on StackOverflow. Tag your questions with {MicrosoftGraph}.