Omezení služeb pro Azure Communication Services
Tento dokument vysvětluje omezení rozhraní API služeb Azure Communication Services a možná řešení.
Vzory omezování a architektura
Když dosáhnete omezení služby, obdržíte stavový kód HTTP 429 (Příliš mnoho požadavků). Obecně platí, že následující osvědčené postupy pro zpracování omezování:
- Snižte počet operací na požadavek.
- Snižte frekvenci volání.
- Vyhněte se okamžitým opakovaným pokusům, protože všechny požadavky nabíhají proti limitům využití.
Obecnější pokyny k nastavení architektury služeb pro zpracování omezování a omezení najdete v dokumentaci k architektuře Azure pro vzorce omezování. Limity omezování je možné zvýšit prostřednictvím žádosti o podporu Azure.
- Přejděte na Azure Portal.
- Výběr možnosti Nápověda a podpora
- Klikněte na Vytvořit novou žádost o podporu.
- V popisu problému zvolte Typ problému jako Technický a přidejte podrobnosti.
Pokud chcete vytvořit žádost o podporu Azure, postupujte podle dokumentace.
Získání telefonních čísel
Před získáním telefonního čísla se ujistěte, že vaše předplatné splňuje požadavky na zeměpisné údaje a předplatné . Jinak si nemůžete koupit telefonní číslo. Následující omezení platí pro nákupní čísla prostřednictvím sady Telefon Numbers SDK a webu Azure Portal.
| Operace | Obor | Časové období | Limit (počet požadavků) |
|---|---|---|---|
| Koupit telefonní číslo | Tenant Azure | - | 0 |
| Hledání telefonních čísel | Tenant Azure | jeden týden | 5 |
Akce, která se má provést
Další informace najdete na stránce konceptů typů telefonních čísel a na stránce přehledu konceptů telefonie.
Pokud si chcete koupit další telefonní čísla nebo zadat speciální objednávku, postupujte podle pokynů zde. Pokud chcete přenést bezplatná telefonní čísla z externích účtů na jejich účet Azure Communication Services, postupujte podle zde uvedených pokynů.
Identita
| Operace | Časové rámce (sekundy) | Limit (počet požadavků) |
|---|---|---|
| Vytvoření identity | 30 | 1000 |
| Odstranění identity | 30 | 500 |
| Vystavení přístupového tokenu | 30 | 1000 |
| Odvolání přístupového tokenu | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
Akce, která se má provést
Před vytvořením vlákna chatu nebo spuštěním volání doporučujeme získat identity a tokeny. Například při načtení webové stránky nebo spuštění aplikace.
Další informace najdete na stránce přehledu konceptů identit.
SMS
Při odesílání nebo příjmu velkého objemu zpráv se může zobrazit 429 chyba. Tato chyba značí, že se blížíte omezením služby a vaše zprávy se zařadí do fronty, jakmile bude počet požadavků nižší než prahová hodnota.
Omezení rychlosti pro SMS:
| Operace | Typ čísla | Obor | Časový rámec (s) | Limit (požadavek #) | Jednotky zpráv za minutu |
|---|---|---|---|---|---|
| Odeslat zprávu | Toll-free | Na číslo | 60 | 200 | 200 |
| Odeslat zprávu | Krátký kód | Na číslo | 60 | 6000 | 6000 |
| Odeslat zprávu | ID alfanumerického odesílatele | Za prostředek | 60 | 600 | 600 |
Akce, která se má provést
Pokud máte požadavky, které překračují limity rychlosti, odešlete žádost podpoře Azure, aby se povolila vyšší propustnost.
Další informace o sadě SMS SDK a službě najdete na stránce přehledu sady SMS SDK nebo na stránce s nejčastějšími dotazy sms.
Počet e-mailových zpráv, které můžete odeslat, je omezený. Pokud překročíte následující limity vašeho předplatného, vaše žádosti budou odmítnuty. Tyto žádosti můžete po uplynutí doby opakování zkusit znovu. V případě potřeby proveďte nezbytnou akci a požádejte o zvýšení limitů odesílajícího svazku.
Omezení rychlosti
| Operace | Obor | Časový rámec (minuty) | Limit (počet e-mailů) |
|---|---|---|---|
| Poslat e-mail | Podle předplatného | 0 | 30 |
| Poslat e-mail | Podle předplatného | 60 | 100 |
| Získání stavu e-mailu | Podle předplatného | 1 | 60 |
| Získání stavu e-mailu | Podle předplatného | 60 | 200 |
| Operace | Obor | Časový rámec (minuty) | Limit (počet e-mailů) |
|---|---|---|---|
| Poslat e-mail | Podle předplatného | 1 | 5 |
| Poslat e-mail | Podle předplatného | 60 | 10 |
| Získání stavu e-mailu | Podle předplatného | 1 | 10 |
| Získání stavu e-mailu | Podle předplatného | 60 | 20 |
Omezení velikosti
| Název | Omezení |
|---|---|
| Počet příjemců v e-mailu | 50 |
| Celková velikost e-mailové žádosti (včetně příloh) | 10 MB |
Akce, která se má provést
Toto nastavení sandboxu pomáhá vývojářům začít vytvářet aplikaci. Jakmile vytvoříte reputaci odesílatele odesláním e-mailů, můžete požádat o zvýšení limitů odesílajícího svazku. Odešlete žádost o podporu, která zvýší požadovaný limit odesílání e-mailů, pokud požadujete odeslání objemu zpráv překračujících limity rychlosti. Žádosti o navýšení kvóty e-mailů se neschválily automaticky. Kontrolující tým bude při určování stavu schválení zvážit celkovou reputaci odesílatele, která zahrnuje faktory, jako jsou míra selhání doručování e-mailů, reputace vaší domény a zprávy o spamu a zneužití.
Poznámka:
Vyhodnocení a schválení žádostí o navýšení kvóty e-mailů může trvat až 72 hodin, zejména u žádostí, které přicházejí v pátek odpoledne.
Chat
Omezení velikosti
| Název | Omezení |
|---|---|
| Počet účastníků ve vlákně | 250 |
| Dávka účastníků – CreateThread | 200 |
| Dávka účastníků – AddParticipant | 200 |
| Velikost stránky – ListMessages | 200 |
| Velikost zpráv | 28 kB |
| Počet prostředků Azure Communication Services na robota Azure | 1000 |
Omezení rychlosti
| Operace | Scope | Limit za 10 sekund | Limit za minutu |
|---|---|---|---|
| Vytvoření vlákna chatu | na uživatele | 10 | - |
| Odstranění vlákna chatu | na uživatele | 10 | - |
| Aktualizace vlákna chatu | na vlákno chatu | 5 | - |
| Přidání účastníků / odebrání účastníků | na vlákno chatu | 10 | 30 |
| Získání vlákna chatu / Zobrazení seznamu vláken chatu | na uživatele | 50 | - |
| Získání zprávy chatu | na uživatele na vlákno chatu | 50 | - |
| Získání zprávy chatu | na vlákno chatu | 250 | - |
| Výpis zpráv chatu | na uživatele na vlákno chatu | 50 | 200 |
| Výpis zpráv chatu | na vlákno chatu | 250 | 400 |
| Získání potvrzení o přečtení (limit 20 účastníků**) | na uživatele na vlákno chatu | 5 | - |
| Získání potvrzení o přečtení (limit 20 účastníků**) | na vlákno chatu | 100 | - |
| Zobrazení seznamu účastníků vlákna chatu | na uživatele na vlákno chatu | 10 | - |
| Zobrazení seznamu účastníků vlákna chatu | na vlákno chatu | 250 | - |
| Odeslat zprávu / aktualizovat zprávu / odstranit zprávu | na vlákno chatu | 10 | 30 |
| Odeslat potvrzení o přečtení | na uživatele na vlákno chatu | 10 | 30 |
| Indikátor zadávání textu | na uživatele na vlákno chatu | 5 | 15 |
| Indikátor zadávání textu | na vlákno chatu | 10 | 30 |
Poznámka:
** Indikátory potvrzení o přečtení a psaní nejsou podporovány ve vláknech chatu s více než 20 účastníky.
Úložiště chatů
Služba Azure Communication Services ukládá zprávy chatu po neomezenou dobu, dokud je zákazník neodstraní.
Od CY24 Q1 si zákazníci musí vybrat mezi neomezenou dobou uchovávání zpráv nebo automatickým odstraněním po 90 dnech. Stávající zprávy zůstávají nedotčené, ale zákazníci můžou v případě potřeby zvolit 90denní dobu uchovávání.
Poznámka:
Systém nechtěně odstraněné zprávy neobnovuje.
Hlasové hovory a videohovory
Omezení volání do veřejné telefonní sítě
| Název | Scope | Limit |
|---|---|---|
| Výchozí počet odchozích souběžných volání | na číslo | 2 |
Maximální omezení volání
| Název | Omezení |
|---|---|
| Počet účastníků | 350 |
Podpora streamování sady SDK pro volání
Sada SDK pro volání komunikačních služeb podporuje následující konfigurace streamování:
| Limit | Web | Windows/Android/iOS |
|---|---|---|
| Maximální počet odchozích místních datových proudů, které můžete odeslat současně | jeden video nebo jeden sdílení obrazovky | jedno video + jeden sdílení obrazovky |
| Maximální počet příchozích vzdálených datových proudů, které můžete vykreslit současně | 9 videí + jeden sdílení obrazovky | 9 videí + jeden sdílení obrazovky |
I když volající sada SDK nebude vynucovat tato omezení, mohou uživatelé zaznamenat snížení výkonu, pokud dojde k jejich překročení.
Vypršení časových limitů sady SDK
Následující časové limity platí pro sady SDK pro volání komunikačních služeb:
| Akce | Časový limit v sekundách |
|---|---|
| Opětovné připojení nebo odebrání účastníka | 120 |
| Přidání nebo odebrání nových způsobů volání (spuštění/zastavení sdílení videa nebo obrazovky) | 40 |
| Vypršení časového limitu operace přenosu volání | 60 |
| 1:1 Vypršení časového limitu pro vytvoření hovoru | 85 |
| Časový limit pro vytvoření skupinového volání | 85 |
| Časový limit pro vytvoření volání do veřejné telefonní sítě | 115 |
| Zvýšení úrovně 1:1 volání na časový limit skupinového volání | 115 |
Akce, která se má provést
Další informace o sadě SDK pro hlasové volání a videohovory a službě najdete na stránce přehledu volací sady SDK nebo známých problémech.
Směrovač úloh
Při odesílání nebo příjmu velkého objemu požadavků se může zobrazit ThrottleLimitExceededException chyba. Tato chyba značí, že dochází k omezením služby, a vaše žádosti se zahodí, dokud se token kbelíku pro zpracování požadavků po určité době nedoplní.
Omezení rychlosti pro směrovač úloh:
| Operace | Obor | Časový rámec (sekundy) | Limit (počet požadavků) | Časový limit v sekundách |
|---|---|---|---|---|
| Obecné požadavky | Na prostředek | 10 | 1000 | 10 |
Akce, která se má provést
Pokud potřebujete odeslat objem zpráv, které překračují limity rychlosti, pošlete nám e-mail na acs-ccap@microsoft.comadresu .
Interoperabilita Teams a Microsoft Graph
Při použití scénáře interoperability Teams budete pravděpodobně k vytváření schůzek používat některá rozhraní Microsoft Graph API.
Každá služba nabízená prostřednictvím Microsoft Graphu má různá omezení; Omezení specifická pro služby jsou zde popsána podrobněji.
Akce, která se má provést
Při implementaci zpracování chyb k detekci omezování využijte kód chyby HTTP 429. Neúspěšná odpověď obsahuje hlavičku Retry-After odpovědi. Obnovení požadavků pomocí Retry-After zpoždění je nejrychlejší způsob, jak se zotavit z omezování, protože Microsoft Graph nadále protokoluje využití prostředků, zatímco dochází k omezování klienta.
Další informace o omezeních omezování Microsoft Graphu najdete v dokumentaci k Microsoft Graphu.
Procházení sítě
| Operace | Časové rámce (sekundy) | Limit (počet požadavků) |
|---|---|---|
| Problém s přihlašovacími údaji TURN | 5 | 30000 |
| Problém s konfigurací přenosu | 5 | 30000 |
Akce, která se má provést
Než začnete s dalšími transakcemi, jako je vytvoření připojení pro přenos, doporučujeme získat tokeny.
Další informace najdete na stránce přehledu konceptů procházení sítě.
Další kroky
Podívejte se na možnosti nápovědy a podpory .