Dienstlimits für Azure Communication Services
In diesem Artikel 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 einen HTTP-Statuscode 429 (zu viele Anforderungen). Im Allgemeinen werden die folgenden bewährten Methoden für die Drosselung verwendet:
- 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. Um Einschränkungsgrenzwerte zu erhöhen, stellen Sie eine Anfrage an den Azure-Support.
- Öffnen Sie das Azure-Portal, und melden Sie sich an.
- Wählen Sie Hilfe und Support.
- Wählen Sie Neue Supportanfrage erstellen aus.
- Geben Sie im Textfeld Problem beschreiben Technisch ein und wählen Sie dann Gehe zu aus.
- Wählen Sie im Dropdownmenü Dienst auswählen die Option Dienst- und Abonnementbeschränkungen (Kontingente) aus, und wählen Sie dann Weiter aus.
- Wählen Sie in der Beschreibung Problem Werte für den Problemtyp, das Abonnement und den Kontingenttyp aus und wählen Sie dann Weiter aus.
- Überprüfen Sie falls verfügbar alle empfohlenen Lösungen und wählen Sie dann Weiter aus.
- Fügen Sie bei Bedarf weitere Details hinzu und wählen Sie dann Weiter aus.
- Überprüfen Sie unter Überprüfen und Erstellen die Informationen, nehmen Sie bei Bedarf Änderungen vor, und wählen Sie dann Erstellen aus.
Führen Sie die Schritte aus, um eine Anfrage an den Azure-Support zu stellen.
Erwerben 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 Anzahlen über das Telefonnummern-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 unter Telefonnummerntypen und Telefoniekonzepte.
Um die Anzahl der Einkaufsbeschränkungen zu erhöhen, stellen Sie eine Anfrage an den Azure-Support.
- Öffnen Sie das Azure-Portal, und melden Sie sich an.
- Wählen Sie Hilfe und Support.
- Wählen Sie Neue Supportanfrage erstellen aus.
- Geben Sie im Textfeld Problem beschreiben Technisch ein und wählen Sie dann Gehe zu aus.
- Wählen Sie im Dropdownmenü Dienst auswählen die Option Dienst- und Abonnementbeschränkungen (Kontingente) aus, und wählen Sie dann Weiter aus.
- Wählen Sie in der Beschreibung Problem Werte für den Problemtyp, das Abonnement und den Kontingenttyp aus und wählen Sie dann Weiter aus.
- Überprüfen Sie falls verfügbar alle empfohlenen Lösungen und wählen Sie dann Weiter aus.
- Fügen Sie bei Bedarf weitere Details hinzu und wählen Sie dann Weiter aus.
- Überprüfen Sie unter Überprüfen und Erstellen die Informationen, nehmen Sie bei Bedarf Änderungen vor, und wählen Sie dann Erstellen aus.
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
Es wird empfohlen, Identitäten und Token zu erwerben, bevor Sie Chatthreads erstellen oder Anrufe starten. Führen Sie z. B. diese Aufgabe aus, wenn die Webseite geladen wird oder die Anwendung gestartet wird.
Weitere Informationen finden Sie unter Authentifizieren bei Azure Communication Services.
SMS
Wenn Sie eine große Anzahl von Nachrichten senden oder empfangen, wird möglicherweise eine 429
-Fehlermeldung angezeigt. Dieser Fehler weist darauf hin, dass Sie die Diensteinschränkungen fast erreicht haben. Ihre Nachrichten werden in die Warteschlange gestellt und gesendet, nachdem die Anzahl der Anforderungen unter dem Schwellenwert liegt.
Ratenbegrenzungen für SMS:
Vorgang | Zahlentyp | `Scope` | Zeitrahmen | Grenzwert (Anfragenummer) | Nachrichteneinheiten pro Minute |
---|---|---|---|---|---|
Nachricht senden | Gebührenfrei | Pro Zahl | 60 | 200 | 200 |
Nachricht senden | Kurzwahlnummer | Pro Zahl | 60 | 6000 | 6000 |
Nachricht senden | 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 zum Dienst finden Sie unter SMS SDK-Übersicht oder in den SMS FAQ.
E‑Mail
Sie können eine begrenzte Anzahl von E-Mail-Nachrichten senden. Wenn Sie die folgenden Grenzwerte für Ihr Abonnement überschreiten, werden Ihre Anforderungen abgelehnt. Sie können diese Anforderungen erneut versuchen, nachdem die Retry-After
-Zeit vergangen ist. Ergreifen Sie Maßnahmen, bevor Sie den Grenzwert erreichen. Fordern Sie bei Bedarf an, Ihre Sendevolumengrenzwerte zu erhöhen.
Der Azure Communication Services-E-Mail-Dienst wurde entwickelt, um hohen Durchsatz zu unterstützen. Der Dienst sieht anfängliche Ratenlimits vor, um den Kunden einen reibungslosen Einstieg zu ermöglichen und einige der Probleme zu vermeiden, die bei der Umstellung auf einen neuen E-Mail-Dienst auftreten können. Es wird empfohlen, Azure Communication Services-E-Mails über einen Zeitraum von zwei bis vier Wochen zu verwenden, um Ihr E-Mail-Volumen schrittweise zu erhöhen. Überwachen Sie während dieser Zeit den Zustellungsstatus Ihrer E-Mails genau. Diese schrittweise Erhöhung ermöglicht es Drittanbietern von E-Mail-Diensten, sich auf die Änderung der IP-Adresse für den E-Mail-Datenverkehr Ihrer Domäne einzustellen. Die schrittweise Änderung bietet Ihnen Zeit, den Ruf Ihres Absenders zu schützen und die Zuverlässigkeit Ihrer E-Mail-Zustellung aufrechtzuerhalten.
Ratenbegrenzungen für E-Mails
Wir genehmigen höhere Limits für Kunden auf der Grundlage der Anforderungen des Anwendungsfalls, der Domänenzulässigkeit, der Verkehrsmuster und der Ausfallraten. Um höhere Limits zu beantragen, folgen Sie den Anweisungen unter Kontingenterhöhung für E-Mail-Domänen. Höhere Kontingente sind nur für verifizierte benutzerdefinierte Domänen verfügbar, nicht für von Azure verwaltete Domänen.
In der folgenden Tabelle sind Grenzwerte für benutzerdefinierte Domänen aufgeführt.
Vorgang | `Scope` | Zeitrahmen (Minuten) | Grenzwert (Anzahl der E-Mails) |
---|---|---|---|
Senden von E-Mail | Pro Abonnement | 1 | 30 |
Senden von E-Mail | Pro Abonnement | 60 | 100 |
Abrufen des E-Mail-Status | Pro Abonnement | 1 | 60 |
Abrufen des E-Mail-Status | Pro Abonnement | 60 | 200 |
In der folgenden Tabelle sind Grenzwerte für verwaltete Azure-Domänen aufgeführt.
Vorgang | `Scope` | Zeitrahmen (Minuten) | Grenzwert (Anzahl der E-Mails) |
---|---|---|---|
Senden von E-Mail | Pro Abonnement | 1 | 5 |
Senden von E-Mail | 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 für E-Mails
Name | Grenze |
---|---|
Anzahl der Empfänger in einer E-Mail | 50 |
Gesamtgröße von E-Mail-Anforderungen (einschließlich Anlagen) | 10 MB |
Maximale Authentifizierungsverbindungen pro Abonnement | 250 |
Berücksichtigen Sie bei allen Größenbeschränkungen für Nachrichten, dass die Base64-Codierung die Größe der Nachricht erhöht. Sie müssen den Wert für die Größe erhöhen, um die Zunahme der Nachrichtengröße zu berücksichtigen, die auftritt, nachdem die Nachrichtenanhänge und alle anderen Binärdaten Base64-codiert wurden. Die Base64-Codierung erhöht die Größe der Nachricht um etwa 33 %, sodass die Nachricht etwa 33 % größer ist als vor der Codierung. Wenn Sie beispielsweise eine maximale Nachrichtengröße von ungefähr 10 MB angeben, können Sie mit einer realistischen maximalen Nachrichtengröße von ungefähr 7,5 MB rechnen.
Senden von Anlagen über 10 MB
Um E-Mail-Dateianlagen bis zu 30 MB zu senden, füllen Sie eine Supportanfrage aus.
Wenn Sie E-Mail-Dateianlagen mit einer Dateigröße von mehr als 30 MB senden müssen, verwenden Sie diese alternative Lösung. Speichern Sie die Dateien in einem Azure Blob Storage-Konto, und fügen Sie einen Link zu den Dateien in Ihrer E-Mail ein. Sie können die Dateien mit einer Shared Access Signature (SAS) sichern. Eine SAS bietet sicheren delegierten Zugriff auf Ressourcen in Ihrem Speicherkonto. Durch die Verwendung einer SAS können Sie genau steuern, wie ein Client auf Ihre Daten zugreifen kann.
Vorteile der Verwendung eines Blob Storage-Kontos:
- Sie können große Dateien verarbeiten.
- Sie können mithilfe eines SAS oder Schlüssels den Dateizugriff genau verwalten.
Weitere Informationen finden Sie unter:
- Einführung in Azure Blob Storage
- Gewähren von eingeschränktem Zugriff auf Azure Storage-Ressourcen mithilfe von Shared Access Signature
Auszuführende Aktion
Um Ihr E-Mail-Kontingent zu erhöhen, befolgen Sie die Anweisungen unter Kontingenterhöhung für E-Mail-Domänen.
Hinweis
E-Mail-Kontingenterhöhungsanforderungen können bis zu 72 Stunden dauern, um Auswertung und Genehmigung zu erhalten, insbesondere für Anforderungen, die am Freitagnachmittag eingehen.
Chat
Azure Communication Services unterstützt den Chat.
Größenbeschränkungen für Chats
Name | Grenze |
---|---|
Anzahl der Teilnehmer im Thread | 250 |
Teilnehmerbatch: CreateThread |
200 |
Teilnehmerbatch: AddParticipant |
200 |
Seitengröße: ListMessages |
200 |
Nachrichtengröße | 28 KB |
Anzahl Ihrer Azure Communication Services-Ressourcen pro Azure Bot Service | 1.000 |
Ratenbegrenzungen für Chats
Vorgang | `Scope` | Grenzwert pro 10 Sekunden | Grenzwert pro Minute |
---|---|---|---|
Chatthread erstellen | Pro Benutzer | 10 | - |
Chatthread löschen | Pro Benutzer | 10 | - |
Chatthread aktualisieren | Pro Chatthread | 5 | - |
Teilnehmer hinzufügen oder Teilnehmer entfernen | Pro Chatthread | 10 | 30 |
Chatthread abrufen oder Chatthreads auflisten | Pro Benutzer | 50 | - |
Abrufen einer Chatnachricht | Pro Benutzer und Chatthreads | 50 | - |
Abrufen einer Chatnachricht | Pro Chatthread | 250 | - |
Auflisten von Chatnachrichten | Pro Benutzer und Chatthreads | 50 | 200 |
Auflisten von Chatnachrichten | Pro Chatthread | 250 | 400 |
Abrufen von Lesebestätigungen (Limit von 20 Teilnehmenden) | Pro Benutzer und Chatthreads | 5 | - |
Abrufen von Lesebestätigungen (Limit von 20 Teilnehmenden) | Pro Chatthread | 100 | - |
Teilnehmer des Chatthreads auflisten | Pro Benutzer und Chatthreads | 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 und Chatthreads | 10 | 30 |
Eingabeindikator senden | Pro Benutzer und Chatthreads | 5 | 15 |
Eingabeindikator senden | Pro Chatthread | 10 | 30 |
Hinweis
Lesebestätigungen und Eingabeindikatoren werden in Chatthreads mit mehr als 20 Teilnehmenden nicht unterstützt.
Chatspeicher
Azure Communication Services speichert Chatnachrichten gemäß der Aufbewahrungsrichtlinie, die Sie beim Erstellen eines Chatthreads festgelegt haben.
Wichtig
Die in diesem Artikel beschriebenen Funktionen befinden sich derzeit in der öffentlichen Vorschauphase. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und ist nicht für Produktionsworkloads vorgesehen. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.
Über die Aufbewahrungsrichtlinie in der „Chatthread erstellen“-API können Sie zwischen einer unbefristeten Aufbewahrung der Nachricht oder einer automatischen Löschung zwischen 30 und 90 Tagen wählen. Alternativ können Sie auch keine Aufbewahrungsrichtlinie in einem Chatthread festlegen.
Wenn Sie strenge Complianceanforderungen haben, wird empfohlen, die Chatthread-API zum Löschen von Chatthreads zu verwenden. Jeder Thread, der vor der neuen Aufbewahrungsrichtlinie erstellt wurde, ist nicht betroffen, es sei denn, Sie ändern die Richtlinie ausdrücklich für diesen Thread.
Hinweis
Wenn Sie Nachrichten versehentlich löschen, kann das System sie nicht wiederherstellen. Wenn Sie eine Supportanfrage für einen gelöschten Chatthread übermitteln, nachdem die Aufbewahrungsrichtlinie diesen Thread löscht, kann er nicht wieder hergestellt werden. Die Informationen zu diesem Thread sind nicht mehr verfügbar. Öffnen Sie bei Bedarf so schnell wie möglich ein Supportticket innerhalb des 30-Tage-Fensters, nachdem Sie einen Thread erstellt haben, damit wir Sie unterstützen können.
Sprach- und Videoanrufe
Azure Communication Services unterstützt Sprach- und Videoanrufe.
Einschränkungen für PSTN-Anrufe
Name | `Scope` | Begrenzung |
---|---|---|
Standardanzahl wiederkehrender ausgehender Anrufe | Pro Zahl | 2 |
Hinweis
Es gibt keine Beschränkungen für eingehende gleichzeitige Anrufe. Sie können auch eine Anfrage an den Azure-Support senden, um den Grenzwert für gleichzeitige ausgehende Anrufe zu erhöhen. Unser Überprüfungsteam überprüft alle Anfragen.
Einschränkungen für Aufrufmaximum
Name | Grenze |
---|---|
Teilnehmeranzahl | 350 |
Streamingunterstützung des Calling SDK
Das Calling SDK von Azure Communication Services unterstützt die folgenden Streamingkonfigurationen:
Begrenzung | Web | Windows/Android/iOS |
---|---|---|
Maximale Anzahl ausgehender lokaler Datenströme, die Sie gleichzeitig senden können. | Ein Video oder eine Bildschirmfreigabe | Ein Video und eine Bildschirmfreigabe |
Maximale Anzahl der eingehenden Remotedatenströme, die gleichzeitig gerendert werden können. | Neun Videos und eine Bildschirmfreigabe | Neun Videos und eine Bildschirmfreigabe |
Obwohl das Anruf-SDK diese Grenzwerte nicht erzwingt, können bei Ihren Benutzern Leistungsbeeinträchtigungen auftreten, wenn Sie sie überschreiten.
Timeouts des Calling SDK
Für die Azure Communication Services Calling SDKs gelten folgende Timeouts:
Aktion | Timeout in Sekunden |
---|---|
Stellen Sie eine erneute Verbindung her oder entfernen Sie einen Teilnehmer. | 120 |
Hinzufügen oder Entfernen einer neuen Modalität aus einem Anruf. (Video- oder Bildschirmfreigabe starten oder beenden.) | 40 |
Timeout beim Vorgang zur Anrufübertragung. | 60 |
Ein Timeout bei 1:1-Verbindungsherstellung. | 85 |
Timeout bei Gruppenverbindungsherstellung. | 85 |
Timeout bei PSTN-Verbindungsherstellung. | 115 |
Timeout beim Heraufstufen von einem 1:1-Anruf auf eine Gruppenverbindung. | 115 |
Auszuführende Aktion
Weitere Informationen zum Sprach- und Videoanruf-SDK und -Dienst finden Sie auf der Übersicht über das aufrufende SDK oder in den bekannten Problemen in SDKs und APIs. Sie können auch eine Anforderung an den Azure-Support senden, um einige der Grenzwerte zu erhöhen. Unser Überprüfungsteam überprüft alle Anfragen.
Auftragsrouter
Wenn Sie eine große Anzahl von Anforderungen senden oder empfangen, erhalten Sie möglicherweise eine ThrottleLimitExceededException
-Fehlermeldung. Dieser Fehler gibt an, dass Sie die Diensteinschränkungen erreichen. Ihre Anforderungen schlagen fehl, bis der Token-Bucket, der zum Verarbeiten von Anforderungen verwendet wird, nach einer bestimmten Zeit aufgefüllt wird.
Ratenbegrenzungen 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 verwenden Sie wahrscheinlich einige Microsoft Graph-APIs, um Besprechungen zu erstellen.
Jeder Dienst, der über Microsoft Graph angeboten wird, hat unterschiedliche Einschränkungen. Dienstspezifische Grenzwerte werden auf dieser Webseite 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. Verwenden Sie die Retry-After
-Verzögerung, um Anforderungen zurückzustellen. Dies ist die schnellste Möglichkeit, die Drosselung wiederherzustellen, da Microsoft Graph weiterhin die Ressourcennutzung protokolliert, während ein Client gedrosselt wird.
Weitere Informationen zu den Drosselungsgrenzwerten von Microsoft Graph finden Sie in der Microsoft Graph-Dokumentation.
Zugehöriger Inhalt
Weitere Informationen finden Sie unter den Optionen für Hilfe und Support.