Ograniczenia usług dla Azure Communication Services
W tym artykule wyjaśniono ograniczenia interfejsów API usług Azure Communication Services i możliwe rozwiązania.
Wzorce ograniczania przepustowości i architektura
Po osiągnięciu ograniczeń usługi otrzymasz kod stanu HTTP 429 (zbyt wiele żądań). Ogólnie rzecz biorąc, następujące najlepsze rozwiązania są używane do ograniczania przepustowości:
- Zmniejsz liczbę operacji na żądanie.
- Zmniejsz częstotliwość wywołań.
- Unikaj natychmiastowych ponownych prób, ponieważ wszystkie żądania wliczają się do limitów użycia.
Więcej ogólnych wskazówek dotyczących konfigurowania architektury usługi w celu obsługi ograniczania przepustowości i ograniczeń można znaleźć w dokumentacji architektury platformy Azure na potrzeby wzorców ograniczania przepustowości. Aby zwiększyć limity ograniczania przepustowości, prześlij żądanie do pomocy technicznej platformy Azure.
- Otwórz witrynę Azure Portal i zaloguj się.
- Wybierz pozycję Pomoc i obsługa techniczna.
- Wybierz pozycję Utwórz nowy wniosek o pomoc techniczną.
- W polu tekstowym Opisz problem wprowadź wartość Technical (Techniczne), a następnie wybierz pozycję Przejdź.
- Z menu rozwijanego Wybierz usługę wybierz pozycję Limity usług i subskrypcji (limity przydziału), a następnie wybierz pozycję Dalej.
- W opisie problemu wybierz wartości Typ problemu, Subskrypcja i Typ limitu przydziału, a następnie wybierz pozycję Dalej.
- Przejrzyj dowolne zalecane rozwiązanie, jeśli jest dostępne, a następnie wybierz pozycję Dalej.
- Dodaj inne szczegóły zgodnie z potrzebami, a następnie wybierz pozycję Dalej.
- W obszarze Przeglądanie i tworzenie sprawdź informacje, wprowadź zmiany zgodnie z potrzebami, a następnie wybierz pozycję Utwórz.
Wykonaj kroki, aby wysłać żądanie do pomocy technicznej platformy Azure.
Uzyskiwanie numerów telefonów
Przed uzyskaniem numeru telefonu upewnij się, że subskrypcja spełnia wymagania geograficzne i subskrypcji . W przeciwnym razie nie można kupić numeru telefonu. Poniższe ograniczenia dotyczą numerów zakupów za pośrednictwem zestawu SDK numerów telefonów i witryny Azure Portal.
| Operacja | Scope | Horyzont czasowy | Limit (liczba żądań) |
|---|---|---|---|
| Zakup numeru telefonu | Dzierżawa platformy Azure | - | 1 |
| Wyszukiwanie numerów telefonów | Dzierżawa platformy Azure | Jeden tydzień | 5 |
Czynność do wykonania
Aby uzyskać więcej informacji, zobacz Typy numerów telefonów i Pojęcia dotyczące telefonii.
Aby zwiększyć liczbę limitów zakupów, prześlij żądanie do pomocy technicznej platformy Azure.
- Otwórz witrynę Azure Portal i zaloguj się.
- Wybierz pozycję Pomoc i obsługa techniczna.
- Wybierz pozycję Utwórz nowy wniosek o pomoc techniczną.
- W polu tekstowym Opisz problem wprowadź wartość Technical (Techniczne), a następnie wybierz pozycję Przejdź.
- Z menu rozwijanego Wybierz usługę wybierz pozycję Limity usług i subskrypcji (limity przydziału), a następnie wybierz pozycję Dalej.
- W opisie problemu wybierz wartości Typ problemu, Subskrypcja i Typ limitu przydziału, a następnie wybierz pozycję Dalej.
- Przejrzyj wszystkie zalecane rozwiązania, jeśli są dostępne, a następnie wybierz pozycję Dalej.
- Dodaj więcej szczegółów zgodnie z potrzebami, a następnie wybierz pozycję Dalej.
- W obszarze Przeglądanie i tworzenie sprawdź informacje, wprowadź zmiany zgodnie z potrzebami, a następnie wybierz pozycję Utwórz.
Tożsamość
| Operacja | Przedziały czasu (w sekundach) | Limit (liczba żądań) |
|---|---|---|
| Tworzenie tożsamości | 30 | 1000 |
| Usuwanie tożsamości | 30 | 500 |
| Problem z tokenem dostępu | 30 | 1000 |
| Odwoływanie tokenu dostępu | 30 | 500 |
createUserAndToken |
30 | 1000 |
exchangeTokens |
30 | 500 |
Czynność do wykonania
Zalecamy uzyskanie tożsamości i tokenów przed utworzeniem wątków czatu lub uruchamiania wywołań. Na przykład wykonaj to zadanie, gdy strona internetowa zostanie załadowana lub aplikacja zostanie uruchomiona.
Aby uzyskać więcej informacji, zobacz Uwierzytelnianie w usługach Azure Communication Services.
SMS
Podczas wysyłania lub odbierania dużej liczby komunikatów może zostać wyświetlony 429 błąd. Ten błąd wskazuje, że masz dostęp do ograniczeń usługi. Komunikaty są kolejkowane i wysyłane po przekroczeniu progu liczby żądań.
Limity szybkości dla wiadomości SMS:
| Operacja | Typ liczby | Scope | Przedziały czasu | Limit (numer żądania) | Jednostki komunikatów na minutę |
|---|---|---|---|---|---|
| Wyślij wiadomość | Numer bezpłatny | Na liczbę | 60 | 200 | 200 |
| Wyślij wiadomość | Krótki kod | Na liczbę | 60 | 6000 | 6000 |
| Wyślij wiadomość | Alfanumeryczny identyfikator nadawcy | Za zasób | 60 | 600 | 600 |
Czynność do wykonania
Jeśli masz wymagania, które przekraczają limity szybkości, prześlij żądanie do pomocy technicznej platformy Azure, aby włączyć większą przepływność.
Aby uzyskać więcej informacji na temat zestawu SMS SDK i usługi, zobacz Omówienie zestawu SMS SDK lub często zadawane pytania dotyczące wiadomości SMS.
Możesz wysłać ograniczoną liczbę wiadomości e-mail. Jeśli przekroczysz limity szybkości wiadomości e-mail dla subskrypcji, twoje żądania zostaną odrzucone. Te żądania można ponowić po upływie czasu ponawiania prób. Podejmij działania przed osiągnięciem limitu, żądając podniesienia limitów woluminu wysyłania w razie potrzeby.
Usługa poczty e-mail usług Azure Communication Services została zaprojektowana pod kątem obsługi wysokiej przepływności. Jednak usługa nakłada początkowe limity szybkości, aby ułatwić klientom bezproblemowe dołączanie i unikanie niektórych problemów, które mogą wystąpić podczas przełączania się do nowej usługi poczty e-mail.
Zalecamy stopniowe zwiększanie ilości wiadomości e-mail przy użyciu poczty e-mail usług Azure Communication Services w okresie od dwóch do czterech tygodni, przy jednoczesnym ścisłej monitorowania stanu dostarczania wiadomości e-mail. Ten stopniowy wzrost umożliwia dostawcom usług poczty e-mail innych firm dostosowanie się do zmiany adresu IP dla ruchu poczty e-mail w domenie. Stopniowa zmiana zapewnia czas na ochronę reputacji nadawcy i utrzymanie niezawodności dostarczania wiadomości e-mail.
Usługa poczty e-mail usług Azure Communication Services obsługuje maksymalnie 1–2 miliony wiadomości na godzinę. Wysoką przepływność można włączyć na podstawie kilku czynników, w tym:
- Szczytowy ruch klientów
- Potrzeby biznesowe
- Możliwość zarządzania współczynnikami niepowodzeń
- Reputacja domeny
Wymagania dotyczące szybkości awarii
Aby włączyć wysoki limit przydziału wiadomości e-mail, współczynnik niepowodzeń poczty e-mail musi być mniejszy niż jeden procent (1%). Jeśli współczynnik awarii jest wysoki, należy rozwiązać problemy przed zażądaniem zwiększenia limitu przydziału. Oczekuje się, że klienci będą aktywnie monitorować swoje stawki awarii.
Jeśli współczynnik awarii wzrośnie po wzroście limitu przydziału, usługi Azure Communication Services będą kontaktować się z klientem w celu natychmiastowego działania i osi czasu rozwiązania. W skrajnych przypadkach, jeśli szybkość awarii nie jest zarządzana na określonej osi czasu, usługi Azure Communication Services mogą zmniejszyć lub zawiesić usługę do momentu rozwiązania problemu.
Powiązane artykuły
Usługi Azure Communication Services udostępniają zaawansowane dzienniki i analizy, które ułatwiają monitorowanie współczynników błędów i zarządzanie nimi. Aby uzyskać więcej informacji, zobacz następujące artykuły:
- Zwiększanie reputacji nadawcy w wiadomości e-mail usług Azure Communication Services
- Szczegółowe informacje o wiadomościach e-mail
- Włączanie dzienników za pomocą ustawień diagnostycznych w usłudze Azure Monitor
- Szybki start: obsługa zdarzeń poczty e-mail
- Szybki start: zarządzanie listami pomijania domen w usługach Azure Communication Services przy użyciu bibliotek klienta zarządzania
Uwaga
Aby zażądać wyższych limitów, postępuj zgodnie z instrukcjami w temacie Zwiększanie limitu przydziału dla domen poczty e-mail. Wyższe limity przydziału są dostępne tylko dla zweryfikowanych domen niestandardowych, a nie domen zarządzanych przez platformę Azure.
Limity szybkości dla poczty e-mail
| Operacja | Scope | Przedział czasu (w minutach) | Limit (liczba wiadomości e-mail) | Dostępne wyższe limity |
|---|---|---|---|---|
| Wyślij wiadomość e-mail | Na subskrypcję | 1 | 30 | Tak |
| Wyślij wiadomość e-mail | Na subskrypcję | 60 | 100 | Tak |
| Uzyskiwanie stanu wiadomości e-mail | Na subskrypcję | 1 | 60 | Tak |
| Uzyskiwanie stanu wiadomości e-mail | Na subskrypcję | 60 | 200 | Tak |
W poniższej tabeli wymieniono limity domen zarządzanych platformy Azure.
| Operacja | Scope | Przedział czasu (w minutach) | Limit (liczba wiadomości e-mail) | Dostępne wyższe limity |
|---|---|---|---|---|
| Wyślij wiadomość e-mail | Na subskrypcję | 1 | 5 | Nie. |
| Wyślij wiadomość e-mail | Na subskrypcję | 60 | 10 | Nie. |
| Uzyskiwanie stanu wiadomości e-mail | Na subskrypcję | 1 | 10 | Nie. |
| Uzyskiwanie stanu wiadomości e-mail | Na subskrypcję | 60 | 20 | Nie. |
Limity rozmiaru wiadomości e-mail
| Nazwisko | Ograniczenie |
|---|---|
| Liczba adresatów w wiadomości e-mail | 50 |
| Łączny rozmiar żądania wiadomości e-mail (w tym załączniki) | 10 MB |
| Maksymalna liczba uwierzytelnionych połączeń na subskrypcję | 250 |
W przypadku wszystkich limitów rozmiaru komunikatów należy wziąć pod uwagę, że kodowanie Base64 zwiększa rozmiar komunikatu. Należy zwiększyć wartość rozmiaru, aby uwzględnić wzrost rozmiaru komunikatu, który występuje po załącznikach komunikatów i innych danych binarnych są zakodowane w formacie Base64. Kodowanie Base64 zwiększa rozmiar komunikatu o około 33%, więc rozmiar komunikatu jest około 33% większy niż rozmiar komunikatu przed kodowaniem. Jeśli na przykład określisz maksymalną wartość rozmiaru komunikatu wynoszącą około 10 MB, możesz oczekiwać realistycznego maksymalnego rozmiaru komunikatu wynoszącego około 7,5 MB.
Wysyłanie załączników większych niż 10 MB
Aby wysłać wiadomość e-mail z załącznikami do maksymalnie 30 MB, wyślij wniosek o pomoc techniczną.
Jeśli chcesz wysłać załączniki plików wiadomości e-mail o rozmiarze większym niż 30 MB, użyj tego alternatywnego rozwiązania. Zapisz pliki na koncie usługi Azure Blob Storage i dołącz link do plików w wiadomości e-mail. Pliki można zabezpieczyć przy użyciu sygnatury dostępu współdzielonego (SAS). Sygnatura dostępu współdzielonego zapewnia bezpieczny delegowany dostęp do zasobów na koncie magazynu. Korzystając z sygnatury dostępu współdzielonego, masz szczegółową kontrolę nad sposobem uzyskiwania dostępu do danych przez klientów.
Zalety korzystania z konta usługi Blob Storage:
- Można obsługiwać pliki na dużą skalę.
- Aby dokładnie zarządzać dostępem do plików, możesz użyć sygnatury dostępu współdzielonego lub kluczy.
Aby uzyskać więcej informacji, zobacz:
- Wprowadzenie do usługi Azure Blob Storage
- Udzielanie ograniczonego dostępu do zasobów usługi Azure Storage przy użyciu sygnatur dostępu współdzielonego
Czynność do wykonania
Aby zwiększyć limit przydziału wiadomości e-mail, postępuj zgodnie z instrukcjami w temacie Zwiększanie limitu przydziału dla domen poczty e-mail.
Uwaga
Żądania zwiększenia limitu przydziału wiadomości e-mail mogą potrwać do 72 godzin na potrzeby oceny i zatwierdzenia, zwłaszcza w przypadku żądań, które pojawiają się w piątek po południu.
Czat
Usługi Azure Communication Services obsługują czat.
Limity rozmiaru czatu
| Nazwisko | Ograniczenie |
|---|---|
| Liczba uczestników wątku | 250 |
Partia uczestników: CreateThread |
200 |
Partia uczestników: AddParticipant |
200 |
Rozmiar strony: ListMessages |
200 |
| Rozmiar komunikatu | 28 KB |
| Liczba zasobów usług Azure Communication Services na usługę Azure Bot Service | 1000 |
Limity szybkości czatu
| Operacja | Scope | Limit na 10 sekund | Limit na minutę |
|---|---|---|---|
| Tworzenie wątku czatu | Na użytkownika | 10 | - |
| Usuń wątek czatu | Na użytkownika | 10 | - |
| Aktualizowanie wątku czatu | Na wątek czatu | 5 | - |
| Dodawanie uczestników lub usuwanie uczestników | Na wątek czatu | 10 | 30 |
| Pobieranie wątków czatu lub wątków czatu | Na użytkownika | 50 | - |
| Uzyskiwanie wiadomości na czacie | Na użytkownika, na wątek czatu | 50 | - |
| Uzyskiwanie wiadomości na czacie | Na wątek czatu | 250 | - |
| Wyświetlanie listy wiadomości czatu | Na użytkownika, na wątek czatu | 50 | 200 |
| Wyświetlanie listy wiadomości czatu | Na wątek czatu | 250 | 400 |
| Pobieranie potwierdzeń odczytu (limit 20 uczestników) | Na użytkownika, na wątek czatu | 5 | - |
| Pobieranie potwierdzeń odczytu (limit 20 uczestników) | Na wątek czatu | 100 | - |
| Wyświetlanie listy uczestników wątku czatu | Na użytkownika, na wątek czatu | 10 | - |
| Wyświetlanie listy uczestników wątku czatu | Na wątek czatu | 250 | - |
| Wysyłanie wiadomości, aktualizowanie wiadomości lub usuwanie wiadomości | Na wątek czatu | 10 | 30 |
| Wysyłanie potwierdzenia odczytu | Na użytkownika, na wątek czatu | 10 | 30 |
| Wskaźnik wysyłania wpisywania | Na użytkownika, na wątek czatu | 5 | 15 |
| Wskaźnik wysyłania wpisywania | Na wątek czatu | 10 | 30 |
Uwaga
Potwierdzenia odczytu i wskaźniki wpisywania nie są obsługiwane w wątkach czatu z ponad 20 uczestnikami.
Magazyn czatów
Usługi Azure Communication Services przechowują wiadomości czatu zgodnie z zasadami przechowywania ustawionymi podczas tworzenia wątku czatu.
Ważne
Funkcje opisane w tym artykule są obecnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą być nieobsługiwane lub ograniczone. Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.
Możesz wybrać między nieokreślonym przechowywaniem wiadomości lub automatycznym usuwaniem z zakresu od 30 do 90 dni za pośrednictwem zasad przechowywania w interfejsie API tworzenia wątku czatu. Alternatywnie możesz nie ustawić zasad przechowywania w wątku czatu.
Jeśli masz ścisłe wymagania dotyczące zgodności, zalecamy usunięcie wątków czatu za pomocą interfejsu API usuwania wątku czatu. Nie ma to wpływu na wszystkie wątki utworzone przed nowymi zasadami przechowywania, chyba że w szczególności zmienisz zasady dla tego wątku.
Uwaga
Jeśli przypadkowo usuniesz komunikaty, system nie będzie mógł ich odzyskać. Jeśli prześlesz wniosek o pomoc techniczną dla usuniętego wątku czatu po usunięciu tego wątku przez zasady przechowywania, nie można go pobrać. Informacje o tym wątku nie są już dostępne. W razie potrzeby otwórz bilet pomocy technicznej tak szybko, jak to możliwe w oknie 30-dniowym po utworzeniu wątku, abyśmy mogli Ci pomóc.
Połączenia głosowe i wideo
Usługi Azure Communication Services obsługują połączenia głosowe i wideo.
Ograniczenia połączeń PSTN
| Nazwisko | Scope | Limit |
|---|---|---|
| Domyślna liczba połączeń współbieżnych wychodzących | Na liczbę | 2 |
Uwaga
Nie ma żadnych limitów dla przychodzących wywołań współbieżnych. Możesz również przesłać żądanie do pomocy technicznej platformy Azure, aby zwiększyć limit dla połączeń współbieżnych dla ruchu wychodzącego. Nasz zespół ds. weryfikacji sprawdza wszystkie żądania.
Ograniczenia maksymalne liczby wywołań
| Nazwisko | Ograniczenie |
|---|---|
| Liczba uczestników | 350 |
Obsługa przesyłania strumieniowego zestawu SDK wywołującego
Zestaw SDK wywołujący usługi Azure Communication Services obsługuje następujące konfiguracje przesyłania strumieniowego:
| Limit | Internet | Windows/Android/iOS |
|---|---|---|
| Maksymalna liczba wychodzących lokalnych strumieni, które można wysyłać jednocześnie. | Udostępnianie jednego filmu wideo lub jednego ekranu | Jedno wideo i jedno udostępnianie ekranu |
| Maksymalna liczba przychodzących strumieni zdalnych, które można renderować jednocześnie. | Dziewięć filmów wideo i jedno udostępnianie ekranu | Dziewięć filmów wideo i jedno udostępnianie ekranu |
Zestaw SDK wywołujący nie wymusza tych limitów, ale użytkownicy mogą doświadczyć obniżenia wydajności, jeśli te limity zostały przekroczone.
Przekroczenia limitu czasu zestawu SDK wywoływania
Następujące limity czasu dotyczą zestawów SDK wywołujących usługi Azure Communication Services:
| Akcja | Limit czasu w sekundach |
|---|---|
| Połącz ponownie lub usuń uczestnika. | 120 |
| Dodaj lub usuń nową modalność z wywołania. (Uruchom lub zatrzymaj udostępnianie wideo lub ekranu). | 40 |
| Przekroczenie limitu czasu operacji transferu wywołań. | 60 |
| Limit czasu połączenia 1:1. | 85 |
| Limit czasu połączenia grupowego. | 85 |
| Limit czasu połączenia PSTN dla zakładu. | 210 |
| Podwyższ poziom połączenia 1:1 do limitu czasu wywołania grupy. | 210 |
Czynność do wykonania
Aby uzyskać więcej informacji na temat zestawu SDK połączeń głosowych i wideo oraz usługi, zobacz Omówienie zestawu SDK wywoływania lub Znane problemy w zestawach SDK i interfejsach API. Możesz również przesłać żądanie do pomocy technicznej platformy Azure, aby zwiększyć niektóre limity. Nasz zespół ds. weryfikacji sprawdza wszystkie żądania.
Router zadania
Podczas wysyłania lub odbierania dużej liczby żądań może zostać wyświetlony ThrottleLimitExceededException błąd. Ten błąd wskazuje, że zbliżasz się do ograniczeń usługi. Żądania kończą się niepowodzeniem, dopóki zasobnik tokenu używany do obsługi żądań zostanie uzupełniony po upływie określonego czasu.
Limity szybkości dla routera zadań
| Operacja | Scope | Przedział czasu (w sekundach) | Limit (liczba żądań) | Limit czasu w sekundach |
|---|---|---|---|---|
| Żądania ogólne | Za zasób | 10 | 1 000 | 10 |
Czynność do wykonania
Jeśli musisz wysłać ilość wiadomości przekraczających limity szybkości, wyślij nam wiadomość e-mail na adres acs-ccap@microsoft.com.
Współdziałanie usługi Teams i program Microsoft Graph
Korzystając ze scenariusza współdziałania usługi Teams, prawdopodobnie używasz niektórych interfejsów API programu Microsoft Graph do tworzenia spotkań.
Każda usługa oferowana za pośrednictwem programu Microsoft Graph ma inne ograniczenia. Bardziej szczegółowo opisano limity specyficzne dla usługi na tej stronie internetowej .
Czynność do wykonania
Podczas wdrażania obsługi błędów użyj kodu błędu HTTP 429, aby wykryć ograniczenia przepustowości. Odpowiedź, która zakończyła się niepowodzeniem Retry-After , zawiera nagłówek odpowiedzi. Retry-After Użyj opóźnienia, aby wycofać żądania. Jest to najszybszy sposób odzyskiwania po ograniczaniu przepustowości, ponieważ program Microsoft Graph nadal rejestruje użycie zasobów, gdy klient jest ograniczany.
Więcej informacji na temat limitów ograniczania usługi Microsoft Graph można znaleźć w dokumentacji programu Microsoft Graph.