Microsoft Graph – dienstspezifische Drosselungslimiten
Microsoft Graph ermöglicht ihnen den Zugriff auf Daten in mehreren Diensten, z. B. Outlook oder Microsoft Entra ID. Diese Dienste setzen ihre eigenen Einschränkungsbeschränkungen ein, die sich auf Anwendungen auswirken, die Microsoft Graph für den Zugriff auf diese Dienste verwenden.
Jede Anforderung kann anhand von mehreren Einschränkungen ausgewertet werden – und zwar je nach dem Gültigkeitsbereich der Einschränkung (pro App in allen Mandanten, pro Mandant für alle Apps, pro App pro Mandant usw.), dem Anforderungstyp (GET, POST, PATCH usw.) und anderen Faktoren. Die erste zu erreichende Einschränkung löst ein Einschränkungsverhalten aus. Zusätzlich zu den im Abschnitt beschriebenen dienstspezifischen Einschränkungen gelten die folgenden globalen Einschränkungen:
Anforderungstyp | Pro App in allen Mandanten |
---|---|
Beliebig | 130.000 Anforderungen pro 10 Sekunden |
Hinweis
Die hier beschriebenen spezifischen Beschränkungen können sich ändern.
In diesem Abschnitt bezieht sich der Begriff Mandant auf die Microsoft 365-Organisation, in der die Anwendung installiert ist. Dieser Mandant kann mit dem identisch sein, auf dem die Anwendung erstellt wurde (im Fall einer Anwendung mit nur einem Mandanten), oder er kann sich von diesem unterscheiden (im Fall einer Anwendung mit mehreren Mandanten).
Diensteinschränkungen für Zuweisung
Die folgenden Grenzwerte gelten für Anforderungen an die Zuweisungsdienst-API:
Anforderungstyp | Einschränkung pro App pro Mandant | Einschränkung pro Mandant für alle Apps |
---|---|---|
Beliebig | 500 Anforderungen pro 10 Sekunden | 1.000 Anforderungen pro 10 Sekunden |
Beliebig | 15.000 Anforderungen pro 3.600 Sekunden | 30.000 Anforderungen pro 3.600 Sekunden |
GET me/Zuweisung | 50 Anforderungen pro 10 Sekunden | 150 Anforderungen pro 10 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Grenzwerte für Bookings-Dienste
Der Bookings-Dienst wendet Grenzwerte für jede Kombination aus App-ID und Postfach an, insbesondere wenn eine bestimmte App auf ein bestimmtes Buchungspostfach zugreift. Das Überschreiten des Grenzwerts für ein Postfach wirkt sich nicht auf die Fähigkeit der Anwendung aus, auf ein anderes Postfach zuzugreifen.
Grenze | Gilt für |
---|---|
Vier gleichzeitige Anforderungen | v1.0- und Beta-Endpunkte |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Cloud-Kommunikationsdiensteinschränkungen
Ressource | Einschränkungen pro App |
---|---|
Aufrufe | 50.000 Anforderungen in einem Zeitraum von 15 Sekunden pro Anwendung und Mandant |
Besprechungsinformationen | 2.000 Besprechungen/Benutzer pro Monat |
Anwesenheit | 1.500 Anforderungen in einem Zeitraum von 30 Sekunden pro Anwendung und Mandant |
Virtuelles Ereignis | 10.000 Anforderungen/App pro Monat |
Grenzwerte für Anrufdatensätze
Die in der folgenden Tabelle aufgeführten Grenzwerte gelten für die folgenden Ressourcen:
Einschränkungstyp | Grenze |
---|---|
Pro Anwendung für alle Mandanten | 15.000 Anforderungen pro 20 Sekunden |
Pro Mandant für alle Anwendungen | 10.000 Anforderungen pro 20 Sekunden |
Pro Anwendung und Mandant | 1.500 Anforderungen pro 20 Sekunden |
Datensatz pro Anruf | 10 Anforderungen pro 20 Sekunden (erste Seite) 50 Anforderungen pro 5 Minuten (nachfolgende Seiten) |
Auflisten von Anrufdatensätzen | 15 Anforderungen pro 20 Sekunden (erste Seite) 55 Anforderungen pro 5 Minuten (nachfolgende Seiten) |
Grenzwerte für PSTN-Anrufdatensätze
Die in der folgenden Tabelle aufgeführten Grenzwerte gelten für die folgenden Ressourcen:
Einschränkungstyp | Grenze |
---|---|
Pro Mandant | 1.000 Anforderungen pro 60 Sekunden |
Pro Anwendung und Mandant | 200 Anforderungen pro 60 Sekunden |
Pro Sammlung | 50 Anforderungen pro 60 Sekunden |
Diensteinschränkungen für Excel
Erläuterungen und bewährte Methoden im Zusammenhang mit Excel-Diensteinschränkungen finden Sie unter Verringern von Einschränkungsfehlern. Darüber hinaus sind im Folgenden einige Einschränkungsgrenzwerte angegeben.
Anforderungstyp | Einschränkung pro App für alle Mandanten | Einschränkung pro App pro Mandant |
---|---|---|
Beliebig | 5000 Anfragen pro 10 Sekunden | 1500 Anforderungen pro 10 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Diensteinschränkungen für Education
Anforderungstyp | Einschränkung pro App für alle Mandanten | Einschränkung pro App pro Mandant |
---|---|---|
Beliebig | 400 000 Anforderungen pro 20 Sekunden | 35 000 Anforderungen pro 10 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Diensteinschränkungen für Dateien und Listen
Informationen zu Dienstbeschränkungen für OneDrive, OneDrive for Business und SharePoint Online finden Sie unter Vermeiden von Einschränkungen oder Sperren in SharePoint Online.
Die vorstehenden Informationen gelten für die folgenden Ressourcen:
Diensteinschränkungen für Identitäts- und Zugriffberichte
Anforderungstyp | Einschränkung pro App pro Mandant |
---|---|
Beliebig | Fünf Anforderungen pro 10 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Bewährte Methoden für Identitäts- und Zugriffsberichte
Microsoft Entra Berichterstellungs-APIs werden gedrosselt, wenn Microsoft Entra ID während eines bestimmten Zeitraums zu viele Aufrufe von einem Mandanten oder einer App empfängt. Aufrufe können auch gedrosselt werden, wenn die Antwort des Diensts zu lange dauert. Wenn Ihre Anfragen trotz Anwendung der bewährten Praktiken zur Handhabung der Drosselung immer noch mit einem 429 Too Many Requests
-Fehlercode fehlschlagen, versuchen Sie, die Menge der zurückgegebenen Daten zu reduzieren. Probieren Sie zuerst diese Ansätze aus:
- Verwenden Sie Filter, um Ihre Abfrage nur auf die benötigten Daten abzuzielen. Wenn Sie z. B. nur einen bestimmten Ereignistyp oder eine Teilmenge von Benutzern benötigen, filtern Sie andere Ereignisse mithilfe der Abfrageparameter
$filter
und$select
heraus, um die Größe des Antwortobjekts und das Risiko einer Einschränkung zu verringern. - Wenn Sie einen breiten Satz von Microsoft Entra ID Berichtsdaten benötigen, verwenden Sie
$filter
für createdDateTime, um die Anzahl der Anmeldeereignisse zu begrenzen, die Sie in einem einzelnen Aufruf abfragen. Durchlaufen Sie dann den nächsten Zeitraum, bis Sie alle benötigten Datensätze haben. Wenn Sie beispielsweise gedrosselt werden, können Sie mit einem Aufruf beginnen, der daten von drei Tagen anfordert, und mit kürzeren Zeiträumen durchlaufen, bis Ihre Anforderungen nicht mehr gedrosselt werden.
Diensteinschränkungen für Identität und Zugriff
Muster
Die Drosselung basiert auf einem Token Bucket-Algorithmus, der durch das Hinzufügen der individuellen Kosten für Anforderungen funktioniert. Die Summe der Anforderungskosten wird dann mit vordefinierten Grenzwerten verglichen. Nur die Anforderungen, die die Grenzwerte überschreiten, werden gedrosselt. Wenn einer der Grenzwerte überschritten wird, lautet 429 Too Many Requests
die Antwort . Es ist möglich, Antworten zu erhalten 429 Too Many Requests
, auch wenn die folgenden Grenzwerte nicht erreicht werden, in Situationen, in denen die Dienste unter einer wichtigen Last oder basierend auf dem Datenvolumen für einen bestimmten Mandanten sind. In der folgenden Tabelle sind die vorhandenen Beschränkungen aufgelistet.
Einschränkungstyp | Kontingent „Ressourceneinheit“ | Kontingent „Schreiben“ |
---|---|---|
Anwendung und Mandantenpaar | S: 3.500 ResourceUnits pro 10 Sekunden M: 5.000 ResourceUnits pro 10 Sekunden L: 8.000 ResourceUnits pro 10 Sekunden |
3.000 Anforderungen pro 2 Minuten und 30 Sekunden |
Anwendung | 150.000 ResourceUnits pro 20 Sekunden | 35.000 Anforderungen pro 5 Minuten |
Mandant | Nicht zutreffend | 18.000 Anforderungen pro 5 Minuten |
Hinweis
Die Beschränkung „Anwendung und Mandantenpaar“ variiert je nach der Anzahl der Benutzer im Mandanten, für den die Anforderungen ausgeführt werden. Die Mandantengrößen sind wie folgt definiert: S – unter 50 Benutzende, M – 50 bis 500 Benutzende und L – über 500 Benutzende.
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
In der folgenden Tabelle sind die Kosten für die Basisanforderung aufgelistet. Alle nicht aufgeführten Anforderungen haben die Basiskosten 1.
Vorgang | Anforderungspfad | Kosten der Basisressourcen-Einheit | Schreibkosten |
---|---|---|---|
GET | applications |
2 | 0 |
GET | applications/{id}/extensionProperties |
2 | 0 |
GET | contracts |
3 | 0 |
POST | directoryObjects/getByIds |
5 | 0 |
GET | domains/{id}/domainNameReferences |
4 | 0 |
POST | getObjectsById |
5 | 0 |
GET | groups/{id}/members |
3 | 0 |
GET | groups/{id}/transitiveMembers |
5 | 0 |
POST | isMemberOf |
4 | 0 |
POST | me/checkMemberGroups |
4 | 0 |
POST | me/checkMemberObjects |
4 | 0 |
POST | me/getMemberGroups |
2 | 0 |
POST | me/getMemberObjects |
2 | 0 |
GET | me/licenseDetails |
2 | 0 |
GET | me/memberOf |
2 | 0 |
GET | me/ownedObjects |
2 | 0 |
GET | me/transitiveMemberOf |
2 | 0 |
GET | oauth2PermissionGrants |
2 | 0 |
GET | oauth2PermissionGrants/{id} |
2 | 0 |
GET | servicePrincipals/{id}/appRoleAssignments |
2 | 0 |
GET | subscribedSkus |
3 | 0 |
GET | users |
2 | 0 |
GET | Jeder Identitätspfad, der nicht in der Tabelle aufgeführt ist | 1 | 0 |
POST | Jeder Identitätspfad, der nicht in der Tabelle aufgeführt ist | 1 | 1 |
PATCH | Jeder Identitätspfad, der nicht in der Tabelle aufgeführt ist | 1 | 1 |
PUT | Jeder Identitätspfad, der nicht in der Tabelle aufgeführt ist | 1 | 1 |
LÖSCHEN | Jeder Identitätspfad, der nicht in der Tabelle aufgeführt ist | 1 | 1 |
Wichtig
Die Kosten für POST-, PATCH- und DELETE-Vorgänge für den applications
Anforderungspfad hängen vom signInAudience -Typ ab. Bei Apps, bei denen die signInAudienceAzureADMyOrg
oder AzureADMultipleOrgs
ist, betragen die Kosten 70.000 Anforderungen pro 5 Minuten. Für Apps, bei denen die signInAudienceAzureADandPersonalMicrosoftAccount
oder PersonalMicrosoftAccount
ist, betragen die Kosten 60 Anforderungen pro Minute.
Andere Faktoren, die sich auf die Kosten der Anforderung auswirken:
- Die Verwendung von
$select
verringert die Kosten um 1 - Die Verwendung von
$expand
erhöht die Kosten um 1 - Die Verwendung von
$top
mit einem Wert von weniger als 20 senkt die Kosten um 1 - Das Erstellen eines Benutzers in einem Microsoft Entra ID B2C-Mandanten erhöht die Kosten um 4
Hinweis
- Kosten für eine Anforderung können niemals kleiner als 1 sein. Alle Anforderungskosten, die für einen Anforderungspfad gelten, der mit
me/
beginnt, gelten auch für gleichwertige Anforderungen, die mitusers/{id | userPrincipalName}/
beginnen. - Die Verwendung von
$select
fürdirectoryObjects/getByIds
undgetObjectsById
führt zu 2 ResourceUnits.
Zusätzliche Header
Anforderungsheader
-
x-ms-Throttle-Priority – Wenn der Header nicht existiert oder auf einen anderen Wert gesetzt ist, deutet dies auf eine normale Anforderung hin. Wir empfehlen, die Priorität auf
high
nur für die vom Benutzer initiierten Anforderungen zu setzen. Dieser Header kann einen der folgenden Werte aufweisen:- Niedrig: Die Anforderung hat eine geringe Priorität. Drosseln dieser Anforderung verursacht keine für Benutzende sichtbaren Fehler.
- Normal: Standard, wenn kein Wert angegeben ist. Die Anforderung ist die Standardpriorität.
- Hoch: Die Anforderung hat eine hohe Priorität. Drosseln dieser Anforderung verursacht für Benutzende sichtbaren Fehler.
Hinweis
Sollen Anforderungen gedrosselt werden, so werden Anforderungen mit niedriger Priorität zuerst gedrosselt, Anforderungen mit normaler Priorität an zweiter Stelle und Anforderungen mit hoher Priorität zuletzt. Die Verwendung des Headers „Priority Request“ ändert die Begrenzung nicht.
Reguläre Antworten-Anforderungen
- x-ms – Ressource – Einheit Gibt die Ressourceneinheit für diese Anforderung an. Werte sind positive ganze Zahlen.
- x-ms-Throttle-Limit-Prozentsatz Wird nur zurückgegeben, wenn die Anwendung mehr als 0,8 ihres Limits verbraucht hat. Der Wert liegt zwischen 0,8 und 1,8 und ist ein Prozentsatz des Grenzwertes. Aufrufer können diesen Wert verwenden, um eine Warnung einzurichten und Maßnahmen zu ergreifen.
Gedrosselte Antwortanforderungen
-
x-ms-throttle-scope –
Tenant_Application/ReadWrite/9a3d526c-b3c1-4479-ba74-197b5c5751ae/0785ef7c-2d7a-4542-b048-95bcab406e0b
z. B. . Bereich der Einschränkung mit dem folgenden Format<Scope>/<Limit>/<ApplicationId>/<TenantId|UserId|ResourceId>
:- Scope: (String; erforderlich)
- Tenant_Application: Alle Anforderungen für einen bestimmten Mandanten für die aktuelle Anwendung.
- Mandant: Alle Anforderungen des aktuellen Mandanten, unabhängig von der Anwendung.
- Anwendung: Alle Anforderungen für die aktuelle Anwendung.
- Limit: (Zeichenfolge, erforderlich)
- Lesen: Lesen von Anforderungen für den Bereich (GET)
- Schreiben: Schreiben von Anforderungen für den Bereich (POST, PATCH, PUT, DELETE...)
- ReadWrite: Alle Anforderungen für den Bereich (Any)
- ApplicationId (GUID, erforderlich)
- TenantId|UserId|ResourceId: (GUID, erforderlich)
- Scope: (String; erforderlich)
-
x-ms-Throttle-Information Grund für die Drosselung, kann einen beliebigen Wert (String) haben. Der Wert wird für Diagnose- und Problembehandlung bereitgestellt. Beispiele sind:
- CPULimitExceeded: Die Drosselung erfolgt, weil die Grenze für die CPU-Zuteilung überschritten wird.
- WriteLimitExceeded: Die Drosselung erfolgt, weil das Schreiblimit überschritten wird.
- ResourceUnitLimitExceeded: Die Drosselung erfolgt, weil die Grenze für die zugewiesene Ressourceneinheit überschritten wird.
Diensteinschränkungen bei Identität und dem Zugriff auf Datenrichtlinienoperationen
Anforderungstyp | Limit pro Mandant |
---|---|
POST bei exportPersonalData |
1.000 Anforderungen pro Tag für jeden Betreff und 100 pro Betreff pro Tag |
Jede andere Anforderung | 10.000 Anforderungen pro Stunde |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Hinweis
Die zuvor aufgeführten Ressourcen geben keine Retry-After
-Kopfzeile für 429 Too Many Requests
-Antworten zurück.
Identitätsschutz und bedingte Zugriffsdiensteinschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps |
---|---|
Beliebig | Eine Anforderung pro Sekunde |
Hinweis
Die zuvor aufgeführten Ressourcen geben keine Retry-After
-Kopfzeile für 429 Too Many Requests
-Antworten zurück.
Diensteinschränkungen für Identitätsanbieter
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
Beliebig | 300 Anforderungen pro 1 Minute | 200 Anforderungen pro 1 Minute |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Diensteinschränkungen für Informationsschutz
Die folgenden Grenzwerte gelten für alle Anforderungen für /informationProtection
.
Bei E-Mails ist die Ressource ein eindeutiges Netzwerknachrichten-ID/-Empfänger-Paar. Wenn Sie beispielsweise eine E-Mail mit der gleichen Nachrichten-ID senden, die mehrmals innerhalb eines Zeitraums von 15 Minuten an dieselbe Person gesendet wurde, wird der in der folgenden Tabelle aufgeführte Grenzwert pro Ressource ausgelöst. Sie können jedoch alle 15 Minuten bis zu 150 E-Mails mit eindeutigen Nachrichten-IDs übermitteln (Mandantenlimit).
Vorgang | Limit pro Mandant | Einschränkung pro Ressource (E-Mail, URL, Datei) |
---|---|---|
POST | 150 Anforderungen pro 15 Minuten und 10.000 Anforderungen pro 24 Stunden | Eine Anforderung pro 15 Minuten und drei Anforderungen pro 24 Stunden |
Diensteinschränkungen für Einblicke
Die folgenden Grenzwerte gelten für alle Anforderungen für me/insights
oder users/{id}/insights
.
Grenze | Gilt für |
---|---|
10.000 API-Anforderungen in einem Zeitraum von 10 Minuten | v1.0- und Beta-Endpunkte |
Vier gleichzeitige Anforderungen | v1.0- und Beta-Endpunkte |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Diensteinschränkungen für Intune
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Android for work-Diensteinschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Anwendungen-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Überwachungsdiensts-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Bücher-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Bundles-Diensteinschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Chromebook-Synchronisierung-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Geschäftsbedingungen-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Gerätekonfiguration V2-Dienste-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Geräte Konfiguration-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Geräte Registrierung-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Geräteabsichten-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Geräte-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 400 Anforderungen pro 20 Sekunden | 200 Anforderungen pro 20 Sekunden |
Beliebig | 4000 Anforderungen pro 20 Sekunden | 2.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Endpunktschutz-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Registrierung-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-GPAnalytics-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune Managed Applications-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Beschränkungen des InTune-Benachrichtigungsdiensts
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-ODJ-Dienste-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Partnerintegration-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-RBAC-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Remote-Unterstützung-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Telefonie-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-TEM-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-Problembehandlung bei Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Entsperrung-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Intune-Aktualisierungen-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
InTune-WIP-Dienstbeschränkungen
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Diensteinschränkungen für den Einladungs-Manager
Die folgenden Grenzwerte gelten für alle Anforderungen für /invitations
.
Vorgang | Einschränkung pro Mandant für alle Apps |
---|---|
Jeder Vorgang | 150 Anforderungen pro 5 Sekunden |
Dienstgrenzwerte für Microsoft 365-Berichte
Die folgenden Grenzwerte gelten für alle Anforderungen für /reports
.
Vorgang | Einschränkung pro App pro Mandant | Einschränkung pro Mandant für alle Apps |
---|---|---|
Jede Anforderung (CSV) | 14 Anforderungen pro 10 Minuten | 40 Anforderungen pro 10 Minuten |
Jede Anforderung (JSON, Beta) | 100 Anforderungen pro 10 Minuten | n/v |
Die oben genannten Einschränkungen gelten einzeln für jede Berichts-API. Beispielsweise zählen eine Anforderung an die Microsoft Teams-Benutzeraktivitätsberichts-API und eine Anforderung an die Outlook-Benutzeraktivitätsberichts-API innerhalb von 10 Minuten als eine von 14 Anforderungen für jede API, nicht zwei von 14 Anforderungen für beide.
Die vorgenannten Einschränkungen gelten für alle usage reports-Ressourcen.
Microsoft Teams-Diensteinschränkungen
Begrenzungen werden als Anforderungen pro Sekunde (requests per second, rps) angegeben.
Teams-Anforderungstyp | Einschränkung pro App pro Mandant | Einschränkung pro App in allen Mandanten | Grenzwert pro App und Mandant pro Ressource (Chat/Kanal) |
---|---|---|---|
GET-Team | 30 rps | 600 rps | |
GET-Kanal | 30 rps | 600 rps | 1rps |
Registerkarte "GET" für Kanal, Chat | 30 rps | 600 rps | 1rps |
GET installedApps für Benutzer, Team | 30 rps | 600 rps | |
GET installedApps für Chat | 30 rps | 600 rps | 1rps |
GET appCatalogs | 30 rps | 600 rps | |
POST-Kanal | 30 rps | 300 rps | 1rps |
Registerkarte "POST" für Kanal oder Chat | 30 rps | 300 rps | 1rps |
POST installedApps für Chat, Benutzer, Team | 30 rps | 300 rps | |
POST appCatalogs | 30 rps | 300 rps | |
PATCH-Team, Registerkarte | 30 rps | 300 rps | |
PATCH-Kanal | 30 rps | 300 rps | 1rps |
DELETE-Kanal | 15 rps | 150 rps | 1rps |
DELETE-Registerkarte für Chat, Kanal | 15 rps | 150 rps | 1rps |
DELETE installedApps für Chat, Benutzer, Team | 15 rps | 150 rps | |
DELETE appCatalogs | 15 rps | 150 rps | |
GET /teams/{team-id} , joinedTeams |
30 rps | 300 rps | |
POST /teams | 10 rps | 100 rps | |
PUT /groups/{team-id} /team |
Sechs Rps | 150 rps | |
POST /{team-id} / clone |
Sechs Rps | 150 rps | |
GET-Kanalnachricht | 20 rps | 200 rps | 1rps |
GET 1:1/Gruppenchatnachricht | 20 rps | 200 rps | 1rps |
POST-Kanalnachricht | 50 rps | 500 rps | 1rps |
POST-Chatmitglied | 30 rps | 300 rps | 16 Uhr |
Chatmitglied löschen | 30 rps | 300 rps | 16 Uhr |
POST 1:1/Gruppenchatnachricht | 20 rps | 200 rps | 1rps |
GET /teams/{team-id} /schedule und alle APIs unter diesem Pfad |
30 rps | 600 rps | |
POST /teams/{team-id} /schedule und alle APIs unter diesem Pfad |
30 rps | 300 rps | |
PUT /teams/{team-id} /schedule und alle APIs unter diesem Pfad |
30 rps | 300 rps | |
POST /teams/{team-id} /sendActivityNotification |
Fünf Rps | 50 rps | |
POST /chats/{chat-id} /sendActivityNotification |
Fünf Rps | 50 rps | 1rps |
POST /users/{user-id} /teamwork/sendActivityNotification |
Fünf Rps | 50 rps | |
POST /teamwork/sendActivityNotificationToRecipients | Zwei Rps | 20 rps | |
GET /teams/{team-id} /members |
60 rps | 1200 rps | |
POST /teams/{team-id} /members |
30 rps | 300 rps | 16 Uhr |
GET /teams/{team-id} /channels |
60 rps | 1200 rps | 1rps |
GET /teams/{team-id} /channels/{channel-id} /members |
60 rps | 1200 rps | 1rps |
Abrufen aller Kanalnachrichten für ein Team GET teams/ {team-id} /channels/getAllMessagesGET teams/ {team-id} /channels/allMessages |
200rps | 1000rps | |
Abrufen aller Chatnachrichten für einen Benutzer GET users/ {user-id} /chats/getAllMessagesGET users/ {user-id} /chats/allMessages |
200rps | 1000rps | |
GET /teams/{team-id} /channels/getAllRetainedMessages |
200rps | 1000rps | |
GET /users/{user-id} /chats/getAllRetainedMessages |
200rps | 1000rps | |
Andere GET-API-Aufrufe für Microsoft Teams | 30 rps | 1500 rps | 1rps |
Andere API-Aufrufe für Microsoft Teams | 30 rps | 300 rps | 1rps |
Für ein bestimmtes Team können maximal vier Anforderungen pro Sekunde pro App ausgegeben werden.
Für einen bestimmten Kanal oder Chat kann maximal eine Anforderung pro Sekunde pro App und Mandant ausgegeben werden.
Bei einer POST-Nachricht in einem bestimmten Chat oder Kanal kann maximal eine Anforderung pro Sekunde pro Benutzer ausgegeben werden (dieser Einschränkungsgrenzwert gilt nicht für die Migration).
Maximal fünf Anforderungen pro Sekunde und Benutzer können ausgegeben werden, wenn Listenchats oder Get chat oder chat ausgeführt werden:removeAllAccessForUser
Siehe auch Microsoft Teams-Einschränkungen und Anforderungen für das Abrufen.
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Grenzwerte für mehrinstanzenfähige Verwaltungsdienste
Anforderungstyp | Einschränkung pro Mandant für alle Apps | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 200 Anforderungen pro 20 Sekunden | 100 Anforderungen pro 20 Sekunden |
Beliebig | 2.000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Diensteinschränkungen für OneNote
Einschränkungstyp | Einschränkung pro App pro Benutzer (delegierter Kontext) | Einschränkung pro App (Nur-App-Kontext) |
---|---|---|
Anforderungsrate | 120 Anforderungen pro 1 Minute und 400 Anforderungen pro 1 Stunde | 240 Anforderungen pro 1 Minute und 800 Anforderungen pro 1 Stunde |
Gleichzeitige Anforderungen | Fünf gleichzeitige Anforderungen | 20 gleichzeitige Anforderungen |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Zusätzliche Informationen zu bewährten Methoden finden Sie unter Drosselung von OneNote-API und wie Sie dies vermeiden.
Hinweis
Die zuvor aufgeführten Ressourcen geben keine Retry-After
-Kopfzeile für 429 Too Many Requests
-Antworten zurück.
Diensteinschränkungen bei offenen Erweiterungen und Schemaerweiterungen
Anforderungstyp | Einschränkung pro App pro Mandant |
---|---|
Beliebig | 455 Anforderungen pro 10 Sekunden |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Outlook-Diensteinschränkungen
Outlook-Dienstgrenzwerte gelten für Bereitstellungen in der öffentlichen und nationalen Cloud.
Grenzwerte pro Postfach
Der Outlook-Dienst wendet Grenzwerte für jede Kombination aus App-ID und Postfach an, d. h. für eine bestimmte App, die auf ein bestimmtes Benutzer- oder Gruppenpostfach zugreift. Das Überschreiten des Grenzwerts für ein Postfach wirkt sich nicht auf die Fähigkeit der Anwendung aus, auf ein anderes Postfach zuzugreifen.
Grenze | Gilt für |
---|---|
10.000-API-Anforderungen innerhalb von 10 Minuten | v1.0-und Beta-Endpunkte |
Vier gleichzeitige Anforderungen | v1.0-und Beta-Endpunkte |
Upload mit 150 Megabyte (MB) (PATCH, POST, PUT) in einem Zeitraum von 5 Minuten | v1.0- und Beta-Endpunkte |
Outlook-Dienst-Ressourcen
API | Ressourcen |
---|---|
Such-API (Vorschau): | |
Profil-API | |
Kalender-API | |
Mail-API | |
Persönliche Kontakte-API | |
Soziale Intelligenz und intelligenter Arbeitsplatz | |
To Do-Aufgaben-API (Vorschau) |
Einschränkungen des Outlook-Diensts für die JSON-Batchverarbeitung
Wenn eine App eine JSON-Batchanforderung sendet, die aus mehreren, ungeordneten individuellen Anforderungen an den Outlook-Dienst besteht, sendet Microsoft Graph den Outlook-Dienst standardmäßig bis zu vier einzelne Anforderungen aus dem Batch gleichzeitig, unabhängig von den Zielpostfächern dieser Anforderungen. Der Outlook-Dienst kann diese Anforderungen jederzeit parallel ausführen, auch unabhängig vom Zielpostfach. Da Microsoft Graph nur bis zu vier Anforderungen zur parallelen Ausführung sendet, bleibt die Ausführung dieses Batches unabhängig von der verwendeten App innerhalb der Parallelitätsgrenzwerte von Outlook für dasselbe Postfach.
Alternativ kann eine App die dependsOn-Eigenschaft verwenden, um Anforderungen innerhalb eines Batches zu sortieren. Microsoft Graph sendet dem Outlook-Dienst jeweils eine Anforderung aus dem Batch nach der angegebenen Reihenfolge, und Outlook führt jede einzelne Anforderung im Batch sequenziell aus.
Anders ausgedrückt: Bei der Ausrichtung auf dasselbe Postfach können Apps, die die parallele Ausführung mehrerer Batchanforderungen zulassen, einen der folgenden Ansätze verwenden:
- Wenn die einzelnen Anforderungen nicht sortiert werden müssen, lassen Sie einzelne Anforderungen aus einem einzelnen Batch gleichzeitig ausführen.
- Verwenden Sie die
dependsOn
-Eigenschaft, um Anforderungen in einem Batch zu sortieren, und lassen Sie bis zu vier solcher Batchanforderungen gleichzeitig ausführen.
Diensteinschränkungen für Project Rome
Anforderungstyp | Einschränkung pro Benutzer für alle Apps |
---|---|
GET | 400 Anforderungen pro 5 Minuten und 12.000 Anforderungen pro Tag |
POST, PUT, PATCH, DELETE | 100 Anforderungen pro 5 Minuten und 8.000 Anforderungen pro Tag |
Die vorgenannten Einschränkungen gelten für die folgenden Ressourcen:
Diensteinschränkungen für Sicherheitserkennungen und -vorfälle
Die folgenden Grenzwerte gelten für alle Anforderungen für /security
.
Vorgang | Einschränkung pro App pro Mandant |
---|---|
Jeder Vorgang für alert , securityActions , secureScore |
150 Anforderungen pro Minute |
Jeder Vorgang bei tiIndicator |
1.000 Anforderungen pro Minute |
Jeder Vorgang bei secureScore oder secureScorecontrolProfile |
10.000 API-Anforderungen in einem Zeitraum von 10 Minuten |
Jeder Vorgang bei secureScore oder secureScorecontrolProfile |
Vier gleichzeitige Anforderungen |
Grenzwerte für den eDiscovery-Sicherheitsdienst
Die folgenden Grenzwerte gelten für alle Anforderungen für /security/eDiscoveryCases
.
Vorgang | Einschränkung pro App pro Mandant |
---|---|
Beliebig | Fünf Anforderungen pro Minute |
Einschränkungen für den Dienst „Dienstkommunikation“
Die folgenden Einschränkungen gelten für alle Arten von Anforderungen für die Dienstkommunikation unter /admin/serviceAnnouncement/
.
Anforderungstyp | Einschränkung pro App pro Mandant |
---|---|
Beliebig | 240 Anforderungen pro 60 Sekunden |
Any | 800 Anforderungen pro Stunde |
Abonnementdiensteinschränkungen
Anforderungstyp | Einschränkung pro App für alle Mandanten | Einschränkung pro App pro Mandant |
---|---|---|
POST, PUT, DELETE, PATCH | 2.000 Anforderungen pro 20 Sekunden | 500 Anforderungen pro 20 Sekunden |
POST /reauthorize subscription by ID | 4000 Anforderungen pro 20 Sekunden | 1.000 Anforderungen pro 20 Sekunden |
GET-Abonnement nach ID | 2.000 Anforderungen pro 20 Sekunden | 500 Anforderungen pro 20 Sekunden |
GET-Abonnementliste | 40 Anforderungen pro 20 Sekunden | 25 Anforderungen pro 20 Sekunden |
Die oben genannten Grenzwerte gelten für die Abonnementressource .
Diensteinschränkungen für Aufgaben und Pläne
Dienstgrenzwerte für Planner sind nicht verfügbar.
Die vorstehenden Informationen gelten für die folgenden Ressourcen:
Viva Engage-Dienstgrenzwerte
Viva Engage API-Aufrufe unterliegen einer Ratenbegrenzung, sodass 10 Anforderungen pro Benutzer und App innerhalb eines Zeitraums von 30 Sekunden zulässig sind. Wenn Sie das Ratenlimit überschreiten, geben alle nachfolgenden Anforderungen einen 429 Too Many Requests
Antwortcode zurück.