Limites de serviço para o Azure Communication Services
Este documento explica as limitações das APIs dos Serviços de Comunicação do Azure e possíveis resoluções.
Padrões e arquitetura de limitação
Quando você atinge limitações de serviço, você recebe um código de status HTTP 429 (muitas 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.
- Reduza a frequência de chamadas.
- Evite novas tentativas imediatas porque todos os pedidos vão-se acumulando em relação aos limites de utilização.
Você pode encontrar orientações mais gerais sobre como configurar sua arquitetura de serviço para lidar com a limitação e as limitações na documentação da Arquitetura do Azure para padrões de limitação. Para aumentar os limites de limitação, você precisa fazer uma solicitação ao Suporte do Azure.
- Abra o portal do Azure e inicie sessão.
- Selecione Ajuda+Suporte.
- Clique em Criar nova solicitação de suporte.
- Na caixa de texto Descrever o problema, digite
Technicale clique em Ir. - No menu suspenso Selecione um serviço, selecione Limites de Serviço e Assinatura (Cotas) e clique em Avançar.
- Na descrição do problema, escolha o tipo de problema, Assinatura e Tipo de cota e clique em Avançar.
- Reveja qualquer Solução recomendada, se disponível, e clique em Seguinte.
- Adicione detalhes adicionais conforme necessário e clique em Avançar.
- Em Rever + criar , verifique as informações, faça as alterações necessárias e, em seguida, clique em Criar.
Você pode seguir a documentação para criar a solicitação ao Suporte do Azure.
Aquisição de 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 a seguir se aplicam a números de compra por meio do SDK de Números de Telefone e do portal do Azure.
| Operação | Âmbito | Período de tempo | Limite (número de pedidos) |
|---|---|---|---|
| Número de telefone da compra | Inquilino do Azure | - | 1 |
| Pesquisar números de telefone | Inquilino do Azure | uma semana | 5 |
Ação a executar
Para obter mais informações, consulte a página de conceito de tipos de número de telefone e a página de visão geral do conceito de telefonia.
Os limites de compra de número podem ser aumentados por meio de uma solicitação ao Suporte do Azure.
- Abra o portal do Azure e inicie sessão.
- Selecione Ajuda+Suporte.
- Clique em Criar nova solicitação de suporte.
- Na caixa de texto Descrever o problema, digite
Technicale clique em Ir. - No menu suspenso Selecione um serviço, selecione Limites de Serviço e Assinatura (Cotas) e clique em Avançar.
- Na descrição do problema, escolha o tipo de problema, Assinatura e Tipo de cota e clique em Avançar.
- Reveja qualquer Solução recomendada, se disponível, e clique em Seguinte.
- Adicione detalhes adicionais conforme necessário e clique em Avançar.
- Em Rever + criar , verifique as informações, faça as alterações necessárias e, em seguida, clique em Criar.
Identidade
| Operação | Prazos (segundos) | Limite (número de pedidos) |
|---|---|---|
| Criar 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 executar
Recomendamos adquirir identidades e tokens antes de criar threads de bate-papo ou iniciar chamadas. Por exemplo, quando a página da Web é carregada ou o aplicativo é iniciado.
Para obter mais informações, consulte a página de visão geral do conceito de identidade.
SMS
Ao enviar ou receber um grande volume de mensagens, você pode receber um 429 erro. Esse erro indica que você está atingindo as limitações do serviço e suas mensagens são enfileiradas para serem enviadas quando o número de solicitações estiver abaixo do limite.
Limites de taxa para SMS:
| Operação | Tipo de Número | Âmbito | Prazo(s) | Limite (pedido #) | Unidades de mensagem por minuto |
|---|---|---|---|---|---|
| Enviar Mensagem | Ligação gratuita | 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 você tiver requisitos que excedam os limites de taxa, envie uma solicitação ao Suporte do Azure para habilitar uma taxa de transferência mais alta.
Para obter mais informações sobre o SDK e o serviço do SMS, consulte a página de visão geral do SMS SDK ou a página de perguntas frequentes do SMS.
Você pode enviar um número limitado de mensagens de e-mail. Se exceder os seguintes limites para a sua subscrição, os seus pedidos serão rejeitados. Você pode tentar essas solicitações novamente, depois que o tempo Repetir-Depois 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 dos Serviços de Comunicação do Azure foi projetado para oferecer suporte a 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 aumentar gradualmente o volume de emails usando o Email dos Serviços de Comunicação do Azure durante um período de duas a quatro semanas, enquanto monitoramos de perto o status de entrega de 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.
Limites de taxa para e-mail
Aprovamos limites mais altos para clientes com base nos requisitos de casos de uso, reputação do domínio, padrões de tráfego e taxas de falha. Para solicitar limites mais altos, siga as instruções em Aumento de cota para domínios de e-mail. Cotas mais altas só estão disponíveis para domínios personalizados verificados, não para domínios gerenciados pelo Azure.
| Operação | Âmbito | Prazo (minutos) | Limite (número de e-mails) |
|---|---|---|---|
| Enviar E-mail | Por Subscrição | 1 | 30 |
| Enviar E-mail | Por Subscrição | 60 | 100 |
| Obter status de e-mail | Por Subscrição | 1 | 60 |
| Obter status de e-mail | Por Subscrição | 60 | 200 |
| Operação | Âmbito | Prazo (minutos) | Limite (número de e-mails) |
|---|---|---|---|
| Enviar E-mail | Por Subscrição | 1 | 5 |
| Enviar E-mail | Por Subscrição | 60 | 10 |
| Obter status de e-mail | Por Subscrição | 1 | 10 |
| Obter status de e-mail | Por Subscrição | 60 | 20 |
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, você precisa considerar que essa 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 ~10 MB, poderá esperar um valor de tamanho máximo de mensagem realista de aproximadamente ~7,5 MB.
Enviar anexos com mais de 10 MB
Para enviar anexos de ficheiros até 30 MB por e-mail, preencha um pedido de suporte.
Se precisar de enviar anexos de ficheiros de e-mail com mais de 30 MB, pode utilizar esta solução alternativa. Armazene os arquivos em uma conta de Armazenamento de Blob do Azure e inclua um link para os arquivos em 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 de Armazenamento de Blob do Azure:
- Você pode lidar com arquivos de grande escala.
- Você pode usar chaves SAS para gerenciar com precisão o acesso a arquivos.
Para obter mais informações, consulte:
- Introduction to Azure Blob Storage (Introdução ao Armazenamento de Blobs do Azure)
- Conceder acesso limitado aos recursos do Armazenamento do Azure com assinaturas de acesso partilhado (SAS)
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 serem avaliados e aprovados, especialmente para pedidos que chegam na tarde de sexta-feira.
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 dos Serviços de Comunicação do Azure por Bot do Azure | 1000 |
Limites de taxa para bate-papo
| Operação | Scope | Limite por 10 segundos | Limite por minuto |
|---|---|---|---|
| Criar thread de bate-papo | por Utilizador | 10 | - |
| Excluir thread de bate-papo | por Utilizador | 10 | - |
| Atualizar tópico de bate-papo | por tópico de bate-papo | 5 | - |
| Adicionar participantes / remover participantes | por tópico de bate-papo | 10 | 30 |
| Obter thread de bate-papo / Listar tópicos de bate-papo | por Utilizador | 50 | - |
| Receber mensagem de chat | por usuário por thread de bate-papo | 50 | - |
| Receber mensagem de chat | por tópico de bate-papo | 250 | - |
| Listar mensagens de bate-papo | por usuário por thread de bate-papo | 50 | 200 |
| Listar mensagens de bate-papo | por tópico de bate-papo | 250 | 400 |
| Obter recibos de leitura (limite de 20 participantes*) | por usuário por thread de bate-papo | 5 | - |
| Obter recibos de leitura (limite de 20 participantes*) | por tópico de bate-papo | 100 | - |
| Listar participantes do tópico de bate-papo | por usuário por thread de bate-papo | 10 | - |
| Listar participantes do tópico de bate-papo | por tópico de bate-papo | 250 | - |
| Enviar mensagem / atualizar mensagem / apagar mensagem | por tópico de bate-papo | 10 | 30 |
| Enviar recibo de leitura | por usuário por thread de bate-papo | 10 | 30 |
| Enviar indicador de digitação | por usuário por thread de bate-papo | 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 tópicos de bate-papo com mais de 20 participantes.
Armazenamento de bate-papo
Os Serviços de Comunicação do Azure armazenam mensagens de chat de acordo com a política de retenção definida ao criar um thread de chat.
Importante
A funcionalidade descrita neste artigo está atualmente em visualização pública. Esta versão de pré-visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.
Você pode escolher entre retenção indefinida de mensagens ou 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 você tiver necessidades estritas de conformidade, recomendamos excluir threads de bate-papo usando o API Delete Chat Thread. 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ê apagou mensagens acidentalmente, elas não podem ser recuperadas pelo sistema. Além disso, 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á mais ser recuperado e nenhuma informação sobre esse thread estará disponível. Se necessário, abra um ticket de suporte o mais rápido possível dentro da janela de 30 dias após a criação de um thread para que possamos ajudá-lo.
Chamadas de voz e vídeo
Limitações da chamada PSTN
| Nome | Scope | Limite |
|---|---|---|
| Número padrão de chamadas simultâneas de saída* | por Número | 2 |
Nota
* Sem 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 chamadas
| Nome | Limite |
|---|---|
| Número de participantes | 350 |
Chamando o suporte de streaming do SDK
O SDK de Chamada de Serviços de Comunicação suporta as seguintes configurações de streaming:
| Limite | Web | Windows/Android/iOS |
|---|---|---|
| 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ã |
| 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 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 vídeo ou partilha de ecrã) | 40 |
| Tempo limite da operação de transferência de chamadas | 60 |
| Tempo limite de estabelecimento da chamada 1:1 | 85 |
| Tempo limite de estabelecimento de chamadas em grupo | 85 |
| Tempo limite de estabelecimento da chamada PSTN | 115 |
| Promover chamada 1:1 para um tempo limite de chamada em grupo | 115 |
Ação a executar
Para obter mais informações sobre o SDK e o serviço de chamadas de voz e vídeo, consulte a página de 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 revisão por nossa equipe de verificação.
Roteador de trabalho
Ao enviar ou receber um grande volume de solicitações, você pode receber um ThrottleLimitExceededException erro. Esse erro indica que você está atingindo as limitações de serviço e suas solicitações falham até que o token de bucket 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 | 1000 | 10 |
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
Usando um cenário de interoperabilidade do Teams, você provavelmente usará algumas APIs do 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 aqui com mais detalhes.
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 da Retry-After resposta. Recuar solicitações usando o Retry-After atraso é a maneira mais rápida de se recuperar da limitação, porque o Microsoft Graph continua a registrar o uso de recursos enquanto um cliente está sendo limitado.
Você pode encontrar mais informações sobre os limites de limitação do Microsoft Graph na documentação do Microsoft Graph.
Próximos passos
Consulte as opções de ajuda e suporte .