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 und Microsoft Graph-SDKs veröffentlicht werden, werden frühere Versionen eingestellt. Microsoft erklärt eine Version mindestens 24 Monate vor ihrer Einstellung als veraltet. Gleiches gilt für einzelne APIs, die allgemein verfügbar sind (GA): Microsoft deklariert eine API mindestens 24 Monate vor dem Entfernen aus der GA-Version als veraltet.

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

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.

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. Verwenden Sie keine Produktionsabhängigkeit von 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 Ansicht 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. Unsere Entwicklercommunity kann Featureanforderungen im Ideenforum der Microsoft 365 Developer Platform posten, einschließlich Anforderungen für neue Features und Anforderungen zum Höherstufen vorhandener Beta-APIs auf die aktuelle Version.

Aktuelle 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. Durchsuchen Sie Dokumentation zu den v1.0-APIs.

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. "Vorschau" qualifiziert eine Einschränkung von APIs und Features in einem der folgenden beiden Fälle:

• Nur in Betaversion verfügbar
• In Betaversion verfügbar, aber anders als in v1.0

Wie jede andere API im Betaendpunkt können APIs, die in der Dokumentation als "(Vorschau)" gekennzeichnet sind, ohne Vorankündigung grundlegend geändert werden. Greifen Sie in Produktions-Apps nicht über den Betaendpunkt auf APIs zu.

Beispielsweise ist Angriffssimulationstraining ein Feature, das für Administratoren im Microsoft 365 Defender-Portalallgemein verfügbar war. Wenn die REST-API für das Training der Angriffssimulation in Microsoft Graph nur im Betaendpunkt verfügbar wird, wird die REST-API-Dokumentation als "(Vorschau)" bezeichnet. Die Bezeichnung "(Vorschau)" gilt für die REST-API und ihre Dokumentation in Microsoft Graph, obwohl der Dienst selbst allgemein verfügbar ist.

Veraltete und nicht unterstützte Versionen

Es gibt zurzeit keine veralteten Versionen von Microsoft Graph.

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-*].