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
Technical
e 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 seguintes limitações se aplicam à compra de números por meio do Phone Numbers SDK e 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.
Os limites de compra de números podem ser aumentados por meio de uma solicitação ao 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
Technical
e 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.
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.
Você pode enviar um número limitado de mensagens de email. Se você exceder os seguintes limites para sua assinatura, suas solicitações serão rejeitadas. Você pode tentar essas solicitações novamente depois que o tempo de Repetir Após passar. Tome medidas antes de atingir o limite, solicitando o aumento dos 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 |
Para todos os limites de tamanho de mensagem, você precisa considerar que a codificação base64 aumenta o tamanho da mensagem. Você precisa aumentar o valor do tamanho para levar em conta o aumento do tamanho da mensagem que ocorre depois que os anexos da mensagem e quaisquer outros dados binários são codificados em Base64. A codificação Base64 aumenta o tamanho da mensagem em cerca de 33%, então o tamanho da mensagem é cerca de 33% maior que o tamanho da mensagem antes da codificação. Por exemplo, se você especificar um valor máximo de tamanho de mensagem de ~10 MB, poderá esperar um valor máximo realista de tamanho de mensagem de aproximadamente ~7,5 MB.
Enviar anexos maiores que 10 MB
Para enviar anexos de arquivo de até 30 MB por email, preencha uma solicitação de suporte.
Se você precisar enviar anexos de email maiores que 30 MB, você pode usar essa solução alternativa. Armazene os arquivos em uma conta do Armazenamento de Blobs do Azure e inclua um link para os arquivos no seu email. Você pode proteger os arquivos com uma Assinatura de Acesso Compartilhado (SAS). O SAS fornece acesso delegado seguro aos recursos em sua conta de armazenamento. Ao usar o SAS, você tem controle granular sobre como os clientes podem acessar seus dados.
Benefícios de usar uma conta do Armazenamento de Blobs do Azure:
- Você pode manipular arquivos de grande porte.
- Você pode usar chaves SAS para gerenciar com precisão o acesso aos arquivos.
Para saber mais, veja:
- Introdução ao Armazenamento de Blobs do Azure
- Conceder acesso limitado aos recursos de Armazenamento do Azure usando as SAS (assinaturas de acesso compartilhado)
Ação a ser tomada
Para aumentar sua cota de email, siga as instruções em Aumento de cota para domínios de email.
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 |
Receba confirmações de leitura (limite de 20 participantes*) | por usuário por thread de chat | 5 | - |
Receba confirmações 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
* Recibos de leitura e indicadores de digitação não são suportados em tópicos 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 |
Observação
* Não há limites para 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, que é revisado por nossa equipe de verificaçã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 |
O Calling SDK não impõe esses limites, mas seus usuários podem sofrer degradação de desempenho se você exceder esses limites.
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, aguardando análise da 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 do serviço e suas solicitações falharão até que o token do bucket para manipular 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.