Übersicht über getaktete APIs und Dienste in Microsoft Graph
Microsoft Graph enthält APIs, die ohne zusätzliche Kosten mit Benutzerabonnementlizenzen und APIs und Diensten verfügbar sind, die getaktet werden. Getaktete APIs und Dienste in Microsoft Graph verursachen Kosten basierend auf der Nutzung. Die Kosten können pro durchgeführtem API-Aufruf, pro in einem API-Aufruf zurückgegebenem Objekt oder durch andere Measures anfallen.
Unabhängig davon, ob getaktet oder nicht, befolgen APIs in Microsoft Graph die folgenden beiden Prinzipien:
- Besitz von Kundendaten: Kundendaten gehören dem Kunden. Erfahren Sie mehr darüber, wie Microsoft Kundendaten kategorisiert.
- Angemessener Zugriff: Der Dienst bietet innerhalb definierter Grenzen Zugriff auf Kundeninhalte.
Die Messung einiger APIs trägt dazu bei, die Integrität des aktuellen und zukünftigen Microsoft Graph-Ökosystems sicherzustellen, indem Plattformzugriff und Kosten ausgeglichen werden. Für den Fall, dass eine Microsoft Graph-API, die in Benutzerabonnementlizenzen enthalten ist, getaktet wird, wäre dies eine nicht abwärtskompatible Änderung, und die Versionsverwaltungs-, Support- und Breaking Change-Richtlinien für Microsoft Graph würden angewendet.
Eine Liste der getakteten APIs und Dienste finden Sie unter Getaktete APIs und Dienste.
API-Kategorien und -Messung
Microsoft Graph-APIs lassen sich in drei Kategorien einteilen, und die Messung kann basierend auf der Kategorie der API gelten.
Standard-APIs
Die meisten Microsoft Graph-APIs sind Standard-APIs. Diese APIs führen Standardvorgänge (Erstellen, Lesen, Aktualisieren, Löschen) für Kundeninhalte und Administrative Endpunkte aus. Angemessene Zugriffsgrenzwerte für diese APIs werden basierend auf dokumentierten Nutzungsschwellenwerten definiert. Dies trägt dazu bei, eine positive Kundenerfahrung zu gewährleisten, und fördert effiziente API-Nutzungsmuster. Der Zugriff auf Standard-APIs innerhalb der definierten Nutzungsschwellenwerte ist als Teil der Benutzerlizenz ohne zusätzliche Kosten verfügbar.
APIs mit hoher Kapazität
ApIs mit hoher Kapazität stellen sicher, dass Kunden und Entwickler zugriff auf Daten im großen Stil haben. Diese Kategorie umfasst speziell erstellte Endpunkte, Massenexport- oder Importendpunkte und Microsoft Graph-Dienste. Diese APIs können gemessen werden und zusätzliche Kosten verursachen, die über Benutzerabonnementlizenzen hinausgehen.
Erweiterte APIs
Erweiterte APIs bieten Zugriff auf angereicherte oder aggregierte Daten oder erweiterte Funktionen, die von Microsoft 365 aus erweitert werden. Die assignSensitivityLabel-API ist ein Beispiel für eine erweiterte API. Diese APIs können gemessen werden und zusätzliche Kosten verursachen, die über Benutzerabonnementlizenzen hinausgehen.
Zugreifen auf getaktete APIs
Für den Zugriff auf getaktete APIs und Dienste in Microsoft Graph muss eine Anwendung einem aktiven Microsoft Azure-Abonnement zugeordnet sein. Ausführliche Informationen zum Zuordnen einer App zu einem Abonnement finden Sie unter Aktivieren von getakteten APIs und Diensten in Microsoft Graph.
Überlegungen zur Verwendung von getakteten APIs
Beachten Sie die folgenden Überlegungen, wenn Sie getaktete APIs und Dienste in Microsoft Graph verwenden:
- Getaktete APIs können zusätzlich zu anderen häufigen Fehlern Fehler im Zusammenhang mit Ihrem Abonnementstatus zurückgeben. Ausführliche Informationen zu Microsoft Graph-Fehlern finden Sie unter Microsoft Graph-Fehler und Ressourcentypen.
- Getaktete APIs werden entsprechend der API-Nutzung abgerechnet. Achten Sie darauf, die Messungseinheit zu verstehen, damit Sie die Mit einer bestimmten API verbundenen Kosten schätzen können.
Bekannte Einschränkungen
Die folgenden Einschränkungen gelten für getaktete APIs:
- Getaktete APIs und Dienste in Microsoft Graph sind derzeit nur in der globalen Microsoft-Umgebung und nicht in nationalen Cloudbereitstellungen verfügbar, einschließlich Microsoft 365 GCC-Bereitstellungen, auf die über den weltweiten Microsoft Graph-Endpunkt zugegriffen wird. Ausführliche Informationen zu nationalen Clouds finden Sie unter Bereitstellungen für nationale Clouds.
- Die Zielanwendung muss eine vertrauliche Clientanwendung sein (z. B. Webanwendung, Web-API oder Daemon/Dienst). Öffentliche Clientanwendungen (Desktop- und mobile Anwendungen) werden nicht unterstützt.
- Verwaltete Azure-Identitäten werden nicht unterstützt, um getaktete APIs aufzurufen. Weitere Informationen finden Sie unter Azure-Dienste, die verwaltete Identitäten unterstützen.