Dienstgrenzwerte für Azure Communication Services
In diesem Dokument werden die Einschränkungen von Azure Communication Services-APIs und mögliche Lösungen erläutert.
Drosselungsmuster und -architektur
Wenn Sie Diensteinschränkungen erreichen, erhalten Sie in der Regel den HTTP-Statuscode 429 (Zu viele Anforderungen). Im Allgemeinen werden die folgenden bewährten Methoden für die Behandlung der Drosselung empfohlen:
- Reduzieren Sie die Anzahl von Vorgängen pro Anforderung.
- Reduzieren der Häufigkeit von Aufrufen.
- Vermeiden Sie sofortige Wiederholungsversuche, da alle Anforderungen in Ihren Nutzungsgrenzwerten auflaufen.
Weitere allgemeine Anleitungen zum Einrichten Ihrer Dienstarchitektur zur Behandlung von Drosselung und Einschränkungen finden Sie in der Dokumentation zur Azure-Architektur für Drosselungsmuster. Drosselungsgrenzwerte können über eine Anforderung an den Azure-Support erhöht werden.
Erhalten von Telefonnummern
Vergewissern Sie sich vor dem Erwerb einer Rufnummer, dass Ihr Abonnement die geografischen und abonnementbezogenen Anforderungen erfüllt. Andernfalls können Sie keine Telefonnummer erwerben. Die folgenden Einschränkungen gelten für den Erwerb von Zahlen über das Phone Numbers SDK und das Azure-Portal.
Vorgang | Bereich | Zeitraum | Grenzwert (Anzahl der Anfragen) |
---|---|---|---|
Kaufen von Telefonnummern | Azure-Mandant | - | 1 |
Suchen nach Telefonnummern | Azure-Mandant | Eine Woche | 5 |
Auszuführende Aktion
Weitere Informationen finden Sie auf der Konzeptseite für Telefonnummerntypen und auf der Übersichtsseite zum Telefoniekonzept.
Wenn Sie weitere Telefonnummern erwerben oder eine spezielle Bestellung aufgeben möchten, befolgen Sie die Anweisungen hier. Wenn Sie gebührenfreie Telefonnummern von externen Konten in ihr Azure Communication Services-Konto portieren möchten, befolgen Sie die Anweisungen hier.
Identität
Vorgang | Zeitrahmen (Sekunden) | Grenzwert (Anzahl der Anfragen) |
---|---|---|
Erstellen einer Identität | 30 | 500 |
Identität löschen | 30 | 500 |
Ausstellen von Zugriffstoken | 30 | 500 |
Widerrufen von Zugriffstoken | 1 | 100 |
createUserAndToken | 30 | 1000 |
exchangeTokens | 30 | 500 |
Auszuführende Aktion
Wir empfehlen, Identitäten und Token zu erwerben, bevor Sie Chatthreads erstellen oder Anrufe starten. Beispielsweise, wenn die Webseite geladen oder die Anwendung gestartet wird.
Weitere Informationen finden Sie auf der Seite mit der Übersicht zum Identitätskonzept.
SMS
Wenn Sie eine große Anzahl von Nachrichten senden oder empfangen, erhalten Sie möglicherweise einen 429
-Fehler. Dieser Fehler bedeutet, dass Sie die Diensteinschränkungen erreichen und Ihre Nachrichten in die Warteschlange eingereiht werden, um gesendet zu werden, sobald die Anzahl der Anforderungen unter dem Schwellenwert liegt.
Begrenzung der Datenübertragungs Rate für SMS:
Vorgang | Bereich | Zeitrahmen (Sekunden) | Grenzwert (Anzahl der Anfragen) | Nachrichteneinheiten pro Minute |
---|---|---|---|---|
Nachricht senden | Pro Zahl | 60 | 200 | 200 |
Auszuführende Aktion
Wenn Sie eine große Anzahl von Nachrichten senden möchten, das die Ratenbegrenzungen überschreitet, senden Sie uns eine E-Mail an phone@microsoft.com.
Weitere Informationen zum SMS SDK und -Dienst finden Sie auf der Übersichtsseite des SMS SDK oder auf der Seite mit häufig gestellten Fragen zu SMS.
Der Versand großer Mengen von Nachrichten unterliegt einer Reihe von Beschränkungen für die Anzahl der E-Mail-Nachrichten, die Sie senden können. Wenn Sie diese Grenzwerte erreichen, werden Ihre Nachrichten nicht in die Warteschlange zum Senden gestellt. Sie können diese Anforderungen erneut übermitteln, sobald das Wiederholungsintervall abgelaufen ist.
Begrenzung der Bandbreite
Vorgang | Bereich | Zeitrahmen (Minuten) | Grenzwert (Anzahl der E-Mails) |
---|---|---|---|
E-Mail senden | Pro Abonnement | 1 | 10 |
E-Mail senden | Pro Abonnement | 60 | 25 |
Abrufen des E-Mail-Status | Pro Abonnement | 1 | 20 |
Abrufen des E-Mail-Status | Pro Abonnement | 60 | 50 |
Größenbeschränkungen
Name | Begrenzung |
---|---|
Anzahl der Empfänger in einer E-Mail | 50 |
Gesamtgröße von E-Mail-Anforderungen (einschließlich Anlagen) | 10 MB |
Auszuführende Aktion
Dieses Sandboxsetup hilft Entwicklern beim Erstellen der Anwendung. Sie können eine schrittweise Erhöhung des Sendevolumens anfordern, sobald die Anwendung einsatzbereit ist. Übermitteln Sie eine Supportanfrage, um das von Ihnen gewünschte Sendelimit zu erhöhen, wenn Sie ein Nachrichtenvolumen senden müssen, das die Ratenbegrenzungen überschreitet.
Chat
Größenbeschränkungen
Name | Begrenzung |
---|---|
Anzahl der Teilnehmer im Thread | 250 |
Batch der Teilnehmer – CreateThread | 200 |
Batch der Teilnehmer – AddParticipant | 200 |
Seitengröße: ListMessages | 200 |
Grenzwerte für Vorgänge
Vorgang | Bucket nach | Grenzwert pro 10 Sekunden | Grenzwert pro Minute |
---|---|---|---|
Chatthread erstellen | Benutzer | 10 | - |
Chatthread löschen | Benutzer | 10 | - |
Chatthread aktualisieren | Chatthread | 5 | - |
Teilnehmer hinzufügen/Teilnehmer entfernen | Chatthread | 10 | 30 |
Chatthread abrufen/Chatthreads auflisten | Benutzer | 50 | - |
Abrufen einer Chatnachricht | Benutzer und Chatthread | 50 | - |
Abrufen einer Chatnachricht | Chatthread | 250 | - |
Auflisten von Chatnachrichten | Benutzer und Chatthread | 50 | 200 |
Auflisten von Chatnachrichten | Chatthread | 250 | 400 |
Abrufen von Lesebestätigungen | Benutzer und Chatthread | 5 | - |
Abrufen von Lesebestätigungen | Chatthread | 250 | - |
Teilnehmer des Chatthreads auflisten | Benutzer und Chatthread | 10 | - |
Teilnehmer des Chatthreads auflisten | Chatthread | 250 | - |
Nachricht senden/Nachricht aktualisieren/Nachricht löschen | Chatthread | 10 | 30 |
Senden einer Lesebestätigung | Benutzer und Chatthread | 10 | 30 |
Eingabeindikator senden | Benutzer und Chatthread | 5 | 15 |
Eingabeindikator senden | Chatthread | 10 | 30 |
Sprach- und Videoanrufe
Einschränkungen für Aufrufmaximum
Name | Begrenzung |
---|---|
Teilnehmeranzahl | 350 |
Streamingunterstützung des Calling SDK
Das Communication Services Calling SDK unterstützt folgende Streamingkonfigurationen:
Begrenzung | Web | Windows/Android/iOS |
---|---|---|
Maximale Anzahl der ausgehenden Datenströme, die gleichzeitig gesendet werden können | Ein Video oder eine Bildschirmfreigabe | Ein Video und eine Bildschirmfreigabe |
Maximale Anzahl der eingehenden Remotedatenströme, die gleichzeitig gerendert werden können | Vier Videos und eine Bildschirmfreigabe | Sechs Videos und eine Bildschirmfreigabe |
Obwohl das Calling SDK diese Grenzwerte nicht erzwingt, kann es bei Ihren Benutzern zur Leistungsbeeinträchtigung führen, wenn sie überschritten werden.
Timeouts des Calling SDK
Für die Communication Services Calling SDKs gelten folgende Timeouts:
Aktion | Zeitlimit in Sekunden |
---|---|
Erneutes Verbinden/Entfernen des Teilnehmers | 120 |
Hinzufügen oder Entfernen einer neuen Modalität aus einem Anruf (Video oder Bildschirmfreigabe starten/beenden) | 40 |
Timeout beim Vorgang zur Anrufübertragung | 60 |
Timeout bei 1:1-Verbindungsherstellung | 85 |
Timeout bei Gruppenverbindungsherstellung | 85 |
Timeout bei PSTN-Verbindungsherstellung | 115 |
Timeout beim Heraufstufen von 1:1-Anrufen auf Gruppenverbindungen | 115 |
Auszuführende Aktion
Weitere Informationen zum Sprach- und Videoanruf-SDK und -Dienst finden Sie auf der Übersichtsseite für das aufrufende SDK oder in den bekannten Problemen.
Teams-Interoperabilität und Microsoft Graph
Mithilfe eines Teams-Interoperabilitätsszenarios werden Sie wahrscheinlich einige Microsoft Graph-APIs verwenden, um Besprechungen zu erstellen.
Jeder Dienst, der über Microsoft Graph angeboten wird, hat unterschiedliche Einschränkungen. Dienstspezifische Grenzwerte werden hier ausführlicher beschrieben.
Auszuführende Aktion
Verwenden Sie bei der Implementierung der Fehlerbehandlung den HTTP-Fehlercode 429 zur Drosselungserkennung. Die Fehlerantwort enthält den Retry-After
-Antwortheader. Das Sichern von Anforderungen mithilfe der Verzögerung Retry-After
ist die schnellste Möglichkeit zur Wiederherstellung nach einer Drosselung, da Microsoft Graph weiterhin die Ressourcennutzung protokolliert, während ein Client gedrosselt wird.
Weitere Informationen zu Microsoft Graph Drosselungsgrenzwerten finden Sie in der Microsoft Graph-Dokumentation.
Network Traversal
Vorgang | Zeitrahmen (Sekunden) | Grenzwert (Anzahl der Anfragen) |
---|---|---|
Problem mit TURN-Anmeldeinformationen | 5 | 30.000 |
Problem bei der Relaykonfiguration | 5 | 30.000 |
Auszuführende Aktion
Wir empfehlen Ihnen, Token zu erwerben, bevor Sie andere Transaktionen durchführen, z. B. eine Relayverbindung erstellen.
Weitere Informationen finden Sie auf der Seite mit der Übersicht zum Netzwerkdurchlaufskonzept.
Nächste Schritte
Weitere Informationen finden Sie unter den Optionen für Hilfe und Support.