In dit artikel worden de beperkingen van Api's van Azure Communication Services en mogelijke oplossingen uitgelegd.
Beperkingspatronen en -architectuur
Wanneer u servicebeperkingen bereikt, ontvangt u een HTTP-statuscode 429 (te veel aanvragen). In het algemeen worden de volgende aanbevolen procedures gebruikt voor beperking:
Verminder het aantal bewerkingen per aanvraag.
Verminder de frequentie van aanroepen.
Vermijd onmiddellijke nieuwe pogingen omdat alle aanvragen worden opgebouwd op basis van uw gebruikslimieten.
Meer algemene richtlijnen voor het instellen van uw servicearchitectuur voor het afhandelen van beperkingen en beperkingen in de Documentatie voor Azure-architectuur voor beperkingspatronen. Als u de beperkingslimieten wilt verhogen, dient u een aanvraag in bij De ondersteuning van Azure.
Voordat u een telefoonnummer aanschaft, moet u ervoor zorgen dat uw abonnement voldoet aan de geografische en abonnementsvereisten . Anders kunt u geen telefoonnummer kopen. De volgende beperkingen gelden voor aankoopnummers via de SDK voor telefoonnummers en Azure Portal.
Voer in het tekstvak Uw probleem beschrijven technisch in en selecteer Vervolgens Go.
Selecteer in het vervolgkeuzemenu Een service selecteren de optie Service- en abonnementslimieten (Quota) en selecteer vervolgens Volgende.
Kies in de beschrijving van het probleem de waarden van het type Probleem, Abonnement en Quotum en selecteer vervolgens Volgende.
Bekijk alle aanbevolen oplossingen, indien beschikbaar, en selecteer vervolgens Volgende.
Voeg indien nodig meer details toe en selecteer vervolgens Volgende.
Controleer bij Controleren en maken de informatie, breng indien nodig wijzigingen aan en selecteer Vervolgens Maken.
Identiteit
Operation
Tijdsbestekken (seconden)
Limiet (aantal aanvragen)
Identiteit maken
30
1.000
Identiteit verwijderen
30
500
Toegangstoken uitgeven
30
1.000
Toegangstoken intrekken
30
500
createUserAndToken
30
1.000
exchangeTokens
30
500
Actie die moet worden uitgevoerd
U wordt aangeraden identiteiten en tokens te verkrijgen voordat u chatthreads maakt of gesprekken start. Voer deze taak bijvoorbeeld uit wanneer de webpagina wordt geladen of de toepassing wordt gestart.
Wanneer u een groot aantal berichten verzendt of ontvangt, treedt er mogelijk een 429 fout op. Deze fout geeft aan dat u op het punt staat om de servicebeperkingen te bereiken. Uw berichten worden in de wachtrij geplaatst en verzonden nadat het aantal aanvragen onder de drempelwaarde valt.
Frequentielimieten voor SMS:
Operation
Nummertype
Bereik
Tijdsbestekken
Limiet (aanvraagnummer)
Berichteenheden per minuut
Bericht verzenden
Gratis nummer
Per getal
60
200
200
Bericht verzenden
Korte code
Per getal
60
6000
6000
Bericht verzenden
Alfanumerieke afzender-id
Per resource
60
600
600
Actie die moet worden uitgevoerd
Als u vereisten hebt die de frequentielimieten overschrijden, dient u een aanvraag in bij Azure-ondersteuning om een hogere doorvoer in te schakelen.
U kunt een beperkt aantal e-mailberichten verzenden. Als u de limieten voor e-mailfrequentie voor uw abonnement overschrijdt, worden uw aanvragen geweigerd. U kunt deze aanvragen opnieuw proberen, nadat de tijd opnieuw is verstreken. Neem actie voordat u de limiet bereikt door u aan te vragen om uw verzendvolumelimieten indien nodig te verhogen.
De e-mailservice van Azure Communication Services is ontworpen ter ondersteuning van hoge doorvoer. De service legt echter initiële frequentielimieten op om klanten te helpen soepel te onboarden en een aantal problemen te voorkomen die kunnen optreden bij het overschakelen naar een nieuwe e-mailservice.
We raden u aan om uw e-mailvolume geleidelijk te verhogen met behulp van Azure Communication Services Email gedurende een periode van twee tot vier weken, terwijl de bezorgingsstatus van uw e-mailberichten nauwkeurig wordt bewaakt. Door deze geleidelijke toename kunnen externe e-mailserviceproviders zich aanpassen aan de wijziging in HET IP-adres voor het e-mailverkeer van uw domein. De geleidelijke wijziging geeft u de tijd om de reputatie van uw afzender te beschermen en de betrouwbaarheid van uw e-mailbezorging te behouden.
De e-mailservice van Azure Communication Services ondersteunt een groot volume tot 1-2 miljoen berichten per uur. Hoge doorvoer kan worden ingeschakeld op basis van verschillende factoren, waaronder:
Piekverkeer klant
Bedrijfsbehoeften
Mogelijkheid om foutpercentages te beheren
Domeinreputatie
Vereisten voor foutfrequentie
Als u een hoog e-mailquotum wilt inschakelen, moet uw e-mailfoutpercentage kleiner zijn dan één procent (1%). Als uw foutpercentage hoog is, moet u de problemen oplossen voordat u een quotumverhoging aanvraagt.
Klanten zullen naar verwachting hun foutpercentages actief controleren.
Als het foutpercentage na een quotumverhoging toeneemt, neemt Azure Communication Services contact op met de klant voor onmiddellijke actie en een tijdlijn voor een oplossing. In extreme gevallen, als de foutfrequentie niet binnen de opgegeven tijdlijn wordt beheerd, kan Azure Communication Services de service verminderen of onderbreken totdat het probleem is opgelost.
Verwante artikelen:
Azure Communication Services biedt uitgebreide logboeken en analyses om foutenpercentages te bewaken en te beheren. Raadpleeg voor meer informatie de volgende artikelen:
Als u hogere limieten wilt aanvragen, volgt u de instructies bij Quotumverhoging voor e-maildomeinen. Hogere quota zijn alleen beschikbaar voor geverifieerde aangepaste domeinen, niet voor door Azure beheerde domeinen.
Totale grootte van e-mailaanvragen (inclusief bijlagen)
10 MB
Maximaal aantal geverifieerde verbindingen per abonnement
250
Houd er rekening mee dat base64-codering de grootte van het bericht verhoogt voor alle berichtgrootten. U moet de groottewaarde verhogen om rekening te houden met de berichtgrootte die optreedt nadat de berichtbijlagen en eventuele andere binaire gegevens zijn gecodeerd met Base64. Base64-codering verhoogt de grootte van het bericht met ongeveer 33%, dus de berichtgrootte is ongeveer 33% groter dan de berichtgrootten vóór codering. Als u bijvoorbeeld een maximale berichtgrootte van ongeveer 10 MB opgeeft, kunt u een realistische maximale berichtgrootte van ongeveer 7,5 MB verwachten.
Bronlimieten
Naam
Limiet
SenderUsername/Mailfrom-resource per domein
100
Domeinen die zijn gekoppeld aan een Communication Service-resource
Als u e-mailbestandsbijlagen van meer dan 30 MB wilt verzenden, gebruikt u deze alternatieve oplossing. Sla de bestanden op in een Azure Blob Storage-account en voeg een koppeling toe naar de bestanden in uw e-mail. U kunt de bestanden beveiligen met een Shared Access Signature (SAS). Een SAS biedt beveiligde gedelegeerde toegang tot resources in uw opslagaccount. Met behulp van een SAS hebt u gedetailleerde controle over hoe clients toegang hebben tot uw gegevens.
Voordelen van het gebruik van een Blob Storage-account:
U kunt grootschalige bestanden verwerken.
U kunt een SAS of sleutels gebruiken om de toegang tot bestanden nauwkeurig te beheren.
Het kan tot 72 uur duren voordat aanvragen voor e-mailquotumverhoging worden geëvalueerd en goedgekeurd, met name voor aanvragen die op vrijdagmiddag binnenkomen.
Chat
Azure Communication Services biedt ondersteuning voor chatten.
Groottelimieten voor chatten
Naam
Limiet
Aantal deelnemers in thread
250
Batch deelnemers: CreateThread
200
Batch deelnemers: AddParticipant
200
Paginaformaat: ListMessages
200
Berichtgrootte
28 KB
Aantal Azure Communication Services-resources per Azure Bot Service
1.000
Frequentielimieten voor chatten
Operation
Bereik
Limiet per 10 seconden
Limiet per minuut
Chatthread maken
Per gebruiker
10
-
Chatthread verwijderen
Per gebruiker
10
-
Chatthread bijwerken
Per chatgesprek
5
-
Deelnemers toevoegen of deelnemers verwijderen
Per chatgesprek
10
30
Chatthreads ophalen of chatthreads weergeven
Per gebruiker
50
-
Chatbericht ophalen
Per gebruiker, per chat-thread
50
-
Chatbericht ophalen
Per chatgesprek
250
-
Chatberichten weergeven
Per gebruiker, per chat-thread
50
200
Chatberichten weergeven
Per chatgesprek
250
400
Leesbevestigingen ophalen (limiet van 20 deelnemers)
Per gebruiker, per chat-thread
5
-
Leesbevestigingen ophalen (limiet van 20 deelnemers)
Per chatgesprek
100
-
Deelnemers aan chatthread vermelden
Per gebruiker, per chat-thread
10
-
Deelnemers aan chatthread vermelden
Per chatgesprek
250
-
Bericht verzenden, bericht bijwerken of bericht verwijderen
Per chatgesprek
10
30
Leesbevestiging verzenden
Per gebruiker, per chat-thread
10
30
Indicator voor typen verzenden
Per gebruiker, per chat-thread
5
15
Indicator voor typen verzenden
Per chatgesprek
10
30
Notitie
Leesbevestigingen en typeindicatoren worden niet ondersteund in chatthreads met meer dan 20 deelnemers.
Chatopslag
Azure Communication Services slaat chatberichten op volgens het bewaarbeleid dat u instelt wanneer u een chatgesprek maakt.
Belangrijk
De functionaliteit die in dit artikel wordt beschreven, is momenteel beschikbaar als openbare preview.
Deze preview-versie wordt geleverd zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt.
Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.
U kunt kiezen tussen 30 en 90 dagen tussen 30 en 90 dagen tussen onbepaalde of automatische verwijdering via het bewaarbeleid voor de chatthread-API maken. U kunt er ook voor kiezen om geen bewaarbeleid in te stellen voor een chatgesprek.
Als u strikte nalevingsbehoeften hebt, raden we u aan de Chatthread-API verwijderen te gebruiken om chatthreads te verwijderen. Eventuele threads die zijn gemaakt voordat het nieuwe bewaarbeleid wordt beïnvloed, worden alleen beïnvloed als u het beleid voor die thread specifiek wijzigt.
Notitie
Als u per ongeluk berichten verwijdert, kan het systeem ze niet herstellen. Als u een ondersteuningsaanvraag indient voor een verwijderde chat-thread nadat het bewaarbeleid die thread heeft verwijderd, kan deze niet worden opgehaald. Informatie over die thread is niet meer beschikbaar. Open zo nodig zo snel mogelijk een ondersteuningsticket in het venster van 30 dagen nadat u een thread hebt gemaakt, zodat we u kunnen helpen.
Audio- en videobellen
Azure Communication Services ondersteunt spraak- en videogesprekken.
Beperkingen voor PSTN-aanroepen
Naam
Bereik
Grenswaarde
Standaardaantal uitgaande gelijktijdige aanroepen
Per getal
2
Notitie
Er gelden geen limieten voor inkomende gelijktijdige aanroepen. U kunt ook een aanvraag indienen bij azure-ondersteuning om de limiet voor uitgaande gelijktijdige oproepen te verhogen. Ons controleteam beoordeelt alle aanvragen.
Maximumlimieten voor oproepen
Naam
Limiet
Aantal deelnemers
350
Ondersteuning voor het aanroepen van SDK-streaming
De Azure Communication Services Calling SDK ondersteunt de volgende streamingconfiguraties:
Grenswaarde
Web
Windows/Android/iOS
Maximum aantal uitgaande lokale streams dat u tegelijkertijd kunt verzenden.
Eén video of één scherm delen
Eén video + één scherm delen
Maximum aantal binnenkomende externe streams dat u tegelijkertijd kunt weergeven.
Negen video's + één scherm delen
Negen video's + één scherm delen
De Calling SDK dwingt deze limieten niet af, maar uw gebruikers kunnen prestatievermindering ervaren als u deze limieten overschrijdt.
Time-outs voor aanroepen van SDK
De volgende time-outs zijn van toepassing op de Aanroepende SDK's van Azure Communication Services:
Actie
Time-out in seconden
Maak opnieuw verbinding of verwijder een deelnemer.
120
Nieuwe modaliteit toevoegen aan of verwijderen uit een gesprek. (Video of scherm delen starten of stoppen.)
40
Time-out van oproepoverdracht.
60
Een time-out voor het instellen van 1:1 oproepen.
85
Time-out voor groepsoproepinstelling.
85
Time-out voor het instellen van PSTN-oproepen.
115
Een 1:1-oproep promoveren naar een time-out voor groepsgesprekken.
Wanneer u een groot aantal aanvragen verzendt of ontvangt, treedt er mogelijk een ThrottleLimitExceededException fout op. Deze fout geeft aan dat u de servicebeperkingen bereikt. Uw aanvragen mislukken totdat de tokenbucket die wordt gebruikt om aanvragen te verwerken, na een bepaalde tijd wordt aangevuld.
Frequentielimieten voor taakrouter
Operation
Bereik
Tijdsbestek (seconden)
Limiet (aantal aanvragen)
Time-out in seconden
Algemene aanvragen
Per resource
10
1.000
10
Actie die moet worden uitgevoerd
Als u een volume berichten wilt verzenden die de frequentielimieten overschrijden, stuurt u ons een e-mail naar acs-ccap@microsoft.com.
Teams-interoperabiliteit en Microsoft Graph
Met behulp van een Teams-interoperabiliteitsscenario gebruikt u waarschijnlijk enkele Microsoft Graph-API's om vergaderingen te maken.
Elke service die via Microsoft Graph wordt aangeboden, heeft verschillende beperkingen. Servicespecifieke limieten worden gedetailleerder beschreven op deze webpagina .
Actie die moet worden uitgevoerd
Gebruik de HTTP-foutcode 429 om beperking te detecteren wanneer u foutafhandeling implementeert. Het mislukte antwoord bevat de Retry-After antwoordheader. Gebruik de Retry-After vertraging om aanvragen af te maken. Het is de snelste manier om te herstellen van beperking, omdat Microsoft Graph het resourcegebruik blijft registreren terwijl een client wordt beperkt.
Meer informatie over het beheren van de reputatie van afzenders en e-mailklachten om de bezorging van e-mail in uw communicatie tussen bedrijven te verbeteren.