Den här webbläsaren stöds inte längre.
Uppgradera till Microsoft Edge och dra nytta av de senaste funktionerna och säkerhetsuppdateringarna, samt teknisk support.
I den här artikeln beskrivs begränsningarna för API:er för Azure Communication Services och möjliga lösningar.
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:
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.
Följ stegen för att göra en begäran till Azure Support.
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 |
Mer information finns i Telefonnummerstyper och Telefonibegrepp.
Om du vill öka antalet inköpsgränser skickar du en begäran till Azure-supporten.
| Å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 |
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.
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 |
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:
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.
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:
Anteckning
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.
| Å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 |
| 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.
| Name | Begränsning |
|---|---|
| SenderUsername/Mailfrom resurs per domän | 100 |
| Domäner som är länkade till en kommunikationstjänstresurs | 100 |
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:
Mer information finns i:
Om du vill öka din e-postkvot följer du anvisningarna i Kvotökning för e-postdomäner.
Anteckning
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.
Azure Communication Services stöder 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 |
| Å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 |
Anteckning
Läskvitton och skrivindikatorer stöds inte i chatttrådar med fler än 20 deltagare.
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.
Anteckning
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.
Azure Communication Services stöder röst- och videosamtal.
| Name | Omfattning | Gräns |
|---|---|---|
| Standardantal för utgående samtidiga anrop | Per nummer | 2 |
Anteckning
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.
| Name | Begränsning |
|---|---|
| Antal deltagare | 350 |
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.
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 |
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.
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.
| Åtgärd | Omfattning | Tidsram (sekunder) | Gräns (antal begäranden) | Timeout i sekunder |
|---|---|---|---|---|
| Allmänna begäranden | Per resurs | 10 | 1 000 | 10 |
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.
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 .
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.
Utbildning
Utbildningsväg
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Certifiering
Microsoft 365-certifierad: Samarbets- och kommunikationssystemingenjör Associate - Certifications
Visa färdigheter för att konfigurera, distribuera, övervaka och hantera Microsoft Teams Phone, möten och certifierade enheter.