Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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, postępuj zgodnie z poniższymi najlepszymi rozwiązaniami dotyczącymi 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, a następnie wybierz pozycję Przejdź.
- Z menu rozwijanego Wybierz usługę, wybierz Limity usług i subskrypcji (Kwoty), a następnie wybierz Dalej.
- W opisie problemu wybierz wartości: Typ zgłoszenia, Subskrypcja oraz Typ limitu przydziału, a następnie wybierz 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ą zakupu numerów za pośrednictwem SDK numerów telefonów i portalu Azure.
| Operacja | Scope | Horyzont czasowy | Limit (liczba żądań) |
|---|---|---|---|
| Zakup numeru telefonu | Dzierżawca platformy Azure | - | 1 |
| Wyszukiwanie numerów telefonów | Dzierżawca 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, a następnie wybierz pozycję Przejdź.
- Z menu rozwijanego Wybierz usługę, wybierz Limity usług i subskrypcji (Kwoty), a następnie wybierz Dalej.
- W opisie problemu wybierz wartości: Typ zgłoszenia, Subskrypcja oraz Typ limitu przydziału, a następnie wybierz 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 |
| Wydawanie tokenu 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 zbliżasz się do limitów usługi. Twoje komunikaty są kolejkowane i wysyłane, gdy liczba żądań spada poniżej progu.
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 | 6 000 | 6 000 |
| 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 określonego w Retry-After. 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 wolumenu wiadomości e-mail przy użyciu wiadomości e-mail Azure Communication Services w okresie od dwóch do czterech tygodni, jednocześnie uważnie monitorując stan 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 częstoś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 wskaźniki awaryjności.
Jeśli współczynnik awarii wzrośnie po zwiększeniu przydziału, Azure Communication Services skontaktują się z klientem w celu podjęcia natychmiastowych działań i ustalenia harmonogramu rozwiązania. W skrajnych przypadkach, jeśli wskaźnik awarii nie jest zarządzany w określonym czasie, 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.
- Zarządzanie wydarzeniami e-mail.
- Zarządzanie listami wykluczeń domen w usługach Azure Communication Services przy użyciu bibliotek klienckich zarządzania.
Uwaga
Aby zażądać wyższych limitów, postępuj zgodnie z instrukcjami w części Zwiększanie limitów przydziału dla domen 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 | Za subskrypcję | 1 | 30 | Tak |
| Wyślij wiadomość e-mail | Za subskrypcję | 60 | 100 | Tak |
| Uzyskiwanie stanu wiadomości e-mail | Za subskrypcję | 1 | 60 | Tak |
| Uzyskiwanie stanu wiadomości e-mail | Za 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 | Za subskrypcję | 1 | 5 | Nie. |
| Wyślij wiadomość e-mail | Za subskrypcję | 60 | 10 | Nie. |
| Uzyskiwanie stanu wiadomości e-mail | Za subskrypcję | 1 | 10 | Nie. |
| Uzyskiwanie stanu wiadomości e-mail | Za 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 wiadomości, który występuje po zakodowaniu załączników wiadomości i innych danych binarnych 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.
Limity zasobów
| Nazwisko | Ograniczenie |
|---|---|
| SenderUsername/Mailfrom zasób na domenę | 100 |
| Domeny połączone z zasobem usługi komunikacyjnej | 100 |
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). Udostępniona sygnatura dostępu zapewnia bezpieczny delegowany dostęp do zasobów na Twoim koncie magazynowym. Korzystając z sygnatury dostępu współdzielonego (SAS), masz szczegółową kontrolę nad sposobem, w jaki klienci mogą uzyskiwać dostęp do Twoich danych.
Zalety korzystania z konta usługi Blob Storage:
- Można obsługiwać pliki na dużą skalę.
- Możesz użyć sygnatury dostępu współdzielonego lub kluczy, aby precyzyjnie zarządzać dostępem do plików.
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
Wysyłanie wiadomości e-mail do ponad 50 adresatów
Jeśli chcesz wysłać wiadomości e-mail do ponad 50 adresatów, wyślij wniosek o pomoc techniczną. Jednak wysyłanie wiadomości e-mail za pośrednictwem protokołu SMTP do ponad 50 adresatów nie jest obsługiwane.
Czynność do wykonania
Aby zwiększyć limit wiadomości e-mail, postępuj zgodnie z instrukcjami w Zwiększenie limitu 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. Żądania zwiększenia limitu przydziału dla liczby adresatów w wiadomości e-mail SMTP nie są obecnie obsługiwane.
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 | - |
| Tworzenie wątku czatu | Za zasób | - | 3000 |
| Usuń wątek czatu | Na użytkownika | 10 | - |
| Aktualizowanie wątku czatu | W ramach wątku czatu | 5 | - |
| Dodawanie uczestników lub usuwanie uczestników | W ramach wątku czatu | 10 | 30 |
| Dodawanie uczestników | Za zasób | - | 3000 |
| Uzyskaj wątek czatu lub listę wątków czatu | Na użytkownika | 50 | - |
| Uzyskiwanie wiadomości na czacie | Na użytkownika, na każdy wątek czatu | 50 | - |
| Uzyskiwanie wiadomości na czacie | W ramach wątku czatu | 250 | - |
| Lista wiadomości czatu | Na użytkownika, na każdy wątek czatu | 50 | 200 |
| Lista wiadomości czatu | W ramach wątku czatu | 250 | 400 |
| Pobieranie potwierdzeń odczytu (limit 20 uczestników) | Na użytkownika, na każdy wątek czatu | 5 | - |
| Pobieranie potwierdzeń odczytu (limit 20 uczestników) | W ramach wątku czatu | 100 | - |
| Lista uczestników czatu | Na użytkownika, na każdy wątek czatu | 10 | - |
| Lista uczestników czatu | W ramach wątku czatu | 250 | - |
| Wysyłanie wiadomości, aktualizowanie wiadomości lub usuwanie wiadomości | W ramach wątku czatu | 10 | 30 |
| Wyślij potwierdzenie odczytu | Na użytkownika, na każdy wątek czatu | 10 | 30 |
| Wyślij wskaźnik pisania | Na użytkownika, na każdy wątek czatu | 5 | 15 |
| Wyślij wskaźnik pisania | W ramach wątku czatu | 10 | 30 |
Uwaga
Potwierdzenia odczytu i wskaźniki wprowadzania tekstu nie są obsługiwane w wątkach czatu dla więcej niż 20 uczestników.
Przechowywanie czatów
Usługi Azure Communication Services przechowują wiadomości czatu zgodnie z zasadami przechowywania ustawionymi podczas tworzenia wątku czatu.
Możesz wybrać między bezterminowym przechowywaniem wiadomości lub automatycznym usuwaniem w zakresie od 30 do 90 dni za pomocą 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 użycie interfejsu API do usuwania wątków czatu w celu usunięcia wątków 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 jak najszybciej w ciągu 30 dni od utworzenia 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 | Ograniczenie |
|---|---|---|
| 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.
Maksymalne ograniczenia dotyczące połączeń
| Nazwisko | Ograniczenie |
|---|---|
| Liczba uczestników | 350 |
Obsługa przesyłania strumieniowego SDK połączeniowego
Zestaw SDK do dzwonienia dla usługi Azure Communication Services obsługuje następujące konfiguracje przesyłania strumieniowego:
| Ograniczenie | sieć Web | Windows/Android/iOS |
|---|---|---|
| Maksymalna liczba lokalnych strumieni wychodzących, które można jednocześnie wysłać. | 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 |
SDK dla połączeń nie wymusza tych limitów, ale użytkownicy mogą doświadczyć obniżenia wydajności, jeśli te limity zostaną przekroczone.
Wywołania limitu czasu SDK
Następujące limity czasu dotyczą zestawów SDK wywołujących usługi Azure Communication Services:
| Akcja | Czas zakończenia w sekundach |
|---|---|
| Połącz ponownie lub usuń uczestnika. | 120 |
| Dodaj lub usuń nowy tryb z rozmowy. (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 na rozpoczęcie połączenia grupowego. | 85 |
| Przekroczenie limitu czasu ustanowienia połączenia PSTN. | 115 |
| Zmień połączenie 1:1 na połączenie grupowe przed upływem limitu czasu. | 115 |
Virtual Rooms
Zasady ograniczania usług pokojów są określane poprzez grupowanie żądań według identyfikatora zasobu.
| API | Próg |
|---|---|
| Utwórz pokój | 20 żądań/sekundę |
| Pokój aktualizacji | 20 żądań/sekundę |
| Usuń pokój | 20 żądań/sekundę |
| Pobierz pokój | 40 żądań/sek. |
| Lista pomieszczeń | 10 żądań/s |
| Aktualizowanie uczestnika | 20 żądań/sekundę |
| Lista uczestników | 40 żądań/sek. |
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 połączeń lub Znane problemy w interfejsach API i zestawach SDK. 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 zadań
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. Twoje żądania zakończą się niepowodzeniem, dopóki kubełek tokenów używany do obsługi żądań nie zostanie uzupełniony po upływie określonego czasu.
Limity szybkości dla modułu zadań
| Operacja | Scope | Przedział czasu (w sekundach) | Limit (liczba żądań) | Czas zakończenia w sekundach |
|---|---|---|---|---|
| Żądania ogólne | Za zasób | 10 | 3000 | 5 |
| Pobieranie zadań (ograniczanieRoute-Level) | Za zasób | 10 | 332 | 5 |
| Pobieranie statystyk kolejki (ograniczanie na poziomie trasy) | Za zasób | 10 | 166 | 5 |
| Uzyskiwanie pozycji w kolejce (ograniczanie przepustowości na poziomie trasy) | Za zasób | 10 | 166 | 5 |
| Pobieranie pracowników (ograniczanie Route-Level) | Za zasób | 10 | 332 | 5 |
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. Niepowodzeniem zakończyła się odpowiedź Retry-After, która zawiera nagłówek odpowiedzi.
Retry-After Użyj opóźnienia, aby wycofać żądania. Jest to najszybszy sposób na odzyskanie wydajności po ograniczeniu, ponieważ Microsoft Graph wciąż śledzi 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.