Tjänstebegränsningar för Azure Communication Services
I den här artikeln beskrivs 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 används följande metodtips för 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.
Mer allmän vägledning om hur du konfigurerar din tjänstarkitektur för att hantera begränsningar och begränsningar i Dokumentationen för Azure-arkitektur för begränsningsmönster. Om du vill öka begränsningsgränserna skickar du en begäran till Azure Support.
- Öppna Azure Portal och logga in.
- Välj Hjälp+support.
- Välj Skapa ny supportbegäran.
- I textrutan Beskriv problemet anger du Teknisk och väljer sedan Gå.
- I listrutan Välj en tjänst väljer du Tjänst- och prenumerationsgränser (Kvoter) och väljer sedan Nästa.
- I problembeskrivningen väljer du värdena Problemtyp, Prenumeration och Kvottyp och väljer sedan Nästa.
- Granska en rekommenderad lösning, om den är tillgänglig, och välj sedan Nästa.
- Lägg till annan information efter behov och välj sedan Nästa.
- I Granska + skapa kontrollerar du informationen, gör ändringar efter behov och väljer sedan Skapa.
Följ stegen för att göra 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 i Telefonnummerstyper och Telefonibegrepp.
Om du vill öka antalet inköpsgränser skickar du en begäran till Azure-supporten.
- Öppna Azure Portal och logga in.
- Välj Hjälp+support.
- Välj Skapa ny supportbegäran.
- I textrutan Beskriv problemet anger du Teknisk och väljer sedan Gå.
- I listrutan Välj en tjänst väljer du Tjänst- och prenumerationsgränser (Kvoter) och väljer sedan Nästa.
- I problembeskrivningen väljer du värdena Problemtyp, Prenumeration och Kvottyp och väljer sedan Nästa.
- Granska eventuella rekommenderade lösningar, om de är tillgängliga, och välj sedan Nästa.
- Lägg till mer information efter behov och välj sedan Nästa.
- I Granska + skapa kontrollerar du informationen, gör ändringar efter behov och väljer sedan Skapa.
Identitet
| Åtgärd | Tidsramar (sekunder) | Gräns (antal begäranden) |
|---|---|---|
| Skapa identitet | 30 | 1 000 |
| Ta bort identitet | 30 | 500 |
| Problem med åtkomsttoken | 30 | 1 000 |
| Återkalla åtkomsttoken | 30 | 500 |
createUserAndToken |
30 | 1 000 |
exchangeTokens |
30 | 500 |
Åtgärd att vidta
Vi rekommenderar att du skaffar identiteter och token innan du skapar chatttrådar eller startar anrop. Gör till exempel den här uppgiften när webbsidan läses in eller programmet startar.
Mer information finns i Autentisera till Azure Communication Services.
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 är på väg att nå tjänstbegränsningarna. Dina meddelanden placeras i kö och skickas när antalet begäranden ligger under tröskelvärdet.
Hastighetsbegränsningar för SMS:
| Åtgärd | Nummertyp | Omfattning | Tidsramar | Gräns (begärandenummer) | 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 i ÖVERSIKT över SMS SDK eller 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) | Högre gränser är tillgängliga |
|---|---|---|---|---|
| Skicka e-post | Per prenumeration | 1 | 30 | Ja |
| Skicka e-post | Per prenumeration | 60 | 100 | Ja |
| Hämta e-poststatus | Per prenumeration | 1 | 60 | Ja |
| Hämta e-poststatus | Per prenumeration | 60 | 200 | Ja |
I följande tabell visas gränser för Azure-hanterade domäner.
| Åtgärd | Omfattning | Tidsram (minuter) | Gräns (antal e-postmeddelanden) | Högre gränser är tillgängliga |
|---|---|---|---|---|
| Skicka e-post | Per prenumeration | 1 | 5 | Nej |
| Skicka e-post | Per prenumeration | 60 | 10 | Nej |
| Hämta e-poststatus | Per prenumeration | 1 | 10 | Nej |
| Hämta e-poststatus | Per prenumeration | 60 | 20 | Nej |
Storleksgränser för e-post
| Name | 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 |
Överväg att Base64-kodning ökar storleken på meddelandet för alla storleksbegränsningar för meddelanden. 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å cirka 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 upp till 30 MB gör du en supportbegäran.
Om du behöver skicka e-postfilbilagor som är större än 30 MB använder du 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). En SAS ger säker delegerad åtkomst till resurser i ditt lagringskonto. Med hjälp av en SAS har du detaljerad kontroll över hur klienter kan komma åt dina data.
Fördelar med att använda ett Blob Storage-konto:
- Du kan hantera storskaliga filer.
- Du kan använda en SAS eller nycklar för att exakt hantera filåtkomst.
Mer information finns i:
- Introduktion till Azure Blob Storage
- Bevilja begränsad åtkomst till Azure Storage-resurser med hjälp av signaturer för delad åtkomst
Åtgärd att vidta
Om du vill öka din e-postkvot följer du anvisningarna i Kvotökning för e-postdomäner.
Kommentar
Begäranden om e-postkvotökning kan ta upp till 72 timmar för utvärdering och godkännande, särskilt för begäranden som kommer in på fredagseftermiddagen.
Chatt
Azure Communication Services stöder chatt.
Storleksgränser för chatt
| Name | Begränsning |
|---|---|
| Antal deltagare i tråden | 250 |
Grupp med deltagare: CreateThread |
200 |
Grupp med deltagare: AddParticipant |
200 |
Sidstorlek: ListMessages |
200 |
| Meddelandestorlek | 28 KB |
| Antal Azure Communication Services-resurser per Azure Bot Service | 1 000 |
Frekvensgränser för chatt
| Åtgärd | Omfattning | 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 eller ta bort deltagare | Per chatttråd | 10 | 30 |
| Hämta chatttrådar eller listchatttrå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 (gräns på 20 deltagare) | Per användare, per chatttråd | 5 | - |
| Hämta läskvitton (gräns på 20 deltagare) | 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 eller 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 använder API:et Ta bort chatttråd för att ta bort chatttrådar. 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 tar bort meddelanden av misstag kan systemet inte återställa dem. Om du skickar en supportbegäran för en borttagen chatttråd när kvarhållningsprincipen har tagit bort den tråden kan den inte hämtas. Information om tråden är inte längre 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
Azure Communication Services stöder röst- och videosamtal.
Begränsningar för PSTN-anrop
| Name | Omfattning | Gräns |
|---|---|---|
| Standardantal för utgående samtidiga anrop | Per nummer | 2 |
Kommentar
Det finns 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. Vårt granskningsteam granskar alla förfrågningar.
Samtalsbegränsningar
| Name | Begränsning |
|---|---|
| Antal deltagare | 350 |
Stöd för att anropa SDK-strömning
Azure 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:erna för Azure Communication Services-samtal:
| Åtgärd | Timeout i sekunder |
|---|---|
| Återansluta eller ta bort en deltagare. | 120 |
| Lägg till eller ta bort ny modalitet från ett anrop. (Starta eller stoppa video- eller skärmdelning.) | 40 |
| Tidsgräns för samtalsöverföringsåtgärd. | 60 |
| En timeout för 1:1-samtalsetablissemanget. | 85 |
| Tidsgräns för gruppsamtalsetablering. | 85 |
| Tidsgräns för PSTN-samtalsetablering. | 115 |
| Höj upp ett 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 i Översikt över anropande SDK eller Kända problem i SDK:er och API:er. Du kan också skicka en begäran till Azure Support om att öka vissa av gränserna. Vårt granskningsteam granskar alla förfrågningar.
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. Dina begäranden misslyckas tills token-bucketen som används 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 | 1 000 | 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-samverkan 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 mer detaljerat på den här webbsidan .
Å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 . Använd fördröjningen Retry-After för att säkerhetskopiera begäranden. Det är det snabbaste sättet att återställa från begränsning eftersom Microsoft Graph fortsätter att logga resursanvändning medan en klient begränsas.
Mer information om Begränsningar för Microsoft Graph finns i Microsoft Graph-dokumentationen.