Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье описываются ограничения Azure Communication Services API и возможные разрешения.
Шаблоны дросселирования и архитектура
При достижении ограничений службы вы получите код состояния HTTP 429 (слишком много запросов). Как правило, следуйте приведенным ниже рекомендациям по регулированию:
- Сократите число операций на запрос.
- Уменьшите частоту вызовов.
- Избегайте немедленных повторных попыток, поскольку все запросы засчитываются в ваши ограничения на использование.
Найдите общие рекомендации по настройке архитектуры службы для обработки контроля нагрузки и ограничений в документации
- Откройте портал Azure и войдите.
- Выберите "Справка и поддержка".
- Выберите "Создать запрос на поддержку".
- В текстовом поле "Описание проблемы " введите Technical и нажмите кнопку Go.
- В раскрывающемся меню "Выбор службы" выберите "Ограничения службы" и "Ограничения подписки" (квоты) и нажмите кнопку "Далее".
- В описании проблемы выберите тип проблемы, подписку и тип квоты , а затем нажмите кнопку "Далее".
- Просмотрите любое рекомендуемое решение, если оно доступно, и нажмите кнопку "Далее".
- Добавьте другие сведения по мере необходимости и нажмите кнопку "Далее".
- При просмотре и создании проверьте сведения, внесите изменения по мере необходимости и нажмите кнопку "Создать".
Выполните действия, чтобы создать запрос в поддержку Azure.
Получение номеров телефонов
Прежде чем приобрести номер телефона, убедитесь, что подписка соответствует географическим требованиям и требованиям подписки. В противном случае вы не можете приобрести номер телефона. Следующие ограничения применяются при покупке номеров через Phone numbers SDK и портал Azure.
| Операция | Область | Интервал времени | Ограничение (количество запросов) |
|---|---|---|---|
| Покупка номера телефона | клиент Azure | - | 1 |
| Поиск номеров телефонов | клиент Azure | Одна неделя | 5 |
Предстоящее действие
Дополнительные сведения см. в разделе "Типы номеров телефонов " и концепции телефонии.
Чтобы увеличить ограничения на покупку номеров, сделайте запрос в службу поддержки Azure.
- Откройте портал Azure и войдите.
- Выберите "Справка и поддержка".
- Выберите "Создать запрос на поддержку".
- В текстовом поле "Описание проблемы " введите Technical и нажмите кнопку Go.
- В раскрывающемся меню "Выбор службы" выберите "Ограничения службы" и "Ограничения подписки" (квоты) и нажмите кнопку "Далее".
- В описании проблемы выберите тип проблемы, подписку и тип квоты , а затем нажмите кнопку "Далее".
- Просмотрите все рекомендуемые решения, если они доступны, а затем нажмите кнопку "Далее".
- Добавьте дополнительные сведения по мере необходимости и нажмите кнопку "Далее".
- На экране Обзор и создание проверьте информацию, при необходимости внесите изменения, а затем выберите Создать.
Идентификация
| Операция | Временные отрезки (секунды) | Ограничение (количество запросов) |
|---|---|---|
| Создать личность | 30 | 1 000 |
| Удалить личность | 30 | 500 |
| Выдать токен доступа | 30 | 1 000 |
| Аннулировать токен доступа | 30 | 500 |
createUserAndToken |
30 | 1 000 |
exchangeTokens |
30 | 500 |
Предстоящее действие
Перед созданием потоков чата или запуском вызовов рекомендуется сначала получить идентификаторы и токены. Например, выполните эту задачу при загрузке веб-страницы или запуске приложения.
Дополнительную информацию см. в разделе Аутентификация в Azure Communication Services.
СМС
При отправке или получении большого объема сообщений может возникнуть 429 ошибка. Эта ошибка означает, что вы находитесь на грани достижения ограничений сервиса. Ваши сообщения попадают в очередь и отправляются, когда количество запросов становится ниже порогового значения.
Ограничения скорости для SMS:
| Операция | Тип номера | Область | Временные интервалы | Ограничение (номер запроса) | Единицы сообщений в минуту |
|---|---|---|---|---|---|
| Отправить сообщение | Бесплатный телефон | На каждый номер | шестьдесят | 200 | 200 |
| Отправить сообщение | Короткий код | На каждый номер | шестьдесят | 6 000 | 6 000 |
| Отправить сообщение | Идентификатор буквенно-цифрового отправителя | На ресурс | шестьдесят | 600 | 600 |
Предстоящее действие
Если у вас есть требования, превышающие ограничения скорости, отправьте запрос на Azure поддержка, чтобы обеспечить более высокую пропускную способность.
Дополнительные сведения о пакете SDK и службе SMS см. в разделе "Общие сведения о пакете SDK ДЛЯ SMS " или " ВОПРОСЫ и ответы по SMS".
Эл. почта
Вы можете отправлять ограниченное количество сообщений электронной почты. Если вы превышаете ограничения скорости электронной почты для подписки, ваши запросы отклоняются. Вы можете повторить попытку этих запросов после того, как пройдет время ожидания, указанное в Retry-After. При необходимости предпримите меры до достижения предела, запросив повышение лимитов на объём отправки.
Служба электронной почты Azure Communication Services предназначена для поддержки высокой пропускной способности. Однако служба накладывает начальные ограничения скорости, чтобы помочь клиентам плавно подключиться и избежать некоторых проблем, которые могут возникнуть при переключении на новую службу электронной почты.
Мы рекомендуем постепенно увеличивать объем электронной почты с помощью Azure Communication Services Email в течение двух–четырех недель, внимательно отслеживая состояние доставки сообщений электронной почты. Это постепенное увеличение позволяет сторонним поставщикам услуг электронной почты адаптироваться к изменению IP-адреса для трафика электронной почты вашего домена. Постепенное изменение позволяет защитить репутацию отправителя и обеспечить надежность доставки электронной почты.
Azure Communication Services служба электронной почты поддерживает большой объем до 1–2 миллионов сообщений в час. Высокая пропускная способность может быть включена на основе нескольких факторов, в том числе:
- Пиковый трафик клиента
- Бизнес-потребности
- Возможность управления частотами сбоев
- Репутация домена
Требования к частоте сбоев
Чтобы включить высокую квоту электронной почты, скорость сбоя электронной почты должна быть меньше одного процента (1%). Если скорость сбоя высока, перед запросом увеличения квоты необходимо устранить проблемы. Ожидается, что клиенты активно отслеживают частоту сбоев.
Если уровень отказов увеличивается после увеличения квоты, Azure Communication Services свяжутся с клиентом для принятия немедленных мер и сроками разрешения. В крайних случаях, если частота сбоев не управляется в пределах указанной временной шкалы, Azure Communication Services может уменьшить или приостановить службу до устранения проблемы.
Связанные статьи
Azure Communication Services предоставляет расширенные журналы и аналитику, помогающие отслеживать частоту сбоев и управлять ими. Дополнительные сведения см. в следующих статьях:
- Улучшение репутации отправителя электронной почты в Azure Communication Services.
- Аналитика электронной почты.
- Включите журналы через параметры диагностики в Azure Monitor.
- Обработка событий электронной почты.
- Управление списками доменных подавлений в Azure Communication Services с помощью клиентских библиотек управления.
Примечание.
Чтобы запросить более высокие ограничения, следуйте инструкциям по увеличению квоты для доменов электронной почты. Более высокие квоты доступны только для проверенных пользовательских доменов, а не для управляемых Azure доменов.
Ограничения скорости для электронной почты
| Операция | Область | Временной интервал (минуты) | Ограничение (количество сообщений электронной почты) | Доступны более высокие ограничения |
|---|---|---|---|---|
| Отправить сообщение электронной почты | За подписку | 1 | 30 | Да |
| Отправить сообщение электронной почты | За подписку | шестьдесят | 100 | Да |
| Проверка статуса электронной почты | За подписку | 1 | шестьдесят | Да |
| Проверка статуса электронной почты | За подписку | шестьдесят | 200 | Да |
В следующей таблице перечислены ограничения для управляемых доменов Azure.
| Операция | Область | Временной интервал (минуты) | Ограничение (количество сообщений электронной почты) | Доступны более высокие ограничения |
|---|---|---|---|---|
| Отправить сообщение электронной почты | За подписку | 1 | 5 | Нет |
| Отправить сообщение электронной почты | За подписку | шестьдесят | 10 | Нет |
| Проверка статуса электронной почты | За подписку | 1 | 10 | Нет |
| Проверка статуса электронной почты | За подписку | шестьдесят | 20 | Нет |
Ограничения размера электронной почты
| Имя | Лимит |
|---|---|
| Количество получателей в электронной почте | 50 |
| Общий размер запроса электронной почты (включая вложения) | 10 МБ |
| Максимальное количество прошедших проверку подлинности подключений для каждой подписки | 250 |
Для всех ограничений размера сообщения следует учитывать, что кодировка Base64 увеличивает размер сообщения. Необходимо увеличить значение размера для учета увеличения размера сообщения, которое происходит после вложения сообщений и любых других двоичных данных в кодировке Base64. Кодировка Base64 увеличивает размер сообщения примерно на 33%, поэтому размер сообщения составляет около 33% больше размеров сообщения перед кодировкой. Например, если указать максимальное значение размера сообщения примерно в 10 МБ, можно ожидать реальное максимальное значение размера сообщения примерно в 7,5 МБ.
Ограничения ресурсов
| Имя | Лимит |
|---|---|
| Ресурс SenderUsername/Mailfrom для каждого домена | 100 |
| Домены, связанные с ресурсом службы коммуникации | 100 |
Отправка вложений размером более 10 МБ
Чтобы отправить вложения в файл электронной почты до 30 МБ, отправьте запрос в службу поддержки.
Если вам нужно отправить вложения в файл электронной почты размером более 30 МБ, используйте это альтернативное решение. Сохраните файлы в учетной записи Azure Blob Storage и добавьте ссылку на файлы в сообщении электронной почты. Файлы можно защитить с помощью общей подписи доступа (SAS). SAS предоставляет защищенный делегированный доступ к ресурсам в учетной записи хранения. С помощью SAS у вас есть детальный контроль над доступом клиентов к вашим данным.
Преимущества использования учетной записи Blob Storage:
- Вы можете обрабатывать крупномасштабные файлы.
- Для точного управления доступом к файлам можно использовать SAS или ключи.
Дополнительные сведения см. в разделе:
- Introduction to Azure Blob Storage
- Предоставьте ограниченный доступ к ресурсам Azure Storage с помощью подписей для совместного доступа
Отправка сообщения электронной почты более чем 50 получателям
Если вы хотите отправить сообщения электронной почты более чем 50 получателям, отправьте запрос в службу поддержки.
Предстоящее действие
Чтобы увеличить квоту электронной почты, следуйте инструкциям по увеличению квоты для доменов электронной почты.
Примечание.
Запросы на увеличение квоты электронной почты могут занять до 72 часов для оценки и утверждения, особенно для запросов, поступающих в пятницу днем.
Чат
Azure Communication Services поддерживает чат.
Ограничения размера чата
| Имя | Лимит |
|---|---|
| Количество участников в теме | 250 |
Группа участников: CreateThread |
200 |
Группа участников: AddParticipant |
200 |
Размер страницы: ListMessages |
200 |
| Размер сообщения | 28 КБ |
| Количество ресурсов Azure Communication Services на одну службу Azure Bot Service | 1 000 |
Ограничения скорости для чата
| Операция | Область | Ограничение в 10 секунд | Ограничение в минуту |
|---|---|---|---|
| Создание потока чата | На пользователя | 10 | - |
| Создание потока чата | На ресурс | - | 3000 |
| Удалить тему чата | На пользователя | 10 | - |
| Обновление потока чата | По теме чата | 5 | - |
| Добавление участников или удаление участников | По теме чата | 10 | 30 |
| Добавление участников | На ресурс | - | 3000 |
| Получить поток чата или список потоков чата | На пользователя | 50 | - |
| Получение сообщения чата | На каждого пользователя, на каждый чат | 50 | - |
| Получение сообщения чата | По теме чата | 250 | - |
| Список сообщений чата | На каждого пользователя, на каждый чат | 50 | 200 |
| Список сообщений чата | По теме чата | 250 | 400 |
| Получение квитанций для чтения (ограничение на 20 участников) | На каждого пользователя, на каждый чат | 5 | - |
| Получение квитанций для чтения (ограничение на 20 участников) | По теме чата | 100 | - |
| Список участников темы чата | На каждого пользователя, на каждый чат | 10 | - |
| Список участников темы чата | По теме чата | 250 | - |
| Отправка сообщения, обновление сообщения или удаление сообщения | По теме чата | 10 | 30 |
| Отправка уведомления о прочтении | На каждого пользователя, на каждый чат | 10 | 30 |
| Отправить индикатор ввода текста | На каждого пользователя, на каждый чат | 5 | 15 |
| Отправить индикатор ввода текста | По теме чата | 10 | 30 |
Примечание.
Уведомления о прочтении и индикаторы ввода не поддерживаются в потоках чата с более чем 20 участниками.
Хранилище чатов
Azure Communication Services хранит сообщения чата в соответствии с политикой хранения, заданной при создании потока чата.
Вы можете выбрать между неопределенным сроком хранения сообщений или автоматическим удалением в диапазоне от 30 до 90 дней с помощью политики хранения в API создания потоков чата. Кроме того, вы можете не задать политику хранения в потоке чата.
Если у вас есть строгие требования к соответствию, рекомендуется использовать API "Удалить потоки чата " для удаления потоков чата. Все потоки, созданные до новой политики хранения, не затрагиваются, если только вы не измените политику для этого потока.
Примечание.
При случайном удалении сообщений система не может восстановить их. Если вы отправляете запрос на поддержку для удаленного потока чата после удаления политики хранения этого потока, его невозможно получить. Сведения об этом потоке больше не доступны. При необходимости откройте заявку в службу поддержки как можно быстрее в течение 30-дневного периода после создания темы, чтобы мы могли помочь вам.
Голосовые и видеозвонки
Azure Communication Services поддерживает голосовые и видеозвонки.
Ограничения вызовов ОТС
| Имя | Область | Лимит |
|---|---|---|
| Число исходящих одновременных вызовов по умолчанию | На каждый номер | 2 |
Примечание.
Нет ограничений на входящий одновременный вызов. Вы также можете отправить запрос в службу поддержки
Ограничения на максимальное количество вызовов
| Имя | Лимит |
|---|---|
| Количество участников | 350 |
Поддержка потоковой передачи в SDK для вызовов
Пакет SDK для вызовов Azure Communication Services поддерживает следующие конфигурации потоковой передачи:
| Лимит | Интернет | Windows/Android/iOS |
|---|---|---|
| Максимальное количество исходящих локальных потоков, которые можно отправлять одновременно. | Одно видео или общий доступ к одному экрану | Одно видео + общий доступ к одному экрану |
| Максимальное количество входящих удаленных потоков, которые можно воспроизводить одновременно. | Девять видео + общий доступ к одному экрану | Девять видео + общий доступ к одному экрану |
SDK для вызовов не применяет эти ограничения, но пользователи могут столкнуться с ухудшением производительности, если вы превысите эти ограничения.
Таймауты вызовов SDK
Следующие тайм-ауты применяются к пакетам SDK для вызовов Azure Communication Services:
| Действие | Время ожидания в секундах |
|---|---|
| Повторное подключение или удаление участника. | 120 |
| Добавьте или удалите новую модальность из вызова. (Запуск или остановка обмена видео или экрана.) | 40 |
| Тайм-аут операции переадресации звонка. | шестьдесят |
| Время ожидания установки вызова 1:1. | 85 |
| Тайм-аут на установление группового вызова. | 85 |
| Время ожидания установления соединения ТфОП. | 115 |
| Повысить вызов 1:1 до группового вызова с установкой тайм-аута. | 115 |
Виртуальные комнаты
Политики регулирования обслуживания комнат определяются группированием запросов по идентификатору ресурса.
| API (Интерфейс программирования приложений) | Порог |
|---|---|
| Создание комнаты | 20 запросов/сек |
| Обновление комнаты | 20 запросов/сек |
| Удалить комнату | 20 запросов/сек |
| Получить комнату | 40 запросов/сек. |
| Список комнат | 10 запросов/секунда |
| Обновление участника | 20 запросов/сек |
| Список участников | 40 запросов/сек. |
Предстоящее действие
Дополнительные сведения о пакете SDK для голосовых и видеозвонков и службе см. в обзоре пакета SDK для вызовов или известных проблемах в пакетах SDK и API. Вы также можете отправить запрос в службу поддержки Azure, чтобы увеличить некоторые ограничения. Наша команда проверки проверяет все запросы.
Маршрутизатор заданий
При отправке или получении большого объема запросов может возникнуть ThrottleLimitExceededException ошибка. Эта ошибка означает, что вы достигаете ограничений сервиса. Ваши запросы будут отклонены, пока контейнер маркеров, используемый для обработки запросов, не будет пополнен спустя определенное время.
Ограничения скорости для Job Router
| Операция | Область | Интервал времени (секунды) | Ограничение (количество запросов) | Время ожидания в секундах |
|---|---|---|---|---|
| Общие запросы | На ресурс | 10 | 3,000 | 5 |
| Получение заданий (ограничение на уровне маршрута) | На ресурс | 10 | 332 | 5 |
| Получение статистики очередей (ограничение на уровне маршрута) | На ресурс | 10 | 166 | 5 |
| Получение позиции в очереди (регулирование на уровне маршрута) | На ресурс | 10 | 166 | 5 |
| Получение работников (ограничение на уровне маршрута) | На ресурс | 10 | 332 | 5 |
Предстоящее действие
Если вам нужно отправить объем сообщений, превышающих ограничения скорости, отправьте нам acs-ccap@microsoft.comсообщение по электронной почте.
Взаимодействие Teams и Microsoft Graph
Используя сценарий взаимодействия Teams, вы, скорее всего, используете некоторые Microsoft Graph API для создания meetings.
Каждая служба, предлагаемая через Microsoft Graph, имеет разные ограничения. Ограничения для конкретной службы подробно описаны на этой веб-странице .
Предстоящее действие
При реализации обработки ошибок используйте код ошибки HTTP 429, чтобы определить ограничение. В неудачном ответе содержится заголовок ответа Retry-After. Используйте задержку Retry-After для уменьшения частоты запросов. Это самый быстрый способ восстановиться после ограничения, так как Microsoft Graph продолжает регистрировать использование ресурсов во время ограничения клиента.
Дополнительные сведения об ограничениях Microsoft Graph throttling см. в документации Microsoft Graph.