Limites de serviço para Serviços de Comunicação do Azure
Este documento explica as limitações das APIs dos Serviços de Comunicação do Azure e possíveis resoluções.
Arquitetura e padrões de limitação
Quando você atinge limitações de serviço, recebe um código de status HTTP 429 (Excesso de solicitações). Em geral, as seguintes são as práticas recomendadas para lidar com a limitação:
- Reduza o número de operações por solicitação.
- Reduzir a frequência de chamadas.
- Evitar novas repetições imediatas, pois todas as solicitações se acumulam em relação aos seus limites de uso.
Você pode encontrar diretrizes mais gerais sobre como configurar sua arquitetura de serviço para lidar com limitações na documentação da Arquitetura do Azure para padrões de limitação. Esses limites podem ser aumentados por meio de uma solicitação para o Suporte do Azure.
- Abra o portal do Azure e entre em sua conta.
- Selecione Ajuda + Suporte.
- Clique em Criar solicitação de suporte.
- Na caixa de texto Descreva seu problema, insira
Technicale clique em Ir. - No menu suspenso Selecionar um serviço, escolha Limites de Serviço e Assinatura (Cotas) e clique em Avançar.
- Na descrição do problema, escolha o Tipo de problema, a Assinatura e Tipo de cota e clique em Avançar.
- Revise qualquer Solução recomendada se disponível e clique em Avançar.
- Inclua Detalhes adicionais conforme necessário e clique em Avançar.
- Em Revisar + criar, verifique as informações, faça alterações conforme necessário e clique em Criar.
Você pode seguir a documentação para criar uma solicitação para o Suporte do Azure.
Como adquirir números de telefone
Antes de adquirir um número de telefone, verifique se sua assinatura atende aos requisitos geográficos e de assinatura. Caso contrário, você não poderá comprar um número de telefone. As limitações abaixo se aplicam à compra de números por meio do SDK de Números de Telefone do portal do Azure.
| Operação | Escopo | Período de tempo | Limite (número total de solicitações) |
|---|---|---|---|
| Comprar número de telefone | Locatário do Azure | - | 1 |
| Pesquisar números de telefone | Locatário do Azure | uma semana | 5 |
Ação a ser tomada
Para obter mais informações, confira a página de conceito de tipos de números de telefone e a página de visão geral do conceito de telefonia.
Se você quiser comprar mais números de telefone ou realizar um pedido especial, siga as instruções aqui. Se você quiser fazer a portabilidade de números de telefone de ligação gratuita de contas externas para sua conta de Serviços de Comunicação do Azure, siga as instruções aqui.
Identidade
| Operação | Períodos (segundos) | Limite (número total de solicitações) |
|---|---|---|
| Criar a identidade | 30 | 1000 |
| Excluir identidade | 30 | 500 |
| Emitir token de acesso | 30 | 1000 |
| Revogar token de acesso | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
Ação a ser tomada
É recomendável adquirir identidades e tokens antes de criar threads de chat ou iniciar chamadas. Por exemplo, quando a página da Web é carregada ou o aplicativo é iniciado.
Para saber mais, confira a página visão geral do conceito de identidade.
SMS
Ao enviar ou receber um alto volume de mensagens, você poderá receber um erro 429. Esse erro indica que você está atingindo as limitações de serviço e suas mensagens serão colocadas na fila para serem enviadas quando o número de solicitações ficar abaixo do limite.
Limites de Taxa para SMS:
| Operação | Tipo de número | Escopo | Período (s) | Limite (nº de solicitações) | Unidades de mensagem por minuto |
|---|---|---|---|---|---|
| Enviar Mensagem | Chamada gratuita | Por número | 60 | 200 | 200 |
| Enviar Mensagem | Código curto | Por número | 60 | 6000 | 6000 |
| Enviar Mensagem | ID Alfanumérico do Remetente | Por recurso | 60 | 600 | 600 |
Ação a ser tomada
Se você tiver requisitos que excedam os limites de taxa, envie uma solicitação para o Suporte do Azure para habilitar uma taxa de transferência mais alta.
Para obter mais informações sobre o SDK de SMS e o serviço, confira a página visão geral do SDK de SMS ou a página de Perguntas frequentes sobre SMS.
Há um limite no número de mensagens de email que você pode enviar por um determinado período. Se você exceder os limites a seguir da sua assinatura, suas solicitações serão rejeitadas. Você pode tentar fazer essas solicitações novamente quando o tempo de Retry-After expirar. Você pode fazer uma solicitação para aumentar os limites de volume de envio, se necessário.
Limites de taxa
| Operação | Escopo | Período de tempo (minutos) | Limite (número de emails) |
|---|---|---|---|
| Enviar Email | Por assinatura | 1 | 30 |
| Enviar Email | Por assinatura | 60 | 100 |
| Obter o status de email | Por assinatura | 1 | 60 |
| Obter o status de email | Por assinatura | 60 | 200 |
| Operação | Escopo | Período de tempo (minutos) | Limite (número de emails) |
|---|---|---|---|
| Enviar Email | Por assinatura | 1 | 5 |
| Enviar Email | Por assinatura | 60 | 10 |
| Obter o status de email | Por assinatura | 1 | 10 |
| Obter o status de email | Por assinatura | 60 | 20 |
Limites de tamanho
| Nome | Limite |
|---|---|
| Número de destinatários no email | 50 |
| Tamanho total da solicitação de email (incluindo anexos) | 10 MB |
Ação a ser tomada
Essa configuração de área restrita é para ajudar os desenvolvedores a começar a criar o aplicativo. Depois de estabelecer uma reputação de remetente enviando emails, você pode solicitar o aumento dos limites de volume de envio. Envie uma solicitação de suporte para aumentar o limite de envio de email desejado se você precisar enviar um volume de mensagens que exceda os limites de taxa. As solicitações de aumento de cota de emails não são aprovadas automaticamente. A equipe de revisão considera sua reputação geral de remetente, que inclui fatores como as taxas de falha de entrega de email, a reputação do domínio, bem como os relatos de spam e abuso ao determinar o status de aprovação.
Observação
As solicitações de aumento de cota de email podem levar até 72 horas para serem avaliadas e aprovadas, especialmente para solicitações que chegam na sexta-feira à tarde.
Chat
Limites de tamanho
| Nome | Limite |
|---|---|
| Número de participantes no thread | 250 |
| Lote de participantes – CreateThread | 200 |
| Lote de participantes – AddParticipant | 200 |
| Tamanho da página - ListMessages | 200 |
| Tamanho da mensagem | 28 KB |
| Número de recursos dos Serviços de Comunicação do Azure por Bot do Azure | 1000 |
Limites de taxa
| Operação | Escopo | Limite por 10 segundos | Limite por minuto |
|---|---|---|---|
| Criar a conversa de chat | por Usuário | 10 | - |
| Gerenciar a conversa de chat | por Usuário | 10 | - |
| Atualizar a conversa de chat | por thread de chat | 5 | - |
| Adicionar participantes/remover participantes | por thread de chat | 10 | 30 |
| Obter threads de chat/Listar threads de chat | por Usuário | 50 | - |
| Receber mensagem de chat | por usuário por thread de chat | 50 | - |
| Receber mensagem de chat | por thread de chat | 250 | - |
| Listar mensagens de chat | por usuário por thread de chat | 50 | 200 |
| Listar mensagens de chat | por thread de chat | 250 | 400 |
| Obter recibos de leitura (limite de 20 participantes**) | por usuário por thread de chat | 5 | - |
| Obter recibos de leitura (limite de 20 participantes**) | por thread de chat | 100 | - |
| Obter participantes da conversa de chat | por usuário por thread de chat | 10 | - |
| Obter participantes da conversa de chat | por thread de chat | 250 | - |
| Enviar mensagem/atualizar mensagem/excluir mensagem | por thread de chat | 10 | 30 |
| Enviar confirmação de leitura | por usuário por thread de chat | 10 | 30 |
| Enviar indicador de digitação | por usuário por thread de chat | 5 | 15 |
| Enviar indicador de digitação | por thread de chat | 10 | 30 |
Observação
** Não há suporte para confirmações de leitura e indicadores de digitação em threads de chat com mais de 20 participantes.
Armazenamento de chat
Os Serviços de Comunicação do Azure armazenam mensagens de chat de acordo com a política de retenção que você definiu quando criou uma conversa de chat.
Importante
A funcionalidade descrita neste artigo está atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares de Versões Prévias do Microsoft Azure.
Você pode escolher entre a retenção de mensagens indefinidas ou a exclusão automática entre 30 e 90 dias por meio da política de retenção na API Criar Conversa de Chat. Como alternativa, você pode optar por não definir uma política de retenção em uma conversa de chat.
Se você tiver necessidades estritas de conformidade, recomendamos que você exclua as conversas de chat usando a API Excluir Conversa de Chat. Todas as conversas criadas antes da nova política de retenção não são afetadas, a menos que você altere especificamente a política dessa conversa.
Observação
Se você excluiu mensagens acidentalmente, elas não poderão ser recuperadas pelo sistema. Além disso, se você enviar uma solicitação de suporte para uma conversa de chat excluída depois que a política de retenção tiver excluído a conversa, ela não poderá mais ser recuperada e nenhuma informação sobre a conversa estará disponível. Se necessário, abra um tíquete de suporte o mais rápido possível no período de 30 dias depois de criar uma conversa para que possamos ajudar você.
Chamadas de voz e vídeo
Limitações de chamada PSTN
| Nome | Escopo | Limite |
|---|---|---|
| Número padrão de chamadas simultâneas de saída* | por Número | 2 |
*: sem limites nas chamadas simultâneas de entrada. Você também pode enviar uma solicitação ao Suporte do Azure para aumentar o limite de chamadas simultâneas de saída e ela será revisada por nossa equipe de avaliação.
Limitações máximas de chamada
| Nome | Limite |
|---|---|
| Número de participantes | 350 |
Suporte para streaming do SDK de Chamada
O SDK de Chamada dos Serviços de Comunicação dá suporte às seguintes configurações de streaming:
| Limite | Web | Windows/Android/iOS |
|---|---|---|
| Número máximo de fluxos locais de saída que você pode enviar simultaneamente | um vídeo ou um compartilhamento de tela | um vídeo + um compartilhamento de tela |
| Número máximo de fluxos remotos de entrada que você pode renderizar simultaneamente | Nove vídeos + um compartilhamento de tela | Nove vídeos + um compartilhamento de tela |
Embora o SDK de Chamada não exija esses limites, os usuários poderão enfrentar a degradação do desempenho se forem excedidos.
Tempos limite do SDK de Chamada
Os seguintes tempos limite se aplicam aos SDKs de Chamada dos Serviços de Comunicação:
| Ação | Tempo limite em segundos |
|---|---|
| Reconectar/remover participante | 120 |
| Adicionar ou remover nova modalidade de uma chamada (iniciar/parar o vídeo ou compartilhamento de tela) | 40 |
| Tempo limite da operação de Transferência de Chamada | 60 |
| Tempo limite de estabelecimento de chamada 1:1 | 85 |
| Tempo limite de estabelecimento de chamada de grupo | 85 |
| Tempo limite de estabelecimento de chamada PSTN | 115 |
| Tempo limite para promover chamada 1:1 a chamada de grupo | 115 |
Ação a ser tomada
Para obter mais informações sobre o SDK e o serviço de chamada de voz e vídeo, confira a página visão geral do SDK de chamada ou problemas conhecidos. Você também pode enviar uma solicitação ao Suporte do Azure para aumentar alguns dos limites e, em seguida, ela será revisada por nossa equipe de verificação.
Roteador de Trabalhos
Ao enviar ou receber um alto volume de solicitações, você poderá receber um erro ThrottleLimitExceededException. Esse erro indica que você está atingindo as limitações de serviço e suas solicitações serão descartadas até que o token do bucket para lidar com solicitações seja reabastecido após um determinado tempo.
Limites de taxa para o Roteador de Trabalhos:
| Operação | Escopo | Período (segundos) | Limite (número total de solicitações) | Tempo limite em segundos |
|---|---|---|---|---|
| Solicitações gerais | Por Recurso | 10 | 1000 | 10 |
Ação a ser tomada
Se você precisar enviar um volume de mensagens que excedam os limites de taxa, envie um email para nós em acs-ccap@microsoft.com.
interoperabilidade do Teams e do Microsoft Graph
Ao adotar um cenário de interoperabilidade do Teams, você provavelmente usará algumas APIs do Microsoft Graph para criar reuniões.
Cada serviço oferecido por meio do Microsoft Graph tem limitações diferentes; os limites específicos do serviço são descritos aqui em mais detalhes.
Ação a ser tomada
Quando você implementa o tratamento de erro, use o código de erro HTTP 429 para detectar a limitação. A resposta com falha inclui o cabeçalho de resposta de Retry-After. O recuo de solicitações usando o atraso Retry-After é a maneira mais rápida de se recuperar da limitação, pois o Microsoft Graph continua registrando o uso de recursos enquanto um cliente está sendo limitado.
Você pode encontrar mais informações sobre limites de limitação do Microsoft Graph na documentação do Microsoft Graph.
Próximas etapas
Confira as opções ajuda e suporte.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de