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 dina användningsgränser.
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.
- Gå till Azure-portalen
- Välj Hjälp+support
- Klicka på Skapa ny supportbegäran
- I problembeskrivningen väljer du Problemtyp som Teknisk och lägger till informationen.
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. Begränsningarna nedan gäller för köpnummer via Telefon Numbers SDK och Azure-portalen.
| Å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 .
Om du vill köpa fler telefonnummer eller göra en specialbeställning följer du anvisningarna här. Om du vill portera avgiftsfria telefonnummer från externa konton till deras Azure Communication Services-konto följer du anvisningarna här.
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.
Det finns en gräns för hur många e-postmeddelanden du kan skicka. Om du överskrider nedanstående gränser för din prenumeration avvisas dina begäranden. Du kan försöka dessa begäranden igen efter att tiden för återförsök har passerat. Vidta nödvändiga åtgärder och begär att höja gränserna för sändningsvolymen om det behövs.
Hastighetsgränser
| Å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
| Namn | Begränsning |
|---|---|
| Antal mottagare i e-post | 50 |
| Total storlek på e-postbegäran (inklusive bifogade filer) | 10 MB |
Åtgärd att vidta
Den här sandbox-installationen hjälper utvecklare att börja skapa programmet. När du har upprättat ett avsändarrykte genom att skicka e-post kan du begära att öka gränserna för sändningsvolymen. Skicka en supportbegäran för att höja gränsen för e-postutskick om du behöver skicka en mängd meddelanden som överskrider hastighetsgränserna. Begäranden om e-postkvotökning godkänns inte automatiskt. Granskningsteamet kommer att överväga ditt övergripande avsändarrykte, vilket inkluderar faktorer som dina felfrekvenser för e-postleverans, ditt domänrykte och rapporter om skräppost och missbruk när du fastställer godkännandestatus.
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
| 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 |
Hastighetsgränser
| Å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 på obestämd tid tills de tas bort av kunden.
Från och med CY24 Q1 måste kunderna välja mellan obestämd kvarhållning av meddelanden eller automatisk borttagning efter 90 dagar. Befintliga meddelanden påverkas inte, men kunderna kan välja en kvarhållningsperiod på 90 dagar om så önskas.
Kommentar
Meddelanden som tagits bort av misstag kan inte återställas av systemet.
Röst- och videosamtal
Begränsningar för PSTN-samtal
| Namn | Definitionsområde | Gräns |
|---|---|---|
| Standardantal för utgående samtidiga anrop | per nummer | 2 |
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 | 9 videor + en skärmdelning | 9 videor + en skärmdelning |
Även om anropande SDK inte tillämpar dessa gränser kan användarna uppleva prestandaförsämring om de överskrids.
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.
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 att dina begäranden kommer att tas bort tills buckettoken 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 förmodligen vissa 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.