Tjänstebegränsningar för Azure Communication Services
I det här dokumentet förklaras begränsningarna för API:er för Azure Communication Services och möjliga lösningar.
Begränsningsmönster och arkitektur
När du når tjänstbegränsningar får du http-statuskoden 429 (för många begäranden). I allmänhet är följande metodtips för hantering av begränsning:
- Minska antalet åtgärder per begäran.
- Minska frekvensen för anrop.
- Undvik omedelbara återförsök eftersom alla begäranden ackumuleras mot din användningsförbrukning.
Du hittar mer allmän vägledning om hur du konfigurerar din tjänstarkitektur för att hantera begränsningar och begränsningar i Azure Architecture-dokumentationen för begränsningsmönster. Begränsningsgränser kan ökas genom en begäran till Azure-supporten.
- Öppna Azure Portal och logga in.
- Välj Hjälp+support.
- Klicka på Skapa ny supportbegäran.
- I textrutan Beskriv problemet anger du
Technicaloch klickar sedan på Gå. - I listrutan Välj en tjänst väljer du Tjänst- och prenumerationsgränser (Kvoter) och klickar sedan på Nästa.
- I problembeskrivningen väljer du typ av problem, prenumeration och kvot och klickar sedan på Nästa.
- Granska valfri rekommenderad lösning om den är tillgänglig och klicka sedan på Nästa.
- Lägg till ytterligare information efter behov och klicka sedan på Nästa.
- I Granska + skapa kontrollerar du informationen, gör ändringar efter behov och klickar sedan på Skapa.
Du kan följa dokumentationen för att skapa en begäran till Azure Support.
Skaffa telefonnummer
Innan du skaffar ett telefonnummer kontrollerar du att din prenumeration uppfyller kraven för geografiska platser och prenumerationer . Annars kan du inte köpa ett telefonnummer. Följande begränsningar gäller för köpnummer via SDK för telefonnummer och Azure Portal.
| Åtgärd | Omfattning | Tidsram | Gräns (antal begäranden) |
|---|---|---|---|
| Köpa telefonnummer | Azure-klientorganisation | - | 1 |
| Sök efter telefonnummer | Azure-klientorganisation | en vecka | 5 |
Åtgärd att vidta
Mer information finns på konceptsidan för telefonnummertyper och översiktssidan för telefonikonceptet .
Begränsningar för nummerköp kan ökas genom en begäran till Azure-supporten.
- Öppna Azure Portal och logga in.
- Välj Hjälp+support.
- Klicka på Skapa ny supportbegäran.
- I textrutan Beskriv problemet anger du
Technicaloch klickar sedan på Gå. - I listrutan Välj en tjänst väljer du Tjänst- och prenumerationsgränser (Kvoter) och klickar sedan på Nästa.
- I problembeskrivningen väljer du typ av problem, prenumeration och kvot och klickar sedan på Nästa.
- Granska valfri rekommenderad lösning om den är tillgänglig och klicka sedan på Nästa.
- Lägg till ytterligare information efter behov och klicka sedan på Nästa.
- I Granska + skapa kontrollerar du informationen, gör ändringar efter behov och klickar sedan på Skapa.
Identitet
| Åtgärd | Tidsramar (sekunder) | Gräns (antal begäranden) |
|---|---|---|
| Skapa identitet | 30 | 1000 |
| Ta bort identitet | 30 | 500 |
| Problem med åtkomsttoken | 30 | 1000 |
| Återkalla åtkomsttoken | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
Åtgärd att vidta
Vi rekommenderar att du hämtar identiteter och token innan du skapar chatttrådar eller startar anrop. Till exempel när webbsidan läses in eller programmet startar.
Mer information finns på översiktssidan för identitetskonceptet.
SMS
När du skickar eller tar emot en stor mängd meddelanden kan du få ett 429 fel. Det här felet anger att du når tjänstbegränsningarna och att dina meddelanden placeras i kö för att skickas när antalet begäranden är under tröskelvärdet.
Hastighetsbegränsningar för SMS
| Åtgärd | Nummertyp | Omfattning | Tidsram (s) | Gräns (begäran #) | Meddelandeenheter per minut |
|---|---|---|---|---|---|
| Skicka meddelande | Avgiftsfritt | Per nummer | 60 | 200 | 200 |
| Skicka meddelande | Kort kod | Per nummer | 60 | 6000 | 6000 |
| Skicka meddelande | Alfanumeriskt avsändar-ID | Per resurs | 60 | 600 | 600 |
Åtgärd att vidta
Om du har krav som överskrider hastighetsgränserna skickar du en begäran till Azure Support för att aktivera högre dataflöde.
Mer information om SMS SDK och tjänsten finns på översiktssidan för SMS SDK eller sidan MED VANLIGA FRÅGOR och svar om SMS.
Du kan skicka ett begränsat antal e-postmeddelanden. Om du överskrider gränserna för e-postfrekvens för din prenumeration avvisas dina begäranden. Du kan försöka dessa begäranden igen när tiden för återförsök har passerat. Vidta åtgärder innan du når gränsen genom att begära att du höjer gränserna för sändningsvolymen om det behövs.
E-posttjänsten för Azure Communication Services är utformad för att stödja högt dataflöde. Tjänsten inför dock initiala hastighetsgränser för att hjälpa kunderna att registrera sig smidigt och undvika några av de problem som kan uppstå när de byter till en ny e-posttjänst.
Vi rekommenderar att du gradvis ökar din e-postvolym med Azure Communication Services Email under en period på två till fyra veckor, samtidigt som du noga övervakar leveransstatusen för dina e-postmeddelanden. Den här gradvisa ökningen gör det möjligt för tredjepartsleverantörer av e-posttjänster att anpassa sig till ändringen i IP-adressen för din domäns e-posttrafik. Den gradvisa ändringen ger dig tid att skydda avsändarens rykte och upprätthålla tillförlitligheten för din e-postleverans.
E-posttjänsten i Azure Communication Services har stöd för en hög volym på upp till 1–2 miljoner meddelanden per timme. Högt dataflöde kan aktiveras baserat på flera faktorer, bland annat:
- Kundens högsta trafik
- Affärsbehov
- Möjlighet att hantera felfrekvenser
- Domänrykte
Krav för felfrekvens
Om du vill aktivera en hög e-postkvot måste din e-postfelfrekvens vara mindre än en procent (1 %). Om felfrekvensen är hög måste du lösa problemen innan du begär en kvotökning. Kunderna förväntas aktivt övervaka sina felfrekvenser.
Om felfrekvensen ökar efter en kvotökning kontaktar Azure Communication Services kunden för omedelbara åtgärder och en tidslinje för lösning. Om felfrekvensen i extrema fall inte hanteras inom den angivna tidslinjen kan Azure Communication Services minska eller pausa tjänsten tills problemet har lösts.
Relaterade artiklar
Azure Communication Services tillhandahåller omfattande loggar och analyser som hjälper dig att övervaka och hantera felfrekvenser. Mer information finns i följande artiklar:
- Förbättra avsändarens rykte i Azure Communication Services-e-post
- E-postinsikter
- Aktivera loggar via diagnostikinställningar i Azure Monitor
- Snabbstart: Hantera e-posthändelser
- Snabbstart: Hantera domänundertryckningslistor i Azure Communication Services med hjälp av hanteringsklientbiblioteken
Kommentar
Om du vill begära högre gränser följer du anvisningarna vid Kvotökning för e-postdomäner. Högre kvoter är endast tillgängliga för verifierade anpassade domäner, inte Azure-hanterade domäner.
Frekvensgränser för e-post
| Åtgärd | Omfattning | Tidsram (minuter) | Gräns (antal e-postmeddelanden) |
|---|---|---|---|
| Skicka e-post | Per prenumeration | 1 | 30 |
| Skicka e-post | Per prenumeration | 60 | 100 |
| Hämta e-poststatus | Per prenumeration | 1 | 60 |
| Hämta e-poststatus | Per prenumeration | 60 | 200 |
| Åtgärd | Omfattning | Tidsram (minuter) | Gräns (antal e-postmeddelanden) |
|---|---|---|---|
| Skicka e-post | Per prenumeration | 1 | 5 |
| Skicka e-post | Per prenumeration | 60 | 10 |
| Hämta e-poststatus | Per prenumeration | 1 | 10 |
| Hämta e-poststatus | Per prenumeration | 60 | 20 |
Storleksgränser för e-post
| Namn | Begränsning |
|---|---|
| Antal mottagare i e-post | 50 |
| Total storlek på e-postbegäran (inklusive bifogade filer) | 10 MB |
| Maximalt antal autentiserade anslutningar per prenumeration | 250 |
För alla storleksbegränsningar för meddelanden måste du tänka på att base64-kodningen ökar meddelandets storlek. Du måste öka storleksvärdet för att ta hänsyn till den ökning av meddelandestorleken som sker efter att meddelandebilagorna och andra binära data är Base64-kodade. Base64-kodning ökar storleken på meddelandet med cirka 33 %, så meddelandestorleken är cirka 33 % större än meddelandestorlekarna före kodning. Om du till exempel anger ett maximalt meddelandestorleksvärde på ~10 MB kan du förvänta dig ett realistiskt maximalt meddelandestorleksvärde på cirka ~7,5 MB.
Skicka bifogade filer som är större än 10 MB
Om du vill skicka bifogade filer via e-post till upp till 30 MB slutför du en supportbegäran.
Om du behöver skicka bifogade filer för e-postfiler som är större än 30 MB kan du använda den här alternativa lösningen. Lagra filerna i ett Azure Blob Storage-konto och inkludera en länk till filerna i e-postmeddelandet. Du kan skydda filerna med en signatur för delad åtkomst (SAS). SAS ger säker delegerad åtkomst till resurser i ditt lagringskonto. Genom att använda SAS har du detaljerad kontroll över hur klienter kan komma åt dina data.
Fördelar med att använda ett Azure Blob Storage-konto:
- Du kan hantera storskaliga filer.
- Du kan använda SAS-nycklar för att exakt hantera filåtkomst.
Mer information finns i:
- Introduktion till Azure Blob Storage
- Grant limited access to Azure Storage resources using shared access signatures (SAS) (Bevilja begränsad åtkomst till Azure Storage-resurser med hjälp av signaturer för delad åtkomst (SAS))
Åtgärd att vidta
Om du vill öka din e-postkvot följer du anvisningarna i Kvotökning för e-postdomäner.
Kommentar
Det kan ta upp till 72 timmar innan begäranden om e-postkvotökning utvärderas och godkänns, särskilt för begäranden som kommer in på fredagseftermiddagen.
Chatt
Storleksgränser för chatt
| Namn | Begränsning |
|---|---|
| Antal deltagare i tråden | 250 |
| Batch med deltagare – CreateThread | 200 |
| Batch med deltagare – AddParticipant | 200 |
| Sidstorlek – ListMessages | 200 |
| Meddelandestorlek | 28 KB |
| Antal Azure Communication Services-resurser per Azure Bot | 1000 |
Frekvensgränser för chatt
| Åtgärd | Definitionsområde | Gräns per 10 sekunder | Gräns per minut |
|---|---|---|---|
| Skapa chatttråd | per användare | 10 | - |
| Ta bort chatttråd | per användare | 10 | - |
| Uppdatera chatttråd | per chatttråd | 5 | - |
| Lägga till deltagare/ta bort deltagare | per chatttråd | 10 | 30 |
| Hämta chatttråd/Lista chatttrådar | per användare | 50 | - |
| Hämta chattmeddelande | per användare per chatttråd | 50 | - |
| Hämta chattmeddelande | per chatttråd | 250 | - |
| Lista chattmeddelanden | per användare per chatttråd | 50 | 200 |
| Lista chattmeddelanden | per chatttråd | 250 | 400 |
| Hämta läskvitton (20 deltagares gräns*) | per användare per chatttråd | 5 | - |
| Hämta läskvitton (20 deltagares gräns*) | per chatttråd | 100 | - |
| Lista chatttrådsdeltagare | per användare per chatttråd | 10 | - |
| Lista chatttrådsdeltagare | per chatttråd | 250 | - |
| Skicka meddelande/uppdatera meddelande/ta bort meddelande | per chatttråd | 10 | 30 |
| Skicka läskvitto | per användare per chatttråd | 10 | 30 |
| Indikator för att skicka inmatning | per användare per chatttråd | 5 | 15 |
| Indikator för att skicka inmatning | per chatttråd | 10 | 30 |
Kommentar
* Läskvitton och skrivindikatorer stöds inte i chatttrådar med fler än 20 deltagare.
Chattlagring
Azure Communication Services lagrar chattmeddelanden enligt den kvarhållningsprincip som du anger när du skapar en chatttråd.
Viktigt!
Funktioner som beskrivs i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.
Du kan välja mellan obegränsad kvarhållning av meddelanden eller automatisk borttagning mellan 30 och 90 dagar via kvarhållningsprincipen i API:et Skapa chatttråd. Du kan också välja att inte ange en kvarhållningsprincip i en chatttråd.
Om du har strikta efterlevnadsbehov rekommenderar vi att du tar bort chatttrådar med hjälp av API :et Delete Chat Thread. Alla trådar som skapats innan den nya kvarhållningsprincipen påverkas inte om du inte specifikt ändrar principen för den tråden.
Kommentar
Om du har tagit bort meddelanden av misstag kan de inte återställas av systemet. Om du skickar en supportbegäran för en borttagen chatttråd efter att kvarhållningsprincipen har tagit bort tråden kan den inte längre hämtas och ingen information om den tråden är tillgänglig. Om det behövs öppnar du ett supportärende så snabbt som möjligt inom 30-dagarsfönstret efter att du har skapat en tråd så att vi kan hjälpa dig.
Röst- och videosamtal
Begränsningar för PSTN-samtal
| Namn | Definitionsområde | Gräns |
|---|---|---|
| Standardantal utgående* samtidiga anrop | per nummer | 2 |
Kommentar
* Inga gränser för inkommande samtidiga anrop. Du kan också skicka en begäran till Azure Support om att öka gränsen för utgående samtidiga anrop, som granskas av vårt granskningsteam.
Samtalsbegränsningar
| Namn | Begränsning |
|---|---|
| Antal deltagare | 350 |
Stöd för att anropa SDK-strömning
Communication Services Calling SDK stöder följande strömningskonfigurationer:
| Gräns | Webb | Windows/Android/iOS |
|---|---|---|
| Maximalt antal utgående lokala strömmar som du kan skicka samtidigt | en video eller en skärmdelning | en video + en skärmdelning |
| Maximalt antal inkommande fjärrströmmar som du kan återge samtidigt | nio videor + en skärmdelning | nio videor + en skärmdelning |
Anropande SDK tillämpar inte dessa gränser, men dina användare kan uppleva prestandaförsämring om du överskrider dessa gränser.
Anropa SDK-timeouter
Följande tidsgränser gäller för SDK:er för kommunikationstjänster som anropar:
| Åtgärd | Timeout i sekunder |
|---|---|
| Återansluta/ta bort deltagare | 120 |
| Lägga till eller ta bort ny modalitet från ett anrop (Starta/stoppa video- eller skärmdelning) | 40 |
| Tidsgräns för samtalsöverföringsåtgärd | 60 |
| 1:1 Tidsgräns för samtalsetablissemang | 85 |
| Tidsgräns för gruppsamtalsetablering | 85 |
| Tidsgräns för PSTN-samtalsetableringsetablering | 115 |
| Flytta upp 1:1-samtal till en timeout för gruppsamtal | 115 |
Åtgärd att vidta
Mer information om SDK och tjänst för röst- och videosamtal finns på översiktssidan för SDK för samtal eller kända problem. Du kan också skicka en begäran till Azure Support om att öka vissa av gränserna i väntan på granskning av vårt granskningsteam.
Jobbrouter
När du skickar eller tar emot en stor mängd begäranden kan du få ett ThrottleLimitExceededException fel. Det här felet anger att du når tjänstbegränsningarna och dina begäranden misslyckas tills token för bucketen för att hantera begäranden fylls på efter en viss tid.
Hastighetsbegränsningar för jobbrouter
| Åtgärd | Omfattning | Tidsram (sekunder) | Gräns (antal begäranden) | Timeout i sekunder |
|---|---|---|---|---|
| Allmänna begäranden | Per resurs | 10 | 1000 | 10 |
Åtgärd att vidta
Om du behöver skicka en mängd meddelanden som överskrider hastighetsgränserna skickar du ett e-postmeddelande till oss på acs-ccap@microsoft.com.
Teams interoperabilitet och Microsoft Graph
Med hjälp av ett Teams-samverkansscenario använder du ofta Microsoft Graph-API:er för att skapa möten.
Varje tjänst som erbjuds via Microsoft Graph har olika begränsningar. tjänstspecifika gränser beskrivs här i detalj.
Åtgärd att vidta
När du implementerar felhantering använder du HTTP-felkoden 429 för att identifiera begränsning. Det misslyckade svaret innehåller svarshuvudet Retry-After . Att säkerhetskopiera begäranden med fördröjningen Retry-After är det snabbaste sättet att återställa från begränsning eftersom Microsoft Graph fortsätter att logga resursanvändningen medan en klient begränsas.
Mer information om Begränsningar för Microsoft Graph finns i Microsoft Graph-dokumentationen.