Dienstlimits 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 Dienstbeschränkungen erreichen, erhalten Sie 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 Sie die Häufigkeit der Aufrufe.
- 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.
- Zum Azure-Portal wechseln
- Hilfe und Support auswählen
- Klicken Sie auf „Neue Supportanfrage erstellen“
- Wählen Sie in der Problembeschreibung den Problemtyp als Technisch aus, und fügen Sie die Details hinzu.
Sie können der Dokumentation für das Erstellen einer Anforderung an den Azure-Support folgen.
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 | `Scope` | Zeitrahmen | 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) |
|---|---|---|
| Identität erstellen | 30 | 1.000 |
| Identität löschen | 30 | 500 |
| Ausstellen von Zugriffstoken | 30 | 1.000 |
| Widerrufen von Zugriffstoken | 30 | 500 |
| createUserAndToken | 30 | 1.000 |
| 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 | Nummerntyp | `Scope` | Zeitraum (Zeiträume) | Limit (Anforderung #) | Nachrichteneinheiten pro Minute |
|---|---|---|---|---|---|
| Send Message | Gebührenfrei | Pro Zahl | 60 | 200 | 200 |
| Send Message | Kurzer Code | Pro Zahl | 60 | 6000 | 6000 |
| Send Message | Alphanumerische Absender-ID | Pro Ressource | 60 | 600 | 600 |
Auszuführende Aktion
Wenn Sie Anforderungen haben, die die Begrenzung der Datenübertragungsrate überschreiten, senden Sie eine Anforderung an den Azure-Support, um einen höheren Durchsatz zu ermöglichen.
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.
E‑Mail
Es gibt einen Grenzwert für die Anzahl der E-Mail-Nachrichten, die Sie senden können. Wenn Sie die folgenden Grenzwerte für Ihr Abonnement überschreiten, werden Ihre Anforderungen abgelehnt. Sie können diese Anforderungen wiederholen, nachdem die „Retry-After“-Zeit vergangen ist. Ergreifen Sie die erforderlichen Maßnahmen, und fordern Sie an, die Grenzwerte des Sendevolumens bei Bedarf auszuheben.
Begrenzung der Bandbreite
| Vorgang | `Scope` | Zeitrahmen (Minuten) | Grenzwert (Anzahl der E-Mails) |
|---|---|---|---|
| E-Mail senden | Pro Abonnement | 1 | 30 |
| E-Mail senden | Pro Abonnement | 60 | 100 |
| Abrufen des E-Mail-Status | Pro Abonnement | 1 | 60 |
| Abrufen des E-Mail-Status | Pro Abonnement | 60 | 200 |
| Vorgang | `Scope` | Zeitrahmen (Minuten) | Grenzwert (Anzahl der E-Mails) |
|---|---|---|---|
| E-Mail senden | Pro Abonnement | 1 | 5 |
| E-Mail senden | Pro Abonnement | 60 | 10 |
| Abrufen des E-Mail-Status | Pro Abonnement | 1 | 10 |
| Abrufen des E-Mail-Status | Pro Abonnement | 60 | 20 |
Größenbeschränkungen
| Name | Grenze |
|---|---|
| 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. Nachdem Sie eine Reputation als Absender*in durch das Senden von E-Mails eingerichtet haben, können Sie anfordern, die Grenzwerte des Sendevolumens zu erhöhen. Übermitteln Sie eine Supportanfrage, um das von Ihnen gewünschte Sendelimit für E-Mails zu erhöhen, wenn Sie ein Nachrichtenvolumen senden müssen, das die Begrenzung der Datenübertragungsrate überschreitet. Anforderungen zur Erhöhung des E-Mail-Kontingents werden nicht automatisch genehmigt. Das Überprüfungsteam berücksichtigt bei der Ermittlung Ihres Genehmigungsstatus Ihre allgemeine Reputation als Absender*in, die Faktoren wie Ihre E-Mail-Zustellungsfehlerraten, Ihre Domänenreputation sowie Berichte über Spam und Missbrauch enthält.
Hinweis
Anforderungen zur Erhöhung des E-Mail-Kontingents können bis zu 72 Stunden dauern, um ausgewertet und genehmigt zu werden, insbesondere Anforderungen, die am Freitagnachmittag eingehen.
Chat
Größenbeschränkungen
| Name | Grenze |
|---|---|
| Anzahl der Teilnehmer im Thread | 250 |
| Batch der Teilnehmer – CreateThread | 200 |
| Batch der Teilnehmer – AddParticipant | 200 |
| Seitengröße: ListMessages | 200 |
| Nachrichtengröße | 28 KB |
| Anzahl Ihrer Azure Communication Services-Ressourcen pro Azure Bot | 1.000 |
Begrenzung der Bandbreite
| Vorgang | Umfang | Grenzwert pro 10 Sekunden | Grenzwert pro Minute |
|---|---|---|---|
| Chatthread erstellen | Pro Benutzer*in | 10 | - |
| Chatthread löschen | Pro Benutzer*in | 10 | - |
| Chatthread aktualisieren | Pro Chatthread | 5 | - |
| Teilnehmer hinzufügen/Teilnehmer entfernen | Pro Chatthread | 10 | 30 |
| Chatthread abrufen/Chatthreads auflisten | Pro Benutzer*in | 50 | - |
| Abrufen einer Chatnachricht | Pro Benutzer*in und Thread | 50 | - |
| Abrufen einer Chatnachricht | Pro Chatthread | 250 | - |
| Auflisten von Chatnachrichten | Pro Benutzer*in und Thread | 50 | 200 |
| Auflisten von Chatnachrichten | Pro Chatthread | 250 | 400 |
| Abrufen von Lesebestätigungen (Limit von 20 Teilnehmer*innen**) | Pro Benutzer*in und Thread | 5 | - |
| Abrufen von Lesebestätigungen (Limit von 20 Teilnehmer*innen**) | Pro Chatthread | 100 | - |
| Teilnehmer des Chatthreads auflisten | Pro Benutzer*in und Thread | 10 | - |
| Teilnehmer des Chatthreads auflisten | Pro Chatthread | 250 | - |
| Nachricht senden/Nachricht aktualisieren/Nachricht löschen | Pro Chatthread | 10 | 30 |
| Senden einer Lesebestätigung | Pro Benutzer*in und Thread | 10 | 30 |
| Eingabeindikator senden | Pro Benutzer*in und Thread | 5 | 15 |
| Eingabeindikator senden | Pro Chatthread | 10 | 30 |
Hinweis
** Lesebestätigungen und Eingabeindikatoren werden in Chatthreads mit mehr als 20 Teilnehmer*innen nicht unterstützt.
Chatspeicher
Azure Communication Services speichert Chatnachrichten auf unbestimmte Zeit, bis sie vom Kunden bzw. von der Kundin gelöscht werden.
Ab CY24 Q1 müssen Kund*innen nach 90 Tagen zwischen unbegrenzter Nachrichtenaufbewahrung oder automatischer Löschung wählen. Vorhandene Nachrichten bleiben unberührt, Kund*innen können sich jedoch bei Bedarf für einen Aufbewahrungszeitraum von 90 Tagen entscheiden.
Hinweis
Versehentlich gelöschte Nachrichten können vom System nicht wiederhergestellt werden.
Sprach- und Videoanrufe
Einschränkungen für PSTN-Anrufe
| Name | Umfang | Begrenzung |
|---|---|---|
| Standardanzahl wiederkehrender ausgehender Anrufe | Pro Nummer | 2 |
Einschränkungen für Aufrufmaximum
| Name | Grenze |
|---|---|
| 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 | 9 Videos und eine Bildschirmfreigabe | 9 Videos und eine Bildschirmfreigabe |
Obwohl das Calling SDK diese Grenzwerte nicht erzwingt, kann es bei Ihren Benutzer*innen zur Leistungsbeeinträchtigung führen, wenn sie überschritten werden.
Timeouts des Calling SDK
Für die Communication Services Calling SDKs gelten folgende Timeouts:
| Aktion | Timeout 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.
Auftragsrouter
Wenn Sie eine große Anzahl von Anforderungen senden oder empfangen, erhalten Sie möglicherweise einen ThrottleLimitExceededException-Fehler. Dieser Fehler gibt an, dass Sie auf die Dienstbeschränkungen stoßen, und Ihre Anforderungen werden gelöscht, bis das Token des Buckets zum Verarbeiten von Anforderungen nach einer bestimmten Zeit aufgefüllt wird.
Begrenzung der Datenübertragungsrate für Auftragsrouter:
| Vorgang | `Scope` | Zeitrahmen (Sekunden) | Grenzwert (Anzahl der Anfragen) | Timeout in Sekunden |
|---|---|---|---|---|
| Allgemeine Anforderungen | Pro Ressource | 10 | 1.000 | 10 |
Auszuführende Aktion
Wenn Sie eine große Anzahl von Nachrichten senden müssen, die die Begrenzung der Datenübertragungsrate überschreitet, senden Sie uns eine E-Mail unter acs-ccap@microsoft.com.
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.
Nächste Schritte
Weitere Informationen finden Sie unter den Optionen für Hilfe und Support.