Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Este artigo explica as limitações das APIs do Azure Communication Services e as possíveis resoluções.
Padrões e arquitetura de limitação
Quando você atinge as limitações de serviço, você recebe um código de status HTTP 429 (muitas solicitações). Em geral, siga estas práticas recomendadas para limitação:
- Reduza o número de operações por solicitação.
- Reduza a frequência de chamadas.
- Evite novas tentativas imediatas porque todos os pedidos se acumulam em relação aos limites de utilização.
Encontre orientações mais gerais sobre como configurar a sua arquitetura de serviço para lidar com throttling e limitações na documentação da arquitetura Azure para padrões de throttling. Para aumentar os limites de limitação, faça um pedido ao Azure Suporte.
- Abra o portal Azure e inicie sessão.
- Selecione Ajuda+Suporte.
- Selecione Criar nova solicitação de suporte.
- Na caixa de texto Descrever o problema, insira Técnico e depois selecione Ir.
- No menu suspenso Selecione um serviço , selecione Limites de Serviço e Assinatura (Cotas) e selecione Avançar.
- Na descrição do problema, escolha os valores Tipo de questão, Assinatura e Tipo de quota, e selecione Avançar.
- Reveja qualquer solução recomendada, se disponível, e, em seguida, selecione Seguinte.
- Adicione outros detalhes conforme necessário e selecione Avançar.
- Em Rever + criar, verifique as informações, faça alterações conforme necessário e, em seguida, selecione Criar.
Siga os passos para fazer um pedido ao Azure Suporte.
Adquira 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 aplicam-se à compra de números através do SDK Números de Telefone e do portal Azure.
| Operação | Âmbito | Período de tempo | Limite (número de pedidos) |
|---|---|---|---|
| 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 executar
Para obter mais informações, consulte Tipos de número de telefone e Conceitos de telefonia.
Para aumentar os limites de compras, faça um pedido ao Suporte do Azure.
- Abra o portal Azure e inicie sessão.
- Selecione Ajuda+Suporte.
- Selecione Criar nova solicitação de suporte.
- Na caixa de texto Descrever o problema, insira Técnico e depois selecione Ir.
- No menu suspenso Selecione um serviço , selecione Limites de Serviço e Assinatura (Cotas) e selecione Avançar.
- Na descrição do problema, escolha os valores Tipo de questão, Assinatura e Tipo de quota, e selecione Avançar.
- Reveja as soluções recomendadas, se disponíveis, e, em seguida, selecione Seguinte.
- Adicione mais detalhes conforme necessário e selecione Avançar.
- Em Rever + criar , verifique as informações, faça as alterações necessárias e, em seguida, selecione Criar.
Identidade
| Operação | Períodos de tempo (segundos) | Limite (número de pedidos) |
|---|---|---|
| Criar identidade | 30 | 1,000 |
| Excluir identidade | 30 | 500 |
| Emitir token de acesso | 30 | 1,000 |
| Revogar token de acesso | 30 | 500 |
createUserAndToken |
30 | 1,000 |
exchangeTokens |
30 | 500 |
Ação a executar
Recomendamos que você adquira identidades e tokens antes de criar threads de bate-papo ou iniciar chamadas. Por exemplo, execute essa tarefa quando a página da Web for carregada ou o aplicativo for iniciado.
Para mais informações, veja Autenticar a Azure Communication Services.
SMS
Quando você envia ou recebe um grande volume de mensagens, você pode receber um 429 erro. Esse erro indica que você está prestes a atingir as limitações de serviço. Suas mensagens são enfileiradas e enviadas depois que o número de solicitações estiver abaixo do limite.
Limites de taxa para SMS:
| Operação | Tipo de número | Âmbito | Prazos | Limite (número do pedido) | Unidades de mensagem por minuto |
|---|---|---|---|---|---|
| Enviar mensagem | Número Gratuito | Por número | 60 | 200 | 200 |
| Enviar mensagem | Código curto | Por número | 60 | 6.000 | 6.000 |
| Enviar mensagem | ID do remetente alfanumérico | Por recurso | 60 | 600 | 600 |
Ação a executar
Se tiver requisitos que excedam os limites de taxa, envie um pedido ao Azure Suporte para permitir um maior rendimento.
Para obter mais informações sobre o SDK e o serviço do SMS, consulte Visão geral do SMS SDK ou as Perguntas frequentes do SMS.
Você pode enviar um número limitado de mensagens de e-mail. Se exceder os limites da taxa de e-mail da sua subscrição, os seus pedidos serão rejeitados. Você pode tentar essas solicitações novamente, após o Tempo de Repetição passar. Tome medidas antes de atingir o limite, solicitando o aumento dos limites de volume de envio, se necessário.
O serviço de email Azure Communication Services foi concebido para suportar alta taxa de transferência. No entanto, o serviço impõe limites de taxa inicial para ajudar os clientes a integrar sem problemas e evitar alguns dos problemas que podem ocorrer ao mudar para um novo serviço de e-mail.
Recomendamos que aumente gradualmente o volume de emails usando o Azure Communication Services Email ao longo de duas a quatro semanas, monitorizando de perto o estado de entrega dos seus emails. Esse aumento gradual permite que provedores de serviços de e-mail terceirizados se adaptem à mudança de IP para o tráfego de e-mail do seu domínio. A mudança gradual dá-lhe tempo para proteger a reputação do remetente e manter a fiabilidade da entrega do seu e-mail.
O serviço de email Azure Communication Services suporta um elevado volume até 1-2 milhões de mensagens por hora. A alta taxa de transferência pode ser habilitada com base em vários fatores, incluindo:
- Pico de tráfego de clientes
- Necessidades do negócio
- Capacidade de gerenciar taxas de falha
- Reputação do domínio
Requisitos de taxa de falha
Para habilitar uma alta cota de e-mail, sua taxa de falha de e-mail deve ser inferior a um por cento (1%). Se a sua taxa de falhas for alta, você deve resolver os problemas antes de solicitar um aumento de cota. Espera-se que os clientes monitorem ativamente suas taxas de falha.
Se a taxa de falhas aumentar após o aumento da quota, a Azure Communication Services contactará o cliente para ação imediata e um prazo de resolução. Em casos extremos, se a taxa de falhas não for gerida dentro do prazo especificado, o Azure Communication Services pode reduzir ou suspender o serviço até que o problema seja resolvido.
Artigos relacionados
O Azure Communication Services fornece registos ricos e análises para ajudar a monitorizar e gerir as taxas de falhas. Para obter mais informações, consulte os seguintes artigos:
- Melhorar a reputação do remetente no Azure Communication Services email.
- Informações por e-mail.
- Ativar registos através das Definições de Diagnóstico em Azure Monitor.
- Manipular eventos de e-mail.
- Gerir listas de supressão de domínio em Azure Communication Services usando as bibliotecas de clientes de gestão.
Nota
Para solicitar limites mais altos, siga as instruções em Aumento de cota para domínios de e-mail. Quotas mais elevadas só estão disponíveis para domínios personalizados verificados, não para domínios geridos pelo Azure.
Limites de taxa para e-mail
| Operação | Âmbito | Prazo (minutos) | Limite (número de e-mails) | Limites mais elevados disponíveis |
|---|---|---|---|---|
| Enviar E-mail | Por Subscrição | 1 | 30 | Sim |
| Enviar E-mail | Por Subscrição | 60 | 100 | Sim |
| Obter estado de e-mail | Por Subscrição | 1 | 60 | Sim |
| Obter estado de e-mail | Por Subscrição | 60 | 200 | Sim |
A tabela seguinte lista limites para domínios geridos Azure.
| Operação | Âmbito | Prazo (minutos) | Limite (número de e-mails) | Limites mais elevados disponíveis |
|---|---|---|---|---|
| Enviar E-mail | Por Subscrição | 1 | 5 | Não |
| Enviar E-mail | Por Subscrição | 60 | 10 | Não |
| Obter estado de e-mail | Por Subscrição | 1 | 10 | Não |
| Obter estado de e-mail | Por Subscrição | 60 | 20 | Não |
Limites de tamanho para e-mail
| Nome | Limite |
|---|---|
| Número de destinatários no e-mail | 50 |
| Tamanho total do pedido de e-mail (incluindo anexos) | 10 MB |
| Máximo de conexões autenticadas por assinatura | 250 |
Para todos os limites de tamanho de mensagem, considere que a codificação Base64 aumenta o tamanho da mensagem. Você precisa aumentar o valor de tamanho para levar em conta o aumento de 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%, portanto, o tamanho da mensagem é cerca de 33% maior do que o tamanho da mensagem antes da codificação. Por exemplo, se você especificar um valor de tamanho máximo de mensagem de aproximadamente 10 MB, poderá esperar um valor de tamanho máximo de mensagem realista de aproximadamente 7,5 MB.
Limites de recursos
| Nome | Limite |
|---|---|
| Recurso SenderUsername/Mailfrom por domínio | 100 |
| Domínios vinculados a um recurso do Serviço de Comunicação | 100 |
Enviar anexos com mais de 10 MB
Para enviar anexos de ficheiros até 30 MB por e-mail, faça um pedido de suporte.
Se precisar de enviar anexos de ficheiros de e-mail com mais de 30 MB, utilize esta solução alternativa. Guarde os ficheiros numa conta Azure Blob Storage e inclua um link para os ficheiros no seu email. Você pode proteger os arquivos com uma assinatura de acesso compartilhado (SAS). Uma SAS fornece acesso delegado seguro aos recursos em sua conta de armazenamento. Usando uma SAS, você tem controle granular sobre como os clientes podem acessar seus dados.
Vantagens de usar uma conta Blob Storage:
- Você pode lidar com arquivos de grande escala.
- Você pode usar uma SAS ou chaves para gerenciar com precisão o acesso a arquivos.
Para obter mais informações, consulte:
- Introdução à Azure Blob Storage
- Conceda acesso limitado a recursos Azure Storage utilizando assinaturas de acesso partilhadas
Enviar e-mail para mais de 50 destinatários
Se você quiser enviar e-mails para mais de 50 destinatários, faça uma solicitação de suporte.
Ação a executar
Para aumentar sua cota de e-mail, siga as instruções em Aumento de cota para domínios de e-mail.
Nota
Os pedidos de aumento de cota de e-mail podem levar até 72 horas para avaliação e aprovação, especialmente para solicitações que chegam na tarde de sexta-feira.
Conversa
Azure Communication Services suporta chat.
Limites de tamanho para bate-papo
| Nome | Limite |
|---|---|
| Número de participantes no tópico | 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 do Azure Communication Services por Azure Bot Service | 1,000 |
Limites de taxa para bate-papo
| Operação | Âmbito | Limite de 10 segundos | Limite por minuto |
|---|---|---|---|
| Criar thread de bate-papo | Por utilizador | 10 | - |
| Criar thread de bate-papo | Por recurso | - | 3000 |
| Excluir conversa de bate-papo | Por utilizador | 10 | - |
| Atualizar tópico de bate-papo | Por tópico de bate-papo | 5 | - |
| Adicionar ou remover participantes | Por tópico de bate-papo | 10 | 30 |
| Adicionar participantes | Por recurso | - | 3000 |
| Obter tópico de conversa ou listar tópicos de conversa | Por utilizador | 50 | - |
| Receber mensagem de chat | Por utilizador, por conversa de chat | 50 | - |
| Receber mensagem de chat | Por tópico de bate-papo | 250 | - |
| Listar mensagens de bate-papo | Por utilizador, por conversa de chat | 50 | 200 |
| Listar mensagens de bate-papo | Por tópico de bate-papo | 250 | 400 |
| Obter confirmações de leitura (limite de 20 participantes) | Por utilizador, por conversa de chat | 5 | - |
| Obter confirmações de leitura (limite de 20 participantes) | Por tópico de bate-papo | 100 | - |
| Listar participantes do tópico de bate-papo | Por utilizador, por conversa de chat | 10 | - |
| Listar participantes do tópico de bate-papo | Por tópico de bate-papo | 250 | - |
| Enviar mensagem, atualizar mensagem ou excluir mensagem | Por tópico de bate-papo | 10 | 30 |
| Enviar recibo de leitura | Por utilizador, por conversa de chat | 10 | 30 |
| Enviar indicador de digitação | Por utilizador, por conversa de chat | 5 | 15 |
| Enviar indicador de digitação | Por tópico de bate-papo | 10 | 30 |
Nota
Recibos de leitura e indicadores de digitação não são suportados em chats com mais de 20 participantes.
Armazenamento de bate-papo
O Azure Communication Services armazena mensagens de chat de acordo com a política de retenção que define ao criar uma conversa.
Você pode escolher entre a retenção indefinida de mensagens ou a exclusão automática entre 30 e 90 dias por meio da política de retenção na API Criar Thread de Chat. Como alternativa, você pode optar por não definir uma política de retenção em um thread de bate-papo.
Se tiver necessidades estritas de cumprimento, recomendamos que use a API para Eliminar Tópico de Conversa para eliminar tópicos de conversa. Todos os threads criados antes da nova política de retenção não são afetados, a menos que você altere especificamente a política para esse thread.
Nota
Se você excluir mensagens acidentalmente, o sistema não poderá recuperá-las. Se você enviar uma solicitação de suporte para um thread de bate-papo excluído depois que a política de retenção excluir esse thread, ele não poderá ser recuperado. As informações sobre esse segmento não estão mais disponíveis. Se necessário, abra um ticket de suporte o mais rápido possível no prazo de 30 dias após a criação de um tópico para que possamos ajudá-lo.
Chamadas de voz e vídeo
O Azure Communication Services suporta chamadas de voz e vídeo.
Limitações de chamadas PSTN
| Nome | Âmbito | Limite |
|---|---|---|
| Número predefinido de chamadas simultâneas de saída | Por número | 2 |
Nota
Não há limites para chamadas simultâneas de entrada. Também pode submeter um pedido ao Azure Suporte para aumentar o limite para chamadas simultâneas de saída. A nossa equipa de verificação analisa todos os pedidos.
Limitações máximas de chamadas
| Nome | Limite |
|---|---|
| Número de participantes | 350 |
Chamando o suporte de streaming do SDK
O Azure Communication Services Calling SDK suporta as 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 uma partilha de ecrã | Um vídeo + uma partilha de ecrã |
| Número máximo de fluxos remotos de entrada que você pode renderizar simultaneamente. | Nove vídeos + uma partilha de ecrã | Nove vídeos + uma partilha de ecrã |
O SDK de chamada não impõe esses limites, mas seus usuários podem sofrer degradação de desempenho se você exceder esses limites.
Chamando tempos limite do SDK
Os seguintes timeouts aplicam-se aos Azure Communication Services Calling SDKs:
| Ação | Tempo limite em segundos |
|---|---|
| Reconecte ou remova um participante. | cento e vinte |
| Adicionar ou remover nova modalidade de uma chamada. (Iniciar ou parar o compartilhamento de vídeo ou tela.) | 40 |
| Tempo limite da operação de transferência de chamadas. | 60 |
| Tempo limite para estabelecimento de chamada um para um. | 85 |
| Tempo limite de estabelecimento de chamadas em grupo. | 85 |
| Tempo limite de estabelecimento da chamada PSTN. | 115 |
| Promova uma chamada 1:1 para um tempo limite de chamada em grupo. | 115 |
Virtual Rooms
As políticas de limitação do serviço de sala são determinadas por solicitações agrupadas pelo identificador de recursos ID do recurso.
| API | Limite |
|---|---|
| Criar Sala | 20 pedidos/segundo |
| Sala de Atualização | 20 pedidos/segundo |
| Excluir sala | 20 pedidos/segundo |
| Reservar Quarto | 40 pedidos/seg |
| Lista de Quartos | 10 req/seg |
| Atualizar participante | 20 pedidos/segundo |
| Lista de participantes | 40 pedidos/seg |
Ação a executar
Para obter mais informações sobre o SDK e o serviço de chamadas de voz e vídeo, consulte Visão geral do SDK de chamada ou Problemas conhecidos nos SDKs e APIs. Também pode enviar um pedido ao Azure Suporte para aumentar alguns dos limites. A nossa equipa de verificação analisa todos os pedidos.
Router de trabalhos
Quando você envia ou recebe um grande volume de solicitações, você pode receber um ThrottleLimitExceededException erro. Este erro indica que estás a atingir os limites do serviço. Suas solicitações falham até que o bucket de token usado para lidar com solicitações seja reabastecido após um certo tempo.
Limites de taxa para o Job Router
| Operação | Âmbito | Período de tempo (segundos) | Limite (número de pedidos) | Tempo limite em segundos |
|---|---|---|---|---|
| Pedidos gerais | Por recurso | 10 | 3,000 | 5 |
| Obter Tarefas (Restrição de Nível de Rota) | Por recurso | 10 | 332 | 5 |
| Obter estatísticas de fila (Route-Level Limitação) | Por recurso | 10 | 166 | 5 |
| Obter Posição na Fila (Limitação ao Nível de Rota) | Por recurso | 10 | 166 | 5 |
| Obter Trabalhadores (Regulação a Nível de Rota) | Por recurso | 10 | 332 | 5 |
Ação a executar
Se você precisar enviar um volume de mensagens que exceda os limites de taxa, envie-nos um e-mail para acs-ccap@microsoft.com.
Interoperabilidade do Teams e Microsoft Graph
Ao usar um cenário de interoperabilidade do Teams, provavelmente usa algumas APIs Microsoft Graph para criar reuniões.
Cada serviço oferecido através do Microsoft Graph tem limitações diferentes. Os limites específicos do serviço são descritos nesta página Web em mais pormenor.
Ação a executar
Ao implementar o processamento de erros, utilize o código de erro HTTP 429 para detetar limitação de largura de banda. A resposta com falha inclui o cabeçalho de resposta Retry-After. Utilize o atraso de Retry-After para reduzir solicitações. É a forma mais rápida de recuperar do limite de processamento porque o Microsoft Graph continua a registar a utilização dos recursos enquanto o cliente está sujeito ao limite de processamento.
Pode encontrar mais informações sobre limites de Microsoft Graph throttling na documentação Microsoft Graph.