Omezení služeb pro Azure Communication Services
Tento článek 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 pro omezování se používají následující osvědčené postupy:
- 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 se započítávají do limitů použití.
Další obecné pokyny k nastavení architektury služby pro zvládnutí omezování a omezení najdete v dokumentaci k architektuře Azure pro vzory omezování. Pokud chcete zvýšit limity omezování, požádejte o podporu Azure.
- Otevřete Azure Portal a přihlaste se.
- Vyberte Nápověda a podpora.
- Vyberte Vytvořit novou žádost o podporu.
- Do textového pole Popište problém zadejte Technické a pak vyberte Přejít.
- V rozevírací nabídce Vybrat službu vyberte Limity služeb a předplatných (kvóty) a pak vyberte Další.
- V popisu problému zvolte hodnoty Typ problému, Předplatné a Typ kvóty a pak vyberte Další.
- Zkontrolujte všechna doporučená řešení, pokud je k dispozici, a pak vyberte Další.
- Podle potřeby přidejte další podrobnosti a pak vyberte Další.
- V části Zkontrolovat a vytvořit zkontrolujte informace, podle potřeby proveďte změny a pak vyberte Vytvořit.
Pokud chcete požádat o podporu Azure, postupujte podle pokynů.
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 SDK telefonních čísel a webu Azure Portal.
| Operace | Obor | Časový rámec | 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 naleznete v tématu Typy telefonních čísel a koncepty telefonie.
Pokud chcete zvýšit počet limitů nákupu, požádejte o podporu Azure.
- Otevřete Azure Portal a přihlaste se.
- Vyberte Nápověda a podpora.
- Vyberte Vytvořit novou žádost o podporu.
- Do textového pole Popište problém zadejte Technické a pak vyberte Přejít.
- V rozevírací nabídce Vybrat službu vyberte Limity služeb a předplatných (kvóty) a pak vyberte Další.
- V popisu problému zvolte hodnoty Typ problému, Předplatné a Typ kvóty a pak vyberte Další.
- Zkontrolujte všechna doporučená řešení, pokud jsou k dispozici, a pak vyberte Další.
- Podle potřeby přidejte další podrobnosti a pak vyberte Další.
- V části Zkontrolovat a vytvořit zkontrolujte informace, proveďte podle potřeby změny a pak vyberte Vytvořit.
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 zahájením volání doporučujeme získat identity a tokeny. Například tuto úlohu proveďte při načtení webové stránky nebo spuštění aplikace.
Další informace najdete v tématu Ověřování ve službě Azure Communication Services.
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 chystáte dosáhnout omezení služby. Vaše zprávy se zařadí do fronty a odešlou se po překročení prahové hodnoty počtu požadavků.
Omezení rychlosti pro SMS:
| Operace | Typ čísla | Obor | Časové rámce | Limit (číslo požadavku) | Jednotky zpráv za minutu |
|---|---|---|---|---|---|
| Odeslat zprávu | Bezplatná linka | 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 v přehledu sady SMS SDK nebo nejčastějších dotazech k SMS.
Můžete odeslat omezený počet e-mailových zpráv. Pokud překročíte limity četnosti e-mailů pro vaše předplatné, vaše žádosti se zamítnou. Tyto žádosti můžete po uplynutí doby opakování zkusit znovu. Než dosáhnete limitu, proveďte akci tím, že v případě potřeby požádáte o zvýšení limitů odesílajícího svazku.
E-mailová služba Azure Communication Services je navržená tak, aby podporovala vysokou propustnost. Služba však ukládá počáteční limity rychlosti, které zákazníkům pomůžou bezproblémově připojit a vyhnout se některým problémům, ke kterým může dojít při přechodu na novou e-mailovou službu.
Doporučujeme postupně zvýšit objem e-mailů pomocí e-mailu služby Azure Communication Services během dvou až čtyř týdnů a současně pečlivě monitorovat stav doručení vašich e-mailů. Díky tomu se poskytovatelé e-mailových služeb třetích stran budou moct přizpůsobit změnám IP adres pro e-mailový provoz vaší domény. Postupná změna vám dává čas na ochranu reputace odesílatele a zachování spolehlivosti doručování e-mailů.
E-mailová služba Azure Communication Services podporuje velký objem až 1 až 2 miliony zpráv za hodinu. Vysokou propustnost je možné povolit na základě několika faktorů, mezi které patří:
- Špička provozu zákazníka
- Obchodní potřeby
- Schopnost spravovat míry selhání
- Pověst domény
Požadavky na míru selhání
Pokud chcete povolit vysokou kvótu e-mailu, musí být míra selhání e-mailu menší než jedna procenta (1 %). Pokud je míra selhání vysoká, musíte problémy vyřešit před vyžádáním navýšení kvóty. Očekává se, že zákazníci aktivně monitorují své míry selhání.
Pokud se míra selhání po navýšení kvóty zvýší, služba Azure Communication Services kontaktuje zákazníka s okamžitou akcí a časovou osou řešení. V extrémních případech, pokud se míra selhání nespravuje v zadané časové ose, může služba Azure Communication Services snížit nebo pozastavit službu, dokud se problém nevyřeší.
Související články
Služba Azure Communication Services poskytuje bohaté protokoly a analýzy, které pomáhají monitorovat a spravovat míry selhání. Další informace najdete v následujících článcích:
- Zlepšení reputace odesílatele v e-mailu služby Azure Communication Services
- Přehledy e-mailů
- Povolení protokolů prostřednictvím nastavení diagnostiky ve službě Azure Monitor
- Rychlý start: Zpracování e-mailových událostí
- Rychlý start: Správa seznamů potlačení domény ve službě Azure Communication Services pomocí klientských knihoven pro správu
Poznámka:
Pokud chcete požádat o vyšší limity, postupujte podle pokynů při navýšení kvóty pro e-mailové domény. Vyšší kvóty jsou dostupné jenom pro ověřené vlastní domény, ne pro domény spravované v Azure.
Omezení rychlosti pro e-mail
| Operace | Obor | Časový rámec (minuty) | Limit (počet e-mailů) | K dispozici jsou vyšší limity |
|---|---|---|---|---|
| Poslat e-mail | Podle předplatného | 0 | 30 | Ano |
| Poslat e-mail | Podle předplatného | 60 | 100 | Ano |
| Získání stavu e-mailu | Podle předplatného | 1 | 60 | Ano |
| Získání stavu e-mailu | Podle předplatného | 60 | 200 | Ano |
Následující tabulka uvádí omezení pro spravované domény Azure.
| Operace | Obor | Časový rámec (minuty) | Limit (počet e-mailů) | K dispozici jsou vyšší limity |
|---|---|---|---|---|
| Poslat e-mail | Podle předplatného | 1 | 5 | No |
| Poslat e-mail | Podle předplatného | 60 | 10 | No |
| Získání stavu e-mailu | Podle předplatného | 1 | 10 | No |
| Získání stavu e-mailu | Podle předplatného | 60 | 20 | No |
Omezení velikosti pro e-mail
| Název | Omezení |
|---|---|
| Počet příjemců v e-mailu | 50 |
| Celková velikost e-mailové žádosti (včetně příloh) | 10 MB |
| Maximální počet ověřených připojení na předplatné | 250 |
U všech omezení velikosti zpráv zvažte, že kódování Base64 zvětší velikost zprávy. Je potřeba zvětšit hodnotu velikosti, aby se zohlednila zvětšení velikosti zprávy, ke které dochází po přílohách zprávy a všechny ostatní binární data jsou zakódovány Base64. Kódování Base64 zvětší velikost zprávy o přibližně 33 %, takže velikost zprávy je přibližně 33 % větší než velikost zprávy před kódováním. Pokud například zadáte hodnotu maximální velikosti zprávy o velikosti přibližně 10 MB, můžete očekávat realistickou maximální velikost zprávy o velikosti přibližně 7,5 MB.
Odesílání příloh větších než 10 MB
Pokud chcete poslat e-mailové soubory přílohy až do 30 MB, odešlete žádost o podporu.
Pokud potřebujete odeslat přílohy e-mailových souborů větší než 30 MB, použijte toto alternativní řešení. Uložte soubory do účtu služby Azure Blob Storage a vložte do e-mailu odkaz na soubory. Soubory můžete zabezpečit pomocí sdíleného přístupového podpisu (SAS). Sas poskytuje zabezpečený delegovaný přístup k prostředkům ve vašem účtu úložiště. Pomocí sdíleného přístupového podpisu máte podrobnou kontrolu nad tím, jak mají klienti přístup k vašim datům.
Výhody používání účtu Blob Storage:
- Můžete zpracovávat rozsáhlé soubory.
- K přesné správě přístupu k souborům můžete použít SAS nebo klíče.
Další informace naleznete v tématu:
- Seznámení se službou Azure Blob Storage
- Udělení omezeného přístupu k prostředkům Azure Storage pomocí sdílených přístupových podpisů
Akce, která se má provést
Pokud chcete zvýšit kvótu e-mailu, postupujte podle pokynů v navýšení kvóty pro e-mailové domény.
Poznámka:
Žádosti o navýšení kvóty e-mailů můžou trvat až 72 hodin na vyhodnocení a schválení, zejména u žádostí, které přicházejí v pátek odpoledne.
Chat
Azure Communication Services podporuje chat.
Omezení velikosti chatu
| 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ávy | 28 kB |
| Počet prostředků Azure Communication Services na službu Azure Bot Service | 1000 |
Omezení rychlosti chatu
| Operace | Obor | 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 | Vlákno chatu | 5 | - |
| Přidání účastníků nebo odebrání účastníků | Vlákno chatu | 10 | 30 |
| Získání vlákna chatu nebo 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 | Vlákno chatu | 250 | - |
| Výpis zpráv chatu | Na uživatele, na vlákno chatu | 50 | 200 |
| Výpis zpráv chatu | 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ů) | 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 | Vlákno chatu | 250 | - |
| Odeslání zprávy, aktualizace zprávy nebo odstranění zprávy | 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 | Vlákno chatu | 10 | 30 |
Poznámka:
Potvrzení o přečtení a indikátory 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 podle zásad uchovávání informací, které jste nastavili při vytváření vlákna chatu.
Důležité
Funkce popsané v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.
Prostřednictvím zásad uchovávání informací v rozhraní API pro vytvoření vlákna chatu si můžete vybrat mezi neomezenou dobou uchovávání zpráv nebo automatickým odstraněním mezi 30 a 90 dny. Případně se můžete rozhodnout, že zásady uchovávání informací nenastavíte ve vlákně chatu.
Pokud potřebujete striktní dodržování předpisů, doporučujeme k odstranění vláken chatu použít rozhraní API pro odstranění vlákna chatu. Všechna vlákna vytvořená před novou zásadou uchovávání informací nebudou ovlivněna, pokud zásady pro toto vlákno výslovně nezměníte.
Poznámka:
Pokud omylem odstraníte zprávy, systém je nemůže obnovit. Pokud odešlete žádost o podporu pro odstraněné vlákno chatu po odstranění této zásady uchovávání informací, nedá se načíst. Informace o tom, že vlákno již není k dispozici. V případě potřeby otevřete lístek podpory co nejrychleji v rámci 30denního okna po vytvoření vlákna, abychom vám mohli pomoct.
Hlasové hovory a videohovory
Azure Communication Services podporuje hlasové hovory a videohovory.
Omezení volání do veřejné telefonní sítě
| Název | Obor | Limit |
|---|---|---|
| Výchozí počet odchozích souběžných volání | Na číslo | 2 |
Poznámka:
U příchozích souběžných volání neexistují žádná omezení. Můžete také odeslat žádost podpoře Azure, která zvýší limit pro odchozí souběžná volání. Náš prověrkový tým zkontroluje všechny žádosti.
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í služeb Azure Communication Services 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ě. | Jedno 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ě. | Devět videí + jeden sdílení obrazovky | Devět videí + jeden sdílení obrazovky |
Volající sada SDK tyto limity nevynucuje, ale uživatelé můžou zaznamenat snížení výkonu, pokud tyto limity překročíte.
Vypršení časových limitů sady SDK
Následující časové limity platí pro sady SDK pro volání služeb Azure Communication Services:
| Akce | Časový limit v sekundách |
|---|---|
| Znovu se připojte nebo odeberte účastníka. | 120 |
| Přidání nebo odebrání nového způsobu volání (Spuštění nebo zastavení sdílení videa nebo obrazovky.) | 40 |
| Časový limit operace přenosu volání | 60 |
| Časový limit 1:1 volání. | 85 |
| Časový limit pro vytvoření skupinového hovoru | 85 |
| Časový limit pro vytvoření volání do veřejné telefonní sítě | 115 |
| Zvýšení úrovně časového limitu volání 1:1 na časový limit skupinového volání | 115 |
Akce, která se má provést
Další informace o sadě SDK a videohovorech a službě pro hlasové volání najdete v tématu Přehled sady SDK nebo Známé problémy v sadách SDK a rozhraních API. Můžete také odeslat žádost podpoře Azure o zvýšení některých limitů. Náš prověrkový tým zkontroluje všechny žádosti.
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 dosahujete omezení služby. Vaše požadavky selžou, dokud se kontejner tokenů, který se používá ke zpracování požadavků, po určité době doplňuje.
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 | Za prostředek | 10 | 1 000 | 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 pravděpodobně k vytváření schůzek použijete 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žbu jsou podrobněji popsána na této webové stránce .
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. Retry-After Zpoždění použijte k vrácení požadavků. Jedná se o nejrychlejší způsob, jak se zotavit z omezování, protože Microsoft Graph nadále protokoluje využití prostředků v době, kdy je klient omezený.
Další informace o limitech omezování Microsoft Graphu najdete v dokumentaci k Microsoft Graphu.