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. Um Einschränkungsgrenzwerte zu erhöhen, müssen Sie eine Anforderung an den Azure-Support stellen.
- Öffnen Sie das Azure-Portal, und melden Sie sich an.
- Wählen Sie Hilfe und Support.
- Klicken Sie auf Neue Supportanfrage erstellen.
- Geben Sie im Textfeld Problem beschreiben
Technical
ein, und klicken Sie dann auf Start. - Wählen Sie im Dropdownmenü Dienst auswählen die Option Dienst- und Abonnementbeschränkungen (Kontingente) aus, und klicken Sie dann auf Weiter.
- Wählen Sie in der Problembeschreibung den Problemtyp, Abonnement und Kontingenttyp. Klicken Sie anschließend auf Weiter.
- Überprüfen Sie alle empfohlenen Lösungen, falls verfügbar, und klicken Sie dann auf Weiter.
- Fügen Sie nach Bedarf zusätzliche Details hinzu, und klicken Sie dann auf Weiter.
- Überprüfen Sie unter Überprüfen und Erstellen die Informationen, nehmen Sie bei Bedarf Änderungen vor, und klicken Sie dann auf Erstellen.
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 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 auf der Konzeptseite für Telefonnummerntypen und auf der Übersichtsseite zum Telefoniekonzept.
Die Anzahl der Kauflimits kann durch eine Anfrage an den Azure-Support erhöht werden.
- Öffnen Sie das Azure-Portal, und melden Sie sich an.
- Wählen Sie Hilfe und Support.
- Klicken Sie auf Neue Supportanfrage erstellen.
- Geben Sie im Textfeld Problem beschreiben
Technical
ein, und klicken Sie dann auf Start. - Wählen Sie im Dropdownmenü Dienst auswählen die Option Dienst- und Abonnementbeschränkungen (Kontingente) aus, und klicken Sie dann auf Weiter.
- Wählen Sie in der Problembeschreibung den Problemtyp, Abonnement und Kontingenttyp. Klicken Sie anschließend auf Weiter.
- Überprüfen Sie alle empfohlenen Lösungen, falls verfügbar, und klicken Sie dann auf Weiter.
- Fügen Sie nach Bedarf zusätzliche Details hinzu, und klicken Sie dann auf Weiter.
- Überprüfen Sie unter Überprüfen und Erstellen die Informationen, nehmen Sie bei Bedarf Änderungen vor, und klicken Sie dann auf Erstellen.
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 Dienstbeschrä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
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 wiederholen, nachdem die Retry-After-Zeit vergangen ist. Ergreifen Sie Maßnahmen, bevor Sie den Grenzwert erreichen, indem Sie bei Bedarf eine Erhöhung Ihrer Sendevolumenlimits anfordern.
Der Azure Communication Services-E-Mail-Dienst wurde entwickelt, um hohen Durchsatz zu unterstützen. Der Dienst sieht jedoch 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. Wir empfehlen, Ihr E-Mail-Volumen mit Azure Communication Services Email über einen Zeitraum von zwei bis vier Wochen schrittweise zu erhöhen und dabei den Zustellungsstatus Ihrer E-Mails genau zu überwachen. 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.
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 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 |
Bei allen Größenbeschränkungen für Nachrichten müssen Sie berücksichtigen, 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 ~10 MB angeben, können Sie mit einer realistischen maximalen Nachrichtengröße von ca. ~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, können Sie diese alternative Lösung verwenden. 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 Azure Blob Storage-Kontos:
- Sie können große Dateien verarbeiten.
- Sie können mithilfe von SAS-Schlüsseln 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 SAS (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
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 für Chats
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 |
Ratenbegrenzungen für Chats
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 Teilnehmenden*) | Pro Benutzer*in und Thread | 5 | - |
Abrufen von Lesebestätigungen (Limit von 20 Teilnehmenden*) | 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 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, empfehlen wir, Chatthreads mithilfe der „Chatthread löschen“-API zu löschen. 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 versehentlich Nachrichten gelöscht haben, können sie nicht vom System wiederhergestellt werden. Wenn Sie eine Supportanfrage für einen gelöschten Chatthread nach dem Löschen dieses Threads durch die Aufbewahrungsrichtlinie stellen, kann er außerdem nicht mehr abgerufen werden, und es sind keine Informationen mehr zu diesem Thread 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
Einschränkungen für PSTN-Anrufe
Name | Umfang | Begrenzung |
---|---|---|
Standardanzahl wiederkehrender ausgehender* Anrufe | Pro Nummer | 2 |
Hinweis
* Keine Beschränkungen für eingehende gleichzeitige Anrufe. Sie können auch eine Anforderung an den Azure-Support senden, um den Grenzwert für ausgehende gleichzeitige Anrufe zu erhöhen. Diese wird von unserem Team überprüft.
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 | 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 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. Sie können auch eine Anfrage an den Azure-Support senden, um einige der Grenzwerte zu erhöhen, nachdem eine Überprüfung durch unser Team stattgefunden hat.
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 bei Ihren Anforderungen treten Fehler auf, bis das Token des Buckets zum Verarbeiten von Anforderungen nach einer bestimmten Zeit aufgefrischt 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 den Drosselungsgrenzwerten von Microsoft Graph finden Sie in der Microsoft Graph-Dokumentation.
Nächste Schritte
Weitere Informationen finden Sie unter den Optionen für Hilfe und Support.