Freigeben über

Häufig gestellte Fragen zu getakteten APIs und Diensten in Microsoft Graph

  • Artikel

Dieser Artikel enthält Antworten auf häufig gestellte Fragen zu getakteten APIs und Diensten in Microsoft Graph.

Häufig gestellte Fragen zur Abrechnungseinrichtung

Welche Berechtigungen sind zum Einrichten der Abrechnung erforderlich?

Das Einrichten der Abrechnung erfordert Berechtigungen sowohl für die Anwendungsregistrierung als auch für das Azure-Abonnement, das Sie verwenden möchten. Erforderliche Berechtigungen für die Anwendungsregistrierung sind Anwendungsbesitzer oder Anwendungsadministrator. Erforderliche Berechtigungen für das Azure-Abonnement sind Abonnementmitwirkender, Besitzer/Ressourcengruppenmitwirkender oder Besitzer.

Kann ich einen Dienstprinzipal verwenden, um die Abrechnung für meine App-Registrierung einzurichten?

Ja, es ist ein Anwendungsadministrator oder eine ähnliche Rolle für die App-Registrierung erforderlich, die dem Dienstprinzipal zugewiesen ist. Die Rolle kann nur auf die Für die Abrechnung eingerichtete Zielanwendung festgelegt werden, um zu verhindern, dass übermäßig umfassende Berechtigungen erteilt werden.

Kann ich eine verwaltete Identität verwenden, um die Abrechnung für meine App-Registrierung einzurichten?

Ja, Sie können eine verwaltete Identität für Azure-Ressourcen erstellen. Weisen Sie Ihrem Abonnement oder Ihrer Ressourcengruppe die rollenbasierte Zugriffssteuerung zu, und fügen Sie dem Dienstprinzipal, der der verwalteten Identität zugeordnet ist, die Rolle Microsoft Entra-Anwendungsadministrator hinzu. Weitere Informationen finden Sie unter Tutorial: Verwenden einer Windows-VM/VMSS für den Zugriff auf Azure-Ressourcen für ein Beispiel.

Wie kann ich überprüfen, ob meine Anwendung ordnungsgemäß für die Abrechnung eingerichtet ist?

Informationen zum Überprüfen der Abrechnungseinrichtung finden Sie unter Aktivieren von getakteten APIs und Diensten.

Häufig gestellte Fragen zur Abrechnung der Microsoft Teams-Export-API

Gibt es weitere Anforderungen, die über das Einrichten der Abrechnung für das Aufrufen von Microsoft Teams-Export-APIs hinausgehen?

Ja, Microsoft Teams-Export-APIs erfordern, dass ein model Parameter als Teil des API-Aufrufs übergeben wird. Abhängig vom Wert des model Parameters kann auch für bestimmte Daten eine Benutzerlizenz erforderlich sein. Weitere Informationen finden Sie unter Teams-API-Zahlungsmodelle und Lizenzierungsanforderungen.

Woher weiß ich, welcher Modellparameter in API-Aufrufen verwendet wird?

Der beste Weg, um zu ermitteln, welcher model Parameter verwendet wird, besteht darin, den Code der aufrufenden Anwendung zu untersuchen.

Wie wird die Seedingkapazität berechnet?

Die Seedingkapazität für Teams-Export-APIs, die mit dem model=a Parameter aufgerufen werden, wird basierend auf der Anzahl der berechtigten Benutzer im Zielmandanten berechnet. Die Seedingkapazität wird dann auf jede Anwendung angewendet, die für diesen Mandanten ausgeführt wird.

Wie wird die Seedingkapazität angewendet?

Die Seedingkapazität wird zu Beginn des Monats ausgewertet, und alle berechtigten Lizenzen zählen zur Berechnung der Seedingkapazität auf Mandantenebene. Jede Anwendung nutzt dann die ihr zugeordnete Seedingkapazität, bis sie erschöpft ist. Der weitere Verbrauch durch die Anwendung wird dann gemessen und auf der monatlichen Rechnung angezeigt.

Was geschieht, wenn eine App, die registriert, aber nicht für die Abrechnung eingerichtet ist, einen getakteten Teams-Export-API-Aufruf initiiert?

Der API-Aufruf schlägt mit dem Fehler 402 payment required fehl. Dies geschieht auch, wenn ein Benutzer mit einer gültigen Benutzerlizenz als Ziel verwendet und der model=a Parameter übergeben wird.

Was geschieht, wenn der Modellparameter von einem Aufruf einer Microsoft Teams-Export-API ausgeschlossen wird, für die er erforderlich ist?

Beim Aufrufen einer API ohne einen erforderlichen model Parameter verwendet die API standardmäßig das Verhalten im Auswertungsmodus. Der Auswertungsmodus bietet eine begrenzte Anzahl von API-Aufrufen pro Monat, bevor der Fehler "402 payment required" zurückgegeben wird. Der Auswertungsmodus wird nur für die Auswertung und Entwicklung bereitgestellt und ist nicht für die Verwendung in der Produktion vorgesehen.

Häufig gestellte Fragen zu Anwendungsconsumer

Warum bittet mich mein Anwendungsanbieter, die Abrechnung einzurichten?

Der Besitzer der Anwendungsregistrierung übernimmt die Abrechnung für getaktete APIs und Dienste in Microsoft Graph. Wenn Sie eine Anwendung erworben haben, für die Sie der Besitzer der Anwendungsregistrierung sein müssen, sind Sie für alle getakteten APIs und Dienste verantwortlich, die von der Anwendung verwendet werden.

Benötige ich Lizenzen für jeden Benutzer in meinem Mandanten?

Für jeden Benutzer, der Sicherheits- und Konformitätsrichtlinien unterliegt, ist eine Lizenz erforderlich. Für andere Szenarien ist möglicherweise keine Lizenz erforderlich. Weitere Informationen finden Sie unter Teams-API-Zahlungsmodelle und Lizenzierungsanforderungen.

Häufig gestellte Fragen zur Kostenverwaltung und Abrechnung

Wo kann ich die Abrechnungsinformationen für getaktete APIs und Dienste abrufen?

Abrechnungsdaten werden an das Azure-Abonnement übermittelt, das zum Erstellen der Microsoft Graph-Abrechnungsressource unter dem Dienstnamen Microsoft Graph-Dienste verwendet wird, und sind in der Regel 24 Stunden nach Abschluss der Transaktionen verfügbar.

Weitere Informationen finden Sie unter Übersicht über Azure-Kostenverwaltung und -abrechnung.

In der folgenden Tabelle sind die am häufigsten verwendeten Tools zum Überprüfen und Überwachen von Abrechnungsgebühren aufgeführt.

Typ Beschreibung
Kostenanalyse Interaktives Diagramm, das den Verbrauch anzeigt. Hinweis: Verwenden Sie die kumulierten Kosten, und filtern Sie nach dem Dienstnamen Microsoft Graph-Dienste.
Ausfuhren Erstellt detaillierte Berichte mit der gewünschten Häufigkeit (z. B. täglich oder monatlich).
Benachrichtigungen Konfiguriert Warnungen durch Kombinieren von Filtern.

Wird die Rechnung für jede API aufgeschlüsselt?

Die folgende Tabelle zeigt, wie die Abrechnungsdetails aggregiert oder unterbrochen werden können.

Typ Exports-Eigenschaft Filter für Kostenanalyse, Budgets und Warnungen
Verbrauchseinheitsinformationen MeterName, MeterId, MeterCategory, MeterSubcategory, ProductName, ConsumedService Verbrauchseinheit, Verbrauchseinheitskategorie, Unterkategorie "Verbrauchseinheit", Dienstname
Informationen zur Ressource InstanceId, ResourceType, ResourceGroup, SubscriptionGuid Ressource, Ressourcen-GUID, Ressourcentyp, Ressourcengruppe, Dienstname
Tags TenantId TenantId
AdditionalInfo AppId, TenantId

Einige Endpunkte teilen sich möglicherweise eine Verbrauchseinheit, und Abrechnungsdaten können nicht nach Endpunkt aufgeschlüsselt werden. Alternativ kann eine Client-App die clientseitige API-Protokollierung einrichten oder Microsoft Graph-Aktivitätsprotokolle verwenden.

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.

Verwandte Inhalte