Servicelimieten voor Azure Communication Services
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.
- Open Azure Portal en meld u aan.
- Selecteer Help+ Ondersteuning.
- Selecteer Nieuwe ondersteuningsaanvraag maken.
- 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 een aanbevolen oplossing, indien beschikbaar, en selecteer vervolgens Volgende.
- Voeg indien nodig andere details toe en selecteer Volgende.
- Controleer bij Controleren en maken de informatie, breng indien nodig wijzigingen aan en selecteer Vervolgens Maken.
Volg de stappen om een aanvraag in te dienen bij De ondersteuning van Azure.
Telefoonnummers verkrijgen
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.
| Operation | Bereik | Tijdsbestek | Limiet (aantal aanvragen) |
|---|---|---|---|
| Telefoonnummer kopen | Azure-tenant | - | 1 |
| Telefoonnummers zoeken | Azure-tenant | Eén week | 5 |
Actie die moet worden uitgevoerd
Zie Telefoonnummertypen en Telefonieconcepten voor meer informatie.
Als u het aantal aankooplimieten wilt verhogen, dient u een aanvraag in bij De ondersteuning van Azure.
- Open Azure Portal en meld u aan.
- Selecteer Help+ Ondersteuning.
- Selecteer Nieuwe ondersteuningsaanvraag maken.
- 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.
Zie Verifiëren bij Azure Communication Services voor meer informatie.
Sms
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.
Zie het sms SDK-overzicht of de veelgestelde vragen over sms voor meer informatie over de SMS SDK en de service.
E-mailen
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:
- De reputatie van afzenders verbeteren in e-mail van Azure Communication Services
- E-mailinzichten
- Logboeken inschakelen via diagnostische instellingen in Azure Monitor
- Quickstart: E-mail gebeurtenissen afhandelen
- Quickstart: Lijsten voor domeinonderdrukking beheren in Azure Communication Services met behulp van de beheerclientbibliotheken
Notitie
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.
Frequentielimieten voor e-mail
| Operation | Bereik | Tijdsbestek (minuten) | Limiet (aantal e-mailberichten) | Hogere limieten beschikbaar |
|---|---|---|---|---|
| E-mailbericht verzenden | Per abonnement | 1 | 30 | Ja |
| E-mailbericht verzenden | Per abonnement | 60 | 100 | Ja |
| E-mailstatus ophalen | Per abonnement | 1 | 60 | Ja |
| E-mailstatus ophalen | Per abonnement | 60 | 200 | Ja |
De volgende tabel bevat limieten voor door Azure beheerde domeinen.
| Operation | Bereik | Tijdsbestek (minuten) | Limiet (aantal e-mailberichten) | Hogere limieten beschikbaar |
|---|---|---|---|---|
| E-mailbericht verzenden | Per abonnement | 1 | 5 | Nee |
| E-mailbericht verzenden | Per abonnement | 60 | 10 | Nee |
| E-mailstatus ophalen | Per abonnement | 1 | 10 | Nee |
| E-mailstatus ophalen | Per abonnement | 60 | 20 | Nee |
Groottelimieten voor e-mail
| Naam | Limiet |
|---|---|
| Aantal geadresseerden in e-mail | 50 |
| 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.
Bijlagen verzenden die groter zijn dan 10 MB
Als u bestandsbijlagen tot 30 MB wilt e-mailen, dient u een ondersteuningsaanvraag in.
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.
Zie voor meer informatie:
- Inleiding tot Azure Blob-opslag
- Beperkte toegang verlenen tot Azure Storage-resources met behulp van handtekeningen voor gedeelde toegang
Actie die moet worden uitgevoerd
Volg de instructies in Quotumverhoging voor e-maildomeinen om uw e-mailquotum te verhogen.
Notitie
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. | 115 |
Actie die moet worden uitgevoerd
Zie voor meer informatie over de SDK en service voor spraak- en videogesprekken het overzicht van de Calling SDK of bekende problemen in de SDK's en API's. U kunt ook een aanvraag indienen bij De ondersteuning van Azure om een aantal van de limieten te verhogen. Ons controleteam beoordeelt alle aanvragen.
Taakrouter
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 beperkingslimieten voor Microsoft Graph vindt u in de Documentatie van Microsoft Graph.