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), 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. 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 angeben, dass neue Anwendungen mit der Verwendung der neuen APIs beginnen müssen, kurz nachdem die ursprünglichen APIs veraltet sind. In diesen Fällen können nur aktive Anwendungen, die derzeit die veralteten APIs verwenden, diese weiterhin verwenden.

Änderungen am API-Vertrag und nicht abwärtskompatible Ä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, wird die API-Versionsnummer für alle nicht abwärtskompatiblen Änderungen an der API erhöht.

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

• Ä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 in 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 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 Entwicklercommunity kann im Ideenforum der Microsoft 365-Entwicklerplattform Featureanforderungen veröffentlichen, beispielsweise Anforderungen für neue Features sowie Anforderungen zur Höherstufung vorhandener Beta-APIs in 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. Navigieren Sie zur Dokumentation für die v1.0-APIs.

Vorschaustatus

Eine API oder ein Feature in Microsoft Graph wird als "(Vorschau)" bezeichnet, um anzugeben, dass das Verhalten eindeutig im Betaendpunkt 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 den Produktions-Apps nicht auf APIs vom Betaendpunkt 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 zur Angriffssimulation nur im Betaendpunkt in Microsoft Graph 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-*].