Versionsverwaltung, Support und Richtlinien für wesentliche Änderungen für 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.

Supportrichtlinie und Informationen zu veralteten Funktionen

Microsoft Graph folgt der Microsoft-Lebenszyklusrichtlinie.

Wenn neue Versionen der Microsoft Graph-REST-APIs veröffentlicht werden, werden frühere Versionen eingestellt. Microsoft erklärt eine Version mindestens 24 Monate vor ihrer Einstellung als veraltet. Ebenso deklariert Microsoft für einzelne APIs, die die allgemeine Verfügbarkeit (GA) erreicht haben, eine API mindestens 24 Monate vor dem Entfernen aus der GA-Version als veraltet.

Für Microsoft Graph SDKs wird nur die neueste Hauptversion einer bestimmten Bibliothek unterstützt und mit neuen Features, Fehlerbehebungen und Problemumgehungen aktualisiert. Die Hauptversion, die der neuesten Version vorausgeht, wird 12 Monate ab dem Veröffentlichungsdatum der neuesten Hauptversion unterstützt, nur für Sicherheitsfixes. Es wird empfohlen, nach Möglichkeit ein Upgrade auf die neueste Version der SDKs durchzuführen.

Wenn wir die Hauptversion der API erhöhen (z. B. von v1.0 auf v2.0), kündigen wir an, dass die aktuelle Version (in diesem Beispiel v1.0) sofort veraltet ist und 24 Monate nach der Ankündigung nicht mehr unterstützt wird. 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.

Wenn eine API als veraltet gekennzeichnet ist, wird dringend empfohlen, dass Sie so bald wie möglich zur neuesten Version migrieren. In einigen Fällen werden wir ankündigen, dass neue Anwendungen die neuen APIs kurz nach der Einstellung der ursprünglichen APIs verwenden müssen. In diesen Fällen können nur aktive Anwendungen, die derzeit die veralteten APIs verwenden, diese weiterhin verwenden.

API-Vertrag und nichtbackwardkompatible Änderungen

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, erhöhen wir die API-Versionsnummer für alle nicht rückzurückkompatiblen Änderungen an der API.

Im Folgenden sind Beispiele für nicht rückzurückkompatible Änderungen aufgeführt:

• Änderungen an der URL oder an grundlegenden Anforderungen/Antworten im Zusammenhang mit einer Ressource
• Entfernen, Umbenennen oder Ändern des Typs einer deklarierten Eigenschaft
• Entfernen oder Umbenennen von APIs oder API-Parametern
• Hinzufügen eines erforderlichen Anforderungsheaders

Nachfolgend finden Sie Beispiele für abwärtskompatible Änderungen:

• Hinzufügen von Eigenschaften, die Nullwerte zulassen oder einen Standardwert aufweisen
• Hinzufügen eines Elements zu einer Aufzählung
• Entfernen, Umbenennen oder Ändern des Typs einer offenen Erweiterung
• Entfernen, Umbenennen oder Ändern des Typs einer Anmerkung
• Einführung der Auslagerung in vorhandene Sammlungen
• Änderungen an Fehlercodes
• Änderungen an der Reihenfolge von Eigenschaften
• Änderungen an der Länge oder am Format von verschlüsselten Zeichenfolgen, z. B. Ressourcen-IDs

Anmerkung: Im Laufe der Zeit wird die Liste der abwärtskompatiblen Änderungen 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.

Versionen

Die folgenden Versionen der Microsoft Graph-API stehen derzeit zur Verfügung.

Betaversion

Im Allgemeinen Starten APIs in der Betaversion und sind am Endpunkt https://graph.microsoft.com/beta verfügbar. Dokumentation zur Beta-API finden Sie in der Microsoft Graph-Beta-Endpunktreferenz. Von Zeit zu Zeit ist mit wesentlichen Änderungen an der Betaversion und mit Veraltungshinweisen von APIs zu rechnen. Die Verwendung von Beta-APIs in Produktionsanwendungen wird nicht unterstützt.

Wir übernehmen keine Garantie dafür, dass eine Betafunktion für die aktuelle Version höher gestuft wird. Wenn das Microsoft Graph-API-Team davon überzeugt ist, dass ein Betafeature für die allgemeine Verfügbarkeit bereit ist, fügen wir dieses Feature der neuesten aktuellen Version hinzu. Wenn die Heraufstufung des Features zu einem Breaking Change an der aktuellen Version führen würde, wird die Versionsnummer erhöht, wobei die neue Version zur aktuellen Version wird.

Aktuelle Version

Die aktuelle Version von Microsoft Graph ist Version 1.0. Auf diese APIs kann im https://graph.microsoft.com/v1.0 Endpunkt zugegriffen werden. Die Version 1.0 der Microsoft Graph-API enthält Features, die allgemein verfügbar und für den Produktionseinsatz bereit sind. Die v1.0-API-Dokumentation finden Sie in der Referenz zum Microsoft Graph v1.0-Endpunkt.

Vorschaustatus

Eine API oder ein Feature in Microsoft Graph wird als "(Vorschau)" bezeichnet, um anzugeben, dass ihr Verhalten im Betaendpunkt eindeutig ist.

Das Verhalten der meisten APIs und Features in Version 1.0 entspricht der Betaversion. Einige APIs werden aus einem der folgenden Gründe als "Vorschau" gekennzeichnet:

• Die APIs sind nur in der Beta verfügbar.
• Das Verhalten der APIs unterscheidet sich in der Betaversion von v1.0.

Wie jede andere API im Betaendpunkt können wir breaking changes an APIs einführen, die ohne Vorheriges als Vorschau gekennzeichnet sind. Greifen Sie in Produktions-Apps nicht über den Betaendpunkt auf APIs zu.

Anmerkung: APIs können sich auch dann in der Vorschau befinden, wenn das Feature oder Produkt selbst allgemein verfügbar ist.

Veraltete und nicht unterstützte Versionen

Derzeit sind keine Versionen von Microsoft Graph veraltet oder werden nicht unterstützt.

Nutzungsbedingungen

Durch Verwendung der Microsoft Graph-APIs stimmen Sie den Microsoft APIs-Nutzungsbedingungen zu.

Ihr Feedback ist uns wichtig. Verbinden Sie sich mit uns auf Microsoft Q&A. Markieren Sie Ihre Fragen mit [microsoft-graph-*].