Servicelimieten voor Azure Communication Services
In dit document worden de beperkingen van Azure Communication Services-API's en mogelijke oplossingen uitgelegd.
Beperkingspatronen en -architectuur
Wanneer u servicebeperkingen bereikt, ontvangt u een HTTP-statuscode 429 (te veel aanvragen). Over het algemeen zijn de volgende aanbevolen procedures voor het afhandelen van 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 van Azure Architecture voor beperkingspatronen. Beperkingslimieten kunnen worden verhoogd via een aanvraag voor Azure-ondersteuning.
- Open Azure Portal en meld u aan.
- Selecteer Help+ Ondersteuning.
- Klik op Nieuwe ondersteuningsaanvraag maken.
- Voer in het tekstvak Uw probleem beschrijven de tekst in
Technicalen klik op Ga. - Selecteer service- en abonnementslimieten (quota) in het vervolgkeuzemenu Een service selecteren en klik vervolgens op Volgende.
- Kies in de beschrijving van het probleem het type probleem, het abonnement en het quotumtype en klik vervolgens op Volgende.
- Bekijk indien beschikbaar een aanbevolen oplossing en klik vervolgens op Volgende.
- Voeg indien nodig aanvullende details toe en klik vervolgens op Volgende.
- Controleer bij Controleren en maken de informatie, breng indien nodig wijzigingen aan en klik vervolgens op Maken.
U kunt de documentatie voor het maken van een aanvraag voor Azure-ondersteuning volgen.
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 onderstaande beperkingen gelden voor inkoopnummers via de Telefoon Numbers SDK en Azure Portal.
| Operation | Bereik | Tijdsbestek | Limiet (aantal aanvragen) |
|---|---|---|---|
| Telefoonnummer kopen | Azure-tenant | - | 1 |
| Telefoonnummers zoeken | Azure-tenant | één week | 5 |
Actie die moet worden uitgevoerd
Zie de conceptpagina van het type telefoonnummer en de overzichtspagina van het telefonieconcept voor meer informatie.
Als u meer telefoonnummers wilt kopen of een speciale bestelling wilt plaatsen, volgt u de instructies hier. Als u gratis telefoonnummers van externe accounts wilt overzetten naar hun Azure Communication Services-account, volgt u de instructies hier.
Identiteit
| Operation | Tijdsbestekken (seconden) | Limiet (aantal aanvragen) |
|---|---|---|
| Identiteit maken | 30 | 1000 |
| Identiteit verwijderen | 30 | 500 |
| Toegangstoken uitgeven | 30 | 1000 |
| Toegangstoken intrekken | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
Actie die moet worden uitgevoerd
We raden u aan identiteiten en tokens te verkrijgen voordat u chatthreads maakt of gesprekken start. Bijvoorbeeld wanneer de webpagina wordt geladen of de toepassing wordt gestart.
Zie de overzichtspagina van het identiteitsconcept 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 de servicebeperkingen bereikt en dat uw berichten in de wachtrij worden geplaatst om te worden verzonden zodra het aantal aanvragen onder de drempelwaarde ligt.
Frequentielimieten voor SMS:
| Operation | Nummertype | Bereik | Tijdsbestek (s) | Limiet (aanvraag #) | Berichteenheden per minuut |
|---|---|---|---|---|---|
| Bericht verzenden | Gratis | 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 De ondersteuning van Azure om een hogere doorvoer in te schakelen.
Zie de overzichtspagina van de SMS SDK of de pagina veelgestelde vragen over sms voor meer informatie over de SMS SDK en de service.
E-mailen
Er geldt een limiet voor het aantal e-mailberichten dat u gedurende een bepaalde periode kunt verzenden. Als u de volgende limieten voor uw abonnement overschrijdt, worden uw aanvragen geweigerd. U kunt deze aanvragen opnieuw proberen wanneer de tijd voor opnieuw proberen is verstreken. U kunt zo nodig een aanvraag indienen om de verzendvolumelimieten te verhogen.
Frequentielimieten
| Operation | Bereik | Tijdsbestek (minuten) | Limiet (aantal e-mailberichten) |
|---|---|---|---|
| E-mailbericht verzenden | Per abonnement | 1 | 30 |
| E-mailbericht verzenden | Per abonnement | 60 | 100 |
| E-mailstatus ophalen | Per abonnement | 1 | 60 |
| E-mailstatus ophalen | Per abonnement | 60 | 200 |
| Operation | Bereik | Tijdsbestek (minuten) | Limiet (aantal e-mailberichten) |
|---|---|---|---|
| E-mailbericht verzenden | Per abonnement | 1 | 5 |
| E-mailbericht verzenden | Per abonnement | 60 | 10 |
| E-mailstatus ophalen | Per abonnement | 1 | 10 |
| E-mailstatus ophalen | Per abonnement | 60 | 20 |
Groottelimieten
| Naam | Limiet |
|---|---|
| Aantal geadresseerden in e-mail | 50 |
| Totale grootte van e-mailaanvragen (inclusief bijlagen) | 10 MB |
Actie die moet worden uitgevoerd
Deze sandbox-installatie is bedoeld om ontwikkelaars te helpen bij het bouwen van de toepassing. Zodra u een afzenderreputatie hebt ingesteld door e-mailberichten te verzenden, kunt u aanvragen om de limieten voor het verzenden van volumes te verhogen. Dien een ondersteuningsaanvraag in om de gewenste verzendlimiet voor e-mail te verhogen als u een aantal berichten wilt verzenden dat de frequentielimieten overschrijdt. Aanvragen voor het verhogen van e-mailquota worden niet automatisch goedgekeurd. Het beoordelingsteam houdt rekening met uw algehele reputatie van afzenders, waaronder factoren zoals de foutpercentages voor e-mailbezorging, uw domeinreputatie en rapporten van spam en misbruik bij het bepalen van de goedkeuringsstatus.
Notitie
Het kan tot 72 uur duren voordat aanvragen voor het verhogen van e-mailquota worden geëvalueerd en goedgekeurd, met name voor aanvragen die op vrijdagmiddag binnenkomen.
Chat
Groottelimieten
| 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 | 1000 |
Frequentielimieten
| Bewerking | Scope | Limiet per 10 seconden | Limiet per minuut |
|---|---|---|---|
| Chatthread maken | per gebruiker | 10 | - |
| Chatthread verwijderen | per gebruiker | 10 | - |
| Chatthread bijwerken | per chatgesprek | 5 | - |
| Deelnemers toevoegen/deelnemers verwijderen | per chatgesprek | 10 | 30 |
| Chatthread ophalen/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/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 voor chatthreads met meer dan 20 deelnemers.
Chatopslag
In Azure Communication Services worden chatberichten opgeslagen volgens het bewaarbeleid dat u hebt ingesteld 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 chatthreads te verwijderen met behulp van de API Chat-thread 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 hebt verwijderd, kunnen ze niet worden hersteld door het systeem. Als u bovendien een ondersteuningsaanvraag indient voor een verwijderde chat-thread nadat het bewaarbeleid die thread heeft verwijderd, kan deze niet meer worden opgehaald en is er geen informatie over die thread beschikbaar. Open indien nodig zo snel mogelijk een ondersteuningsticket binnen het venster van 30 dagen nadat u een thread hebt gemaakt, zodat we u kunnen helpen.
Audio- en videobellen
Beperkingen voor PSTN-oproepen
| Naam | Scope | Grenswaarde |
|---|---|---|
| Standaardaantal uitgaande* gelijktijdige aanroepen | per getal | 2 |
*: geen limieten voor inkomende gelijktijdige aanroepen. U kunt ook een aanvraag indienen bij Azure-ondersteuning om de limiet voor uitgaande gelijktijdige oproepen te verhogen en deze wordt beoordeeld door ons controleteam.
Maximumlimieten voor oproepen
| Naam | Limiet |
|---|---|
| Aantal deelnemers | 350 |
Ondersteuning voor het aanroepen van SDK-streaming
De Communication Services Calling SDK ondersteunt de volgende streamingconfiguraties:
| Grenswaarde | Web | Windows/Android/iOS |
|---|---|---|
| Maximum aantal uitgaande lokale streams dat u tegelijkertijd kunt verzenden | één video of één scherm delen | één video + één scherm delen |
| Maximum aantal binnenkomende externe streams dat u tegelijkertijd kunt weergeven | 9 video's + één scherm delen | 9 video's + één scherm delen |
Hoewel de Calling SDK deze limieten niet afdwingt, kunnen uw gebruikers prestatievermindering ondervinden als ze worden overschreden.
Time-outs voor aanroepen van SDK
De volgende time-outs zijn van toepassing op de Communication Services Calling SDK's:
| Actie | Time-out in seconden |
|---|---|
| Deelnemer opnieuw verbinden/verwijderen | 120 |
| Nieuwe modaliteit toevoegen aan of verwijderen uit een gesprek (video starten/stoppen of scherm delen) | 40 |
| Time-out voor oproepoverdracht | 60 |
| Time-out voor 1:1 oproepinrichting | 85 |
| Time-out voor het instellen van groepsoproepen | 85 |
| Time-out voor het instellen van PSTN-oproepen | 115 |
| 1:1-oproep verhogen naar een time-out voor groepsgesprekken | 115 |
Actie die moet worden uitgevoerd
Zie de overzichtspagina van de aanroepende SDK of bekende problemen met de SDK voor spraak- en videogesprekken voor meer informatie over de SDK en de service voor spraak- en videogesprekken. U kunt ook een aanvraag indienen bij De ondersteuning van Azure om een aantal limieten te verhogen en vervolgens wordt deze beoordeeld door ons controleteam.
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 en dat uw aanvragen worden verwijderd totdat het token van bucket voor het verwerken van aanvragen 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 | 1000 | 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 hier gedetailleerder beschreven.
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. Het terugzetten van aanvragen met behulp van de Retry-After vertraging 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.
Volgende stappen
Bekijk de help- en ondersteuningsopties .