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
Technical
en 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 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 | éé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
U kunt een beperkt aantal e-mailberichten verzenden. Als u de volgende limieten 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.
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 |
Bijlagen verzenden die groter zijn dan 10 MB
Als u bestandsbijlagen van maximaal 30 MB per e-mail wilt verzenden, moet u een ondersteuningsaanvraag voltooien.
Als u e-mailbestandsbijlagen wilt verzenden die groter zijn dan 30 MB, kunt u deze alternatieve oplossing gebruiken. 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). SAS biedt beveiligde gedelegeerde toegang tot resources in uw opslagaccount. Door SAS te gebruiken, hebt u gedetailleerde controle over hoe clients toegang hebben tot uw gegevens.
Voordelen van het gebruik van een Azure Blob Storage-account:
- U kunt grootschalige bestanden verwerken.
- U kunt SAS-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 door middel van een SAS
Actie die moet worden uitgevoerd
Volg de instructies bij Quotumverhoging voor e-maildomeinen om uw e-mailquotum te verhogen.
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 in 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 |
Notitie
* Geen limieten voor inkomende gelijktijdige aanroepen. U kunt ook een aanvraag indienen bij Azure-ondersteuning om de limiet voor uitgaande gelijktijdige aanroepen te verhogen. Deze limiet 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 | 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 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 van de limieten te verhogen, in behandeling 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 mislukken totdat het token van bucket voor het afhandelen 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 .