Übersicht über getaktete APIs und Dienste in Microsoft Graph

  • Artikel

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:

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 Richtlinien für Versionsverwaltung, Support und Breaking Change 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 Abonnement status 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.

Verwandte Inhalte