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

Im Allgemeinen Starten APIs in der Betaversion und sind am Endpunkt https://graph.microsoft.com/beta verfügbar.In general, APIs debut in the beta version and are accessible in the https://graph.microsoft.com/beta endpoint. 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. Navigieren Sie zur Dokumentation für die v1.0-APIs.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. Browse the documentation for the v1.0 APIs.

VorschaustatusPreview status

Features oder APIs werden als "(Vorschau)" gekennzeichnet, um anzugeben, dass ihr Verhalten ausschließlich für den Betaendpunkt gilt.A feature or API is labelled as "(preview)" to indicate its behavior is unique in the beta endpoint.

Das Verhalten der meisten Features und APIs in der v 1.0-Version ist mit der Betaversion gleich.The behavior of most features and APIs in the v1.0 version is in parity with the beta version. "Vorschau" beschreibt einen kleinen Teil von Features und APIs in einem der beiden folgenden Fälle:"preview" qualifies a minority of features and APIs in one of the following two cases:

  • Nur in Betaversion verfügbarAvailable in only beta
  • In Betaversion verfügbar, aber anders als in v1Available in beta differently than in v1

Wie jede andere API im Betaendpunkt können APIs, die in der Dokumentation als "(Vorschau)" gekennzeichnet sind, ohne Vorankündigung grundlegend geändert werden.Like any other API in the beta endpoint, APIs marked in the documentation as "(preview)" may experience breaking changes without notice. Greifen Sie in den Produktions-Apps nicht auf APIs vom Betaendpunkt zu.Do not access APIs from the beta endpoint in production apps.

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 Microsoft APIs Terms of Use.

Ihr Feedback ist uns wichtig.Your feedback is important to us. Nehmen Sie auf StackOverflow Kontakt mit uns auf.Connect with us on StackOverflow. Taggen Sie Ihre Fragen mit [microsoft-graph].Tag your questions with [microsoft-graph].