Limites de limitação específicos do serviço do Microsoft Graph

O Microsoft Graph impõe simultaneamente duas categorias de limites de limitação para todas as chamadas à API:

  • Limites globais que se aplicam a todos os serviços
  • Limites específicos de serviço que se aplicam a serviços individuais

Qualquer solicitação poderá ser avaliada em relação a vários limites, dependendo do escopo do limite (por aplicativo em todos os locatários, por locatário para todos os aplicativos, por aplicativo por locatário, e assim por diante), do tipo de solicitação (GET, POST, PATCH e assim por diante) e de outros fatores. O primeiro limite a ser alcançado dispara o comportamento de limitação.

A tabela a seguir indica os limites globais:

Tipo de solicitação Por aplicativo em todos os locatários
Qualquer 130.000 solicitações por 10 segundos

O restante deste artigo fornece uma visão geral dos limites de limitação específicos do serviço para cada serviço do Microsoft Graph.

Observação

Os limites específicos descritos neste artigo estão sujeitos a alterações.

Nesta seção, o termo locatário refere-se à organização Microsoft 365 em que o aplicativo está instalado. Para um aplicativo de locatário único, esse locatário pode ser o mesmo em que o aplicativo foi criado; Para um aplicativo multilocatário, ele pode ser um locatário diferente.

Limites de serviço de atribuição

Tipo de solicitação Limitar por aplicativo por locatário Limitar por locatário para todos os aplicativos
Qualquer 350 solicitações a cada 10 segundos 700 solicitações a cada 10 segundos
Qualquer 10.000 solicitações a cada 3.600 segundos 20.000 solicitações a cada 3.600 segundos
POST /publicar 25 solicitações a cada 10 segundos 25 solicitações a cada 10 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço de reservas

O serviço Bookings aplica limites a cada combinação de ID de aplicativo e caixa de correio, especificamente quando um aplicativo específico acessa uma caixa de correio de reserva específica. Exceder o limite de uma caixa de correio não afeta a capacidade do aplicativo de acessar outra caixa de correio.

Limite Aplicável a
Quatro solicitações simultâneas v1.0 e pontos finais beta

Os limites anteriores se aplicam aos seguintes recursos:

Limites dos serviços de comunicação em nuvem

Recurso Limites por aplicativo
Chamadas 50.000 solicitações em um período de 15 segundos, por aplicativo por locatário
Informações sobre a reunião 2.000 reuniões/usuário por mês
Presença 10.000 solicitações em um período de 30 segundos, por aplicativo por locatário
Evento virtual 750 GET solicitações por aplicativo em todos os locatários em um período de 30 segundos e 15 Createsolicitações Updatee Delete solicitações por aplicativo em todos os locatários em um período de 30 segundos.

Limites de registros de chamadas

Os limites listados na tabela a seguir se aplicam aos seguintes recursos:

Tipo de limite Limite
Por aplicativo para todos os locatários 15.000 solicitações a cada 20 segundos
Por locatário para todos os aplicativos 10.000 solicitações a cada 20 segundos
Por aplicativo por locatário 1.500 solicitações a cada 20 segundos
Registro por chamada 40 solicitações por 20 segundos
Listar registros de chamadas 40 solicitações por 20 segundos

Limites de registros de chamadas PSTN

Os limites listados na tabela a seguir se aplicam aos seguintes recursos:

Tipo de limite Limite
Por locatário 1.000 solicitações a cada 60 segundos
Por aplicativo por locatário 200 solicitações a cada 60 segundos
Por coleção 50 solicitações a cada 60 segundos

Limites de serviço do Excel

Para obter explicações e práticas recomendadas relacionadas à limitação de serviço do Excel, consulte Reduzir de erros de limitação. Além disso, a seguir estão alguns limites de limitação.

Tipo de solicitação Limitar por aplicativo em todos os locatários Limitar por aplicativo por locatário
Qualquer 5000 solicitações a cada 10 segundos 1500 solicitações a cada 10 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço de Educação

Tipo de solicitação Limitar por aplicativo em todos os locatários Limitar por aplicativo por locatário
Qualquer 400.000 solicitações a cada 20 segundos 35.000 solicitações a cada 10 segundos

Os limites anteriores aplicam-se aos seguintes recursos:

Limites do serviço de rastreamento de mensagens do Exchange

Tipo de limite Limite
Por locatário 100 solicitações a cada 5 minutos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço dos arquivos e listas

Para limites de serviço para OneDrive e SharePoint, consulte Evitar ser limitado ou bloqueado no SharePoint.

As informações anteriores aplicam-se aos seguintes recursos:

Limites do serviço de relatórios de identidade e acesso

Tipo de solicitação Limitar por aplicativo em todos os locatários Limitar por aplicativo por locatário
Qualquer 122 solicitações a cada 10 segundos Cinco solicitações a cada 10 segundos
GET signInActivity 10 solicitações por minuto 10 solicitações por minuto

Os limites anteriores se aplicam aos seguintes recursos:

Práticas recomendadas para relatórios de identidade e acesso

As APIs de relatório do Microsoft Entra são limitadas quando o Microsoft Entra ID recebe muitas chamadas durante um determinado período de tempo de um locatário ou aplicativo. As chamadas também poderão ser limitadas se o serviço demorar muito para responder. Se suas solicitações ainda falharem com um código de erro 429 Too Many Requests apesar da aplicação das práticas recomendadas para lidar com a limitação , tente reduzir a quantidade de dados retornados. Tente estas abordagens primeiro:

  • Use filtros para direcionar sua consulta apenas aos dados de que você precisa. Se você precisar apenas de um determinado tipo de evento ou de um subconjunto de usuários, por exemplo, filtre outros eventos usando os parâmetros de consulta $filter e $select para reduzir o tamanho do seu objeto de réplica e o risco de limitação.
  • Se você precisar de um amplo conjunto de dados de relatórios do Microsoft Entra ID, use $filter o createdDateTime para limitar o número de eventos de entrada consultados em uma única chamada. Em seguida, itere pelo próximo intervalo de tempo até ter todos os registros necessários. Por exemplo, se você estiver sendo limitado, poderá começar com uma chamada que solicita três dias de dados e iterar com intervalos de tempo mais curtos até que suas solicitações não sejam mais limitadas.
  • O $select=signInActivity parâmetro na operação List users pode causar limitação mais estrita do que as chamadas padrão da API do Graph. Para evitar esses limites, use esse parâmetro apenas quando necessário. Se você precisar de dados de atividade de entrada, use $top=500 para obter o máximo de 500 usuários por página, em vez dos 100 padrão. Isso reduz o número total de chamadas à API necessárias.

Limites do serviço de identidade e acesso

Padrão

A limitação baseia-se em um algoritmo no bucket de token, que funciona adicionando custos individuais de solicitações. A soma dos custos da solicitação é então comparada com os limites predeterminados. Somente as solicitações que excedem os limites são limitadas. Se algum dos limites for excedido, a resposta será 429 Too Many Requests. É possível receber 429 Too Many Requests respostas mesmo quando os limites a seguir não são atingidos, em situações em que os serviços estão sob uma carga importante ou com base no volume de dados de um locatário específico. A tabela a seguir lista os limites existentes.

Tipo de limite Cota de unidade de recurso Gravar cota
aplicação+par de locatários S: 3.500 ResourceUnits por 10 segundos
M: 5.000 ResourceUnits por 10 segundos
L: 8.000 ResourceUnits por 10 segundos		 3.000 solicitações por 2 minutos e 30 segundos
aplicação 150.000 ResourceUnits por 20 segundos 35.000 solicitações a cada 5 minutos
locatário Não aplicável 18.000 solicitações por 5 minutos

Observação

O limite de aplicativo + par de locatários varia com base no número de usuários nos quais as solicitações de locatário são executadas. Os tamanhos dos locatários são definidos da seguinte maneira: S - em 50 usuários, M - entre 50 e 500 usuários, e L para acima de 500 usuários.

Os limites anteriores se aplicam aos seguintes recursos:

A tabela a seguir lista a base dos custos da solicitação. Qualquer solicitação não listada tem um custo base de 1.

Operação Caminho da Solicitação Base do Custo Unitário de Recurso Gravar Custo
OBTER applications 2 0
OBTER applications/{id}/extensionProperties 2 0
OBTER contracts 3 0
POSTAR directoryObjects/getByIds 5 0
OBTER domains/{id}/domainNameReferences 4 0
POSTAR getObjectsById 5 0
OBTER groups/{id}/members 3 0
OBTER groups/{id}/transitiveMembers 5 0
POSTAR isMemberOf 4 0
POSTAR me/checkMemberGroups 4 0
POSTAR me/checkMemberObjects 4 0
POSTAR me/getMemberGroups 2 0
POSTAR me/getMemberObjects 2 0
OBTER me/licenseDetails 2 0
OBTER me/memberOf 2 0
OBTER me/ownedObjects 2 0
OBTER me/transitiveMemberOf 2 0
OBTER oauth2PermissionGrants 2 0
OBTER oauth2PermissionGrants/{id} 2 0
OBTER servicePrincipals/{id}/appRoleAssignments 2 0
OBTER subscribedSkus 3 0
OBTER users 2 0
OBTER Qualquer caminho de identidade não listado na tabela 1 0
POSTAR Qualquer caminho de identidade não listado na tabela 1 1
PATCH Qualquer caminho de identidade não listado na tabela 1 1
PUT Qualquer caminho de identidade não listado na tabela 1 1
EXCLUIR Qualquer caminho de identidade não listado na tabela 1 1

Importante

O custo das operações POST, PATCH e DELETE no caminho da solicitação applications depende do tipo signInAudience. Para aplicativos em que o signInAudience é AzureADMyOrg ou AzureADMultipleOrgs, o custo é de 70.000 solicitações por 5 minutos; enquanto para aplicativos em que o signInAudience é AzureADandPersonalMicrosoftAccount ou PersonalMicrosoftAccount, o custo é de 60 solicitações por minuto.

Outros fatores que afetam um custo da solicitação:

  • Usar o $select reduz os custos por 1
  • Usar o $expand aumenta os custos por 1
  • Usar o $top com um valor menor que 20 reduz os custos por 1
  • A criação de um usuário em um locatário B2C do Microsoft Entra ID aumenta o custo em 4

Observação

  • Um custo de solicitação nunca pode ser menor que 1. Qualquer custo da solicitação que se aplica a um caminho da solicitação iniciado por me/ também se aplica a solicitações equivalentes iniciadas por users/{id | userPrincipalName}/.
  • Usando $select para directoryObjects/getByIds e getObjectsById resulta em 2 ResourceUnits.

Outros cabeçalhos

Cabeçalhos de solicitação

  • x-ms-throttle-priority - se o cabeçalho não existir ou se estiver definido com qualquer outro valor, ele indicará uma solicitação normal. Recomendamos definir a prioridade para high somente para as solicitações iniciadas pelo usuário. Esse cabeçalho pode ter um dos seguintes valores:
    • Baixa - Indica que a solicitação tem prioridade baixa. Limitando esta solicitação não causa falhas visíveis ao usuário.
    • Normal - Padrão se nenhum valor for fornecido. Indica que a solicitação é a de prioridade padrão.
    • Alta - Indica que a solicitação é de alta prioridade. Limitando esta solicitação causa falhas visíveis ao usuário.

Observação

Se as solicitações forem limitadas, as solicitações de baixa prioridade serão limitadas primeiro, as solicitações de prioridade normal em segundo lugar e as solicitações de alta prioridade por último. Usar o cabeçalho de solicitação de prioridade não altera os limites.

Solicitações de respostas regulares

  • x-ms-resource-unit - Indica a unidade de recurso usada para esta solicitação. Os valores são números inteiros positivos.
  • x-ms-throttle-limit-percentage - Retornado somente quando a aplicação consumiu mais de 0.8 de seu limite. O valor varia de 0.8 a 1.8 e é uma porcentagem do uso do limite. Os chamadores podem usar esse valor para configurar um alerta e executar uma ação.
    • 0,8 indica que você está usando 80% do limite concedido.
    • 1.0 indica que você está usando 100% do limite concedido. Você começa a ver a limitação.
    • 1.2 indica que 20% das solicitações de entrada são limitadas.
    • 1.8 indica que 80% das solicitações de entrada são limitadas.

Solicitações de respostas limitadas

  • x-ms-throttle-scope - por exemplo, Tenant_Application/ReadWrite/9a3d526c-b3c1-4479-ba74-197b5c5751ae/0785ef7c-2d7a-4542-b048-95bcab406e0b. Indica o escopo de limitação com o seguinte formato <Scope>/<Limit>/<ApplicationId>/<TenantId|UserId|ResourceId>:
    • Escopo: (cadeia de caracteres, obrigatório)
      • Tenant_Application - Todas as solicitações para um determinado locatário da aplicação atual.
      • Tenant - Todas as solicitações para o locatário atual, independentemente da aplicação.
      • Application - Todas solicitações para a aplicação atual.
    • Limit: (string, obrigatório)
      • Read: Solicitações de leitura do escopo (GET)
      • Write: Solicitações de gravação do escopo (POST, PATCH, PUT, DELETE...)
      • ReadWrite: Todas solicitações do escopo (qualquer)
    • ApplicationId (GUID, obrigatório)
    • TenantId|UserId|ResourceId: (GUID, obrigatório)
  • x-ms-throttle-information - Indica o motivo para a limitação e pode ter qualquer valor (cadeia de caracteres). O valor é fornecido para fins de solução de problemas e diagnósticos. Alguns exemplos incluem:
    • CPULimitExceeded - Limitando porque o limite para alocação do CPU está excedido.
    • WriteLimitExceeded - limitando porque o limite para gravação está excedido.
    • ResourceUnitLimitExceeded - Limitando porque o limite para a unidade de recurso alocada foi excedido.

Limites de operação de serviços de política de dados de identidade e acesso

Tipo de solicitação Limite por inquilino
Postar no exportPersonalData 1.000 solicitações por dia para qualquer assunto e 100 por assunto por dia
Qualquer outra solicitação 10.000 solicitações por hora

Os limites anteriores se aplicam aos seguintes recursos:

Observação

Os recursos listados anteriormente não retornam um Retry-After cabeçalho nas 429 Too Many Requests respostas.

Limites de serviço de operação do dispositivo de identidade e acesso

Tipo de solicitação Limitar por aplicativo por locatário Limite por usuário por locatário
POSTAR, CORRIGIR, EXCLUIR 3.000 solicitações por 2 minutos e 30 segundos 25 solicitações a cada 10 segundos

Os limites anteriores se aplicam à cota de gravação para o recurso de dispositivo .

Proteção da identidade e limites do serviço de acesso condicional

Tipo de solicitação Limitar por locatário para todos os aplicativos
Qualquer Uma solicitação por segundo

Observação

Os recursos listados anteriormente não retornam um Retry-After cabeçalho nas 429 Too Many Requests respostas.

Limites de serviço dos fornecedores de identidade

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
Qualquer 300 solicitações por 1 minuto 200 solicitações por 1 minuto

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço de ETL de dados do setor

O serviço de dados do setor limita as execuções sob demanda a um máximo de cinco inícios bem-sucedidos a cada 12 horas.

Limites do serviço de proteção de informações

Os seguintes limites se aplicam a qualquer solicitação no /informationProtection.

Para o email, o recurso é um par único de mensagens de rede ID/recipiente. Por exemplo, enviar um email com a mesma ID de mensagem enviada para a mesma pessoa várias vezes em um período de 15 minutos aciona os limites de limite por recurso listados na tabela a seguir. Entretanto, você pode enviar até 150 emails únicos a cada 15 minutos (limite de locatário).

Operation Limite por inquilino Limite por recurso (email, URL, arquivo)
POST 150 solicitações a cada 15 minutos e 10.000 solicitações a cada 24 horas Uma solicitação a cada 15 minutos e 3 solicitações a cada 24 horas

Percepção dos limites de serviço

Os seguintes limites se aplicam a qualquer pedido em me/insights ou users/{id}/insights.

Limite Aplicável a
10.000 solicitações de API em um período de 10 minutos pontos de extremidade v1.0 e beta
Quatro solicitações simultâneas v1.0 e pontos finais beta

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço do Android for Work do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviços para aplicações do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço para notificações do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço livros do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço de pacotes do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço de sincronização de Chromebook do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço de termos da empresa do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço de configuração do dispositivo Intune v2

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limite de serviço para a configuração de dispositivo do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço para inscrição de dispositivo do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço de intenção do dispositivo Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço dispositivo do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELETE, PATCH 400 solicitações a cada 20 segundos 200 solicitações por 20 segundos
Qualquer 4000 solicitações a cada 20 segundos 2000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço do Intune Endpoint Protection

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço para inscrição do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço do Intune GPAnalytics

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviços para aplicações gerenciadas do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço para notificações do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço ODJ do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço de integração de parceiros do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço rbac do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço da assistência remota do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço de telefonia do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço do Intune TEM

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço para solução de problemas do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço de desbloqueio do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço de atualização do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço wip do Intune

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço do gerenciador de convite

Os seguintes limites se aplicam a qualquer solicitação no /invitations.

Operation Limitar por locatário para todos os aplicativos
Qualquer operação 150 solicitações a cada 5 segundos

Limites de serviço de relatórios do Microsoft 365

Os seguintes limites se aplicam a qualquer solicitação no /reports.

Operation Limitar por aplicativo por locatário Limitar por locatário para todos os aplicativos
Qualquer pedido (CSV) 14 solicitações a cada 10 minutos 40 solicitações a cada 10 minutos
Qualquer solicitação (JSON, beta) 100 solicitações a cada 10 minutos n/d

Os limites anteriores aplicam-se individualmente a cada relatório de API. Por exemplo, uma solicitação para a API de relatório de atividades do usuário do Microsoft Teams e uma solicitação para a API de relatório de atividades do usuário do Outlook em até 10 minutos contam como uma solicitação de 14 para cada API, não duas solicitações de 14 para ambas.

Os limites anteriores se aplicam a todos os recursos de relatórios de uso.

Limites do serviço do Microsoft Teams

O Microsoft Teams aplica limites de limitação em quatro dimensões independentes. Uma solicitação é limitada quando excede qualquer limite que se aplica a ela, portanto, sempre projete para o limite mais baixo que seu cenário atingir.

Dimensão O que conta Quando normalmente se aplica
Por aplicativo Todas as solicitações de um aplicativo (ID do cliente) somadas em todos os locatários. Aplicativos multilocatários que atendem a muitos clientes.
Por aplicativo por locatário Solicitações de um aplicativo em um único locatário. O limite mais comumente atingido.
Por recurso Solicitações em uma única equipe, canal ou chat. Aplicativos que concentram o tráfego em uma conversa.
Por usuário Solicitações feitas em nome de um único usuário. Cenários de permissão delegada (usuário).

Os limites são expressos como solicitações por segundo (rps), a menos que seja indicado o contrário.

Cada limite é avaliado em uma janela de intermitência curta. Um limite sustentado de aproximadamente 83% do valor listado também é avaliado em uma janela mais longa, portanto, uma carga de trabalho executada continuamente na taxa listada ainda pode ser limitada. Dimensione o tráfego de estado estável abaixo do limite listado e use a redução exponencial.

Um traço (-) significa que nenhum limite dedicado está definido para essa dimensão. A solicitação ainda está sujeita aos limites padrão e a qualquer outro limite na mesma linha.

Teams

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /teams/{team-id} 1500 rps 30 rps 4 RPs por equipe -
GET /me/joinedTeams ou /users/{user-id}/joinedTeams 300 rps 30 rps - -
POST /teams 100 rps 10 rps - -
PUT /groups/{team-id}/team 150 rps 6 rps - -
PATCH /teams/{team-id} 300 rps 30 rps 4 RPs por equipe -
POST /teams/{team-id}/clone 150 rps 6 rps - -
POST /teams/{team-id}/completeMigration 100 rps 10 rps - -

Canais

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /teams/{team-id}/channels 1200 rps 60 rps 4 RPs por equipe -
GET /teams/{team-id}/channels/{channel-id} 600 rps 30 rps 1 rps por canal -
GET /teams/{team-id}/channels/{channel-id}/members 1200 rps 60 rps 1 rps por canal -
POST /teams/{team-id}/channels 100 rps 10 rps 4 RPs por equipe -
PATCH /teams/{team-id}/channels/{channel-id} 300 rps 30 rps 1 rps por canal -
EXCLUIR /teams/{team-id}/channels/{channel-id} 150 rps 15 rps 1 rps por canal -
POST /teams/{team-id}/channels/{channel-id}/completeMigration 100 rps 10 rps - -

Mensagens do canal

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /teams/{team-id}/channels/{channel-id}/messages 200 rps 20 rps 1 rps por canal -
POST /teams/{team-id}/channels/{channel-id}/messages 500 rps 50 rps 1 rps por canal 1 rps
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies 500 rps 50 rps 1 rps por canal 1 rps

Os limites de POST na tabela anterior são compartilhados por envios regulares de mensagens e por importação de mensagens. O limite por usuário não se aplica à importação.

Chats

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /chats, /me/chats ou /users/{user-id}/chats 200 rps 20 rps - 1 rps
GET /chats/{chat-id} 2000 rps 200 rps 1 rps por chat 5 rps
POST /chats 200 rps 20 rps - -
PATCH /chats/{chat-id} 300 rps 30 rps 1 rps por chat -
EXCLUIR /chats/{chat-id} 10 rps 1 rps 1 rps por chat -
POST /chats/{chat-id}/removeAllAccessForUser 300 rps 30 rps 1 rps por chat 1 rps

Mensagens de chat

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /chats/{chat-id}/messages 200 rps 20 rps 1 rps por chat -
POST /chats/{chat-id}/messages 200 rps 20 rps 1 rps por chat 1 rps
PATCH /chats/{chat-id}/messages/{message-id} 300 rps 30 rps 1 rps por chat -
POST /chats/{chat-id}/messages/{message-id}/softDelete ou undoSoftDelete 300 rps 30 rps 1 rps por chat -
GET /chats/{chat-id}/messages/{message-id}/hostedContents 500 rps 50 rps 1 rps por chat -
GET /chats/{chat-id}/messages/{message-id}/hostedContents/{id}/$value 600 rps 60 rps 1 rps por chat -

Members

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /teams/{team-id}/members 1200 rps 60 rps 4 RPs por equipe -
POST /teams/{team-id}/members 300 rps 30 rps 4 solicitações por minuto por equipe -
POST /teams/{team-id}/members/add 100 rps 10 rps 4 solicitações por minuto por equipe -
POST /chats/{chat-id}/members 300 rps 30 rps 4 solicitações por minuto por chat -
EXCLUIR /chats/{chat-id}/members/{membership-id} 300 rps 30 rps 4 solicitações por minuto por chat -

Aplicativos, guias e concessões de permissão

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET installedApps para equipe, chat ou usuário 1500 rps 30 rps 1 rps por chat ou canal -
GET permissionGrants para equipe ou chat 1500 rps 30 rps 1 rps por chat ou canal -
POST instaladoAplicativos para equipe, chat ou usuário 300 rps 30 rps 1 rps por chat ou canal -
EXCLUIR installedApps para equipe, chat ou usuário 150 rps 15 rps 1 rps por chat ou canal -
OBTER guias para canal ou chat 600 rps 30 rps 1 rps por chat ou canal -
Guias POST para canal ou chat 300 rps 30 rps 1 rps por chat ou canal -
Guia PATCH 300 rps 30 rps 1 rps por chat ou canal -
EXCLUIR guias para canal ou chat 150 rps 15 rps 1 rps por chat ou canal -
GET /appCatalogs/teamsApps 1500 rps 30 rps - -
POST /appCatalogs/teamsApps 300 rps 30 rps - -
EXCLUIR /appCatalogs/teamsApps/{app-id} 150 rps 15 rps - -

Notificações de feed de atividades

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
POST /teams/{team-id}/sendActivityNotification 50 rps 5 rps 4 RPs por equipe -
POST /chats/{chat-id}/sendActivityNotification 50 rps 5 rps 1 rps por chat -
POST /users/{user-id}/teamwork/sendActivityNotification 50 rps 5 rps - -
POST /teamwork/sendActivityNotificationToRecipients 20 rps 2 rps - -

Recuperação de mensagem em massa

Essas APIs são projetadas para cenários de exportação e conformidade e têm seus próprios limites mais altos.

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /teams/{team-id}/channels/getAllMessages ou /channels/allMessages 1000 rps 200 rps - -
GET /users/{user-id}/chats/getAllMessages ou /chats/allMessages 1000 rps 200 rps - -
GET /teams/{team-id}/channels/getAllRetainedMessages 1000 rps 200 rps - -
GET /users/{user-id}/chats/getAllRetainedMessages 1000 rps 200 rps - -
GET /copilot/users/{user-id}/interactionHistory/getAllEnterpriseInteractions 1500 rps 30 rps - -

Turnos

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
GET /teams/{team-id}/schedule e todas as APIs nesse caminho 600 rps 30 rps - -
POST /teams/{team-id}/schedule e todas as APIs nesse caminho 300 rps 30 rps - -
PUT /teams/{team-id}/schedule e todas as APIs nesse caminho 300 rps 30 rps - -

Seções

Solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
Todas as APIs de gerenciamento de seção em /users/{user-id}/teamwork/sections - 5 rps - -

Todas as operações de seção, incluindo seções, itens de seção, ações de reordenação e consultas delta, compartilham um único limite.

Limites padrão

Qualquer solicitação do Microsoft Teams que não esteja listada nas tabelas anteriores usa esses limites.

Tipo de solicitação Por aplicativo Por aplicativo por locatário Por recurso Por usuário
OBTER 1500 rps 30 rps 1 rps por chat ou canal 1 rps
POST, PUT e PATCH 300 rps 30 rps 1 rps por chat ou canal 1 rps
DELETE 150 rps 15 rps 1 rps por chat ou canal 1 rps

Confira também limites do Microsoft Teams e requisitos de votação.

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço de gerenciamento multilocatário

Tipo de solicitação Limitar por locatário para todos os aplicativos Limitar por aplicativo por locatário
POST, PUT, DELATE, PATCH 200 solicitações por 20 segundos 100 solicitações por 20 segundos
Qualquer 2000 solicitações por 20 segundos 1000 solicitações por 20 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites do serviço OneNote

Tipo de limite Limitar por aplicativo por usuário (contexto delegado) Limite por aplicativo (contexto somente de aplicativo)
Taxa de solicitações 120 solicitações por 1 minuto e 400 por 1 hora 240 solicitações por 1 minuto e 800 por 1 hora
Solicitações simultâneas Cinco solicitações simultâneas 20 solicitações simultâneas

Os limites anteriores se aplicam aos seguintes recursos:

Você pode encontrar informações adicionais sobre as práticas recomendadas no limitação da API do OneNote e como evitá-la.

Observação

Os recursos listados anteriormente não retornam um Retry-After cabeçalho nas 429 Too Many Requests respostas.

Limitações de serviços à extensões de esquema e abertas

Tipo de solicitação Limitar por aplicativo por locatário
Qualquer 455 solicitações a cada 10 segundos

Os limites anteriores se aplicam aos seguintes recursos:

Limites de serviço do Outlook

Os limites de serviço do Outlook se aplicam às implantações de nuvem pública e de nuvem nacional.

Limites por caixa de correio

O serviço Outlook aplica limites a cada combinação de ID de aplicativo e caixa de correio, ou seja, um aplicativo específico que acessa uma caixa de correio de usuário ou grupo específico. Exceder o limite de uma caixa de correio não afeta a capacidade do aplicativo de acessar outra caixa de correio.

Limite Aplicável a
10.000 solicitações de API em um período de 10 minutos pontos de extremidade v1.0 e beta
Quatro solicitações simultâneas pontos de extremidade v1.0 e beta
Upload de 150 megabytes (MB) (PATCH, POST, PUT) em um período de 5 minutos v1.0 e pontos finais beta

Recursos de serviço do Outlook

API Recursos
Pesquisar API (visualização)
  • Item externo (Pesquisa da Microsoft)
    		•
    API de perfil
  • Foto
    		•
    API de Calendário
  • event
  • eventMessage
  • calendar
  • calendarGroup
  • outlookCategory
  • attachment
  • place (preview)
    		•
    API de Email do Outolook
  • message
  • mailFolder
  • mailSearchFolder
  • messageRule
  • outlookCategory
  • attachment
    		•
    API de importação e exportação de caixa de correio
  • mailbox
  • mailboxItem
  • pasta de caixa de correio
  • exchangeSettings
    		•
    API de contatos pessoais
  • contato
  • contactFolder
  • outlookCategory
    		•
    Inteligência social e do local de trabalho
  • pessoa
    		•
    API de tarefas pendentes (visualização)
  • outlookTask
  • outlookTaskFolder
  • outlookTaskGroup
  • outlookCategory
  • attachment
    		•

    Limites de serviço do Outlook para envio em lote de JSON

    Quando um aplicativo faz uma solicitação em lote JSON que consiste em várias solicitações individuais não ordenadas para o serviço do Outlook, por padrão, o Microsoft Graph envia ao serviço do Outlook até quatro solicitações individuais do lote por vez, independentemente das caixas de correio de destino dessas solicitações. O serviço Outlook pode executar essas solicitações em paralelo a qualquer momento, independentemente da caixa de correio de destino. Como o Microsoft Graph envia apenas até quatro solicitações para serem executadas em paralelo, a execução desse lote permanece dentro dos limites de simultaneidade do Outlook para a mesma caixa de correio, independentemente do aplicativo usado.

    Como alternativa, um aplicativo pode usar a dependsOn propriedade para solicitar solicitações em um lote. O Microsoft Graph envia ao serviço do Outlook uma solicitação do lote por vez, seguindo a ordem especificada, e o Outlook executa cada solicitação individual no lote sequencialmente.

    Em outras palavras, ao direcionar a mesma caixa de correio, os aplicativos que permitem que várias solicitações em lote sejam executadas em paralelo podem usar uma das seguintes abordagens:

    • Se as solicitações individuais não precisarem ser solicitadas, faça com que solicitações individuais de um único lote sejam executadas simultaneamente.
    • Use a dependsOn propriedade para solicitar solicitações em um lote e tenha até quatro dessas solicitações em lote executadas simultaneamente.

    Limites de serviço do Places

    As seguintes APIs do Places têm um limite de limitação de três chamadas por segundo:

    Limites de serviços do Project Rome

    Tipo de solicitação Limitar por usuário a todos os aplicativos
    OBTER 400 solicitações por 5 minutos e 12.000 solicitações por dia
    POSTAR, COLOCAR, CORRIGIR, EXCLUIR 100 solicitações por 5 minutos e 8.000 solicitações por dia

    Os limites anteriores se aplicam aos seguintes recursos:

    Limites de serviços de detecção de segurança e incidentes

    Os seguintes limites se aplicam a qualquer solicitação no /security.

    Operation Limitar por aplicativo por locatário
    Qualquer operação em alert, securityActions, secureScore 150 solicitações por minuto
    Qualquer operação em tiIndicator 1.000 solicitações por minuto
    Qualquer operação em secureScore ou secureScorecontrolProfile 10.000 solicitações de API em um período de 10 minutos
    Qualquer operação em secureScore ou secureScorecontrolProfile Quatro solicitações simultâneas

    Limites do serviço de Descoberta Eletrônica de Segurança

    Os seguintes limites se aplicam a qualquer solicitação no /security/eDiscoveryCases.

    Operation Limitar por aplicativo por locatário
    Qualquer Cinco solicitações por minuto

    Limites do Serviço de Comunicações

    Os limites a seguir se aplicam a qualquer tipo de solicitação de comunicações de serviço em /admin/serviceAnnouncement/.

    Tipo de solicitação Limitar por aplicativo por locatário
    Qualquer 240 solicitações por 60 segundos
    Qualquer 800 solicitações por hora

    Limites do serviço de assinatura

    Tipo de solicitação Limitar por aplicativo em todos os locatários Limitar por aplicativo por locatário
    POST, PUT, DELETE, PATCH 2000 solicitações por 20 segundos 500 solicitações a cada 20 segundos
    POST /reautorizar assinatura por ID 4000 solicitações a cada 20 segundos 1000 solicitações por 20 segundos
    OBTER Assinatura por ID 2000 solicitações por 20 segundos 500 solicitações a cada 20 segundos
    OBTER Lista de Assinaturas 40 solicitações por 20 segundos 25 solicitações a cada 20 segundos

    Os limites anteriores se aplicam ao recurso de assinatura .

    Limites de serviços de tarefas e planos

    Os limites de serviço para o Planner não estão disponíveis.

    As informações anteriores aplicam-se aos seguintes recursos:

    Limites de serviço do Viva Engage

    As chamadas à API do Viva Engage estão sujeitas à limitação de taxa, permitindo 10 solicitações por usuário, por aplicativo, em um período de 30 segundos. Quando você excede o limite de taxa, todas as solicitações subsequentes retornam um código de 429 Too Many Requests resposta.

    Limites de serviço do Windows 365

    Tipo de solicitação Limite por locatário para todos os aplicativos ou usuários Limite por aplicativo ou usuário por locatário
    Listar PCs na Nuvem 180 solicitações a cada 60 segundos 162 solicitações a cada 60 segundos
    Obter PC na nuvem 540 solicitações a cada 60 segundos 486 solicitações a cada 60 segundos

    A partir de 30 de setembro de 2025, o limite de limitação por aplicativo/por usuário por locatário será reduzido para metade do limite total por locatário para impedir que um único usuário ou aplicativo consuma toda a cota em um locatário.

    Tipo de solicitação Limite por locatário para todos os aplicativos ou usuários Limite por aplicativo ou usuário por locatário
    Listar PCs na Nuvem 180 solicitações a cada 60 segundos 90 solicitações a cada 60 segundos
    Obter PC na nuvem 540 solicitações a cada 60 segundos 270 solicitações a cada 60 segundos

    Conteúdo relacionado

    • Last updated on