Microsoft Graph retorna 429 Too Many Requests em scripts de carga em massa: o que mudar
By Mirko Peters ·
Seu script do Graph fica lento ou falha com 429 mesmo com uma requisição a cada dez segundos. Veja por que propriedades custosas e cotas compartilhadas importam e como recuar, dividir chamadas e usar lotes com segurança.
Automatically translated with AI from the original post. Read the English original
Um script lê dados de usuários do Microsoft Graph, um usuário por vez, em um ritmo lento e cuidadoso. Mesmo assim, recebe 429 Too Many Requests. Uma thread do Microsoft Q&A de maio de 2026 descreve exatamente esse caso: uma chamada para um usuário, uma lista longa em $select que inclui signInActivity, um $expand=manager e um cliente configurado para uma requisição a cada dez segundos, com uma requisição em andamento por vez.
Pontos-chave
- Uma taxa fixa de requisições não protege você. Os limites dependem do tipo de requisição, do aplicativo e do locatário. A Learn lista GET signInActivity com 10 requisições por minuto.
- Aguarde o número de segundos indicado no cabeçalho Retry-After e só então tente novamente. A Learn afirma que o Graph continua registrando o uso enquanto você está limitado, então tentativas imediatas pioram a situação.
- Separar propriedades custosas das chamadas por usuário, paginar com um $top maior e usar delta ou notificações de alteração reduzem a quantidade de requisições.
- Em uma chamada $batch, cada requisição é avaliada individualmente. O lote retorna 200 enquanto requisições isoladas dentro dele falham com 429, e elas não são repetidas automaticamente para você.
Uma segunda thread, de fevereiro de 2026, perguntou como funciona a limitação quando muitos drives do SharePoint e do OneDrive são lidos em paralelo. Juntas, as duas threads mostram por que um simples limite de taxa no cliente não é suficiente. Este artigo explica o que a Microsoft Learn documenta e o que as threads apenas sugeriram. É um guia de solução de problemas, não um procedimento oficial da Microsoft.
O que as threads relataram
Thread de maio de 2026 (endpoint de usuários). O autor da pergunta recebeu 429 em GET /v1.0/users/{id} com muitas propriedades, incluindo signInActivity, além de $expand=manager. Paginação e filtros não ajudaram, porque cada chamada retornava um único usuário. Um moderador da Microsoft respondeu que as propriedades custosas, e não apenas a taxa de requisições, causam a limitação. O moderador sugeriu dividir as chamadas (perfil, atividade de login e gerente), respeitar o Retry-After com recuo exponencial, usar cache e ler a atividade de login com menos frequência. Essa resposta não foi marcada como aceita. Uma resposta gerada por IA, que o autor da pergunta marcou como aceita, dizia praticamente o mesmo. O autor não informou se os 429 pararam.
Discussão de fevereiro de 2026 (driveItems). A pessoa que perguntou queria saber se a limitação de requisições (throttling) se aplica por site ou por drive, e qual nível de concorrência é seguro. Uma resposta anônima, aceita por quem perguntou, afirmou que os limites são aplicados em camadas (locatário, aplicativo e serviço), que requisições para sites diferentes podem consumir a mesma cota, e que você deve respeitar o Retry-After, usar $batch e preferir consultas delta e notificações de alteração em vez de polling. A resposta não informou nenhum número de concorrência. Quem perguntou disse que ajudou.
Passo 1: leia o erro 429 corretamente
Registre três informações em cada falha: a URL da requisição, o valor de Retry-After e o horário. A página de solução de problemas do Graph PowerShell da Learn sugere executar um cmdlet com -Debug para ver o método HTTP, a URI e o código de status, e recomenda anotar os cabeçalhos de resposta request-id e date caso você abra um chamado de suporte.
A discussão de maio de 2026 não citou nenhum valor de Retry-After. Sem ele, ninguém consegue dizer qual limite o script atingiu.
Passo 2: respeite o Retry-After
A página de throttling da Learn é clara sobre isso:
- Aguarde o número de segundos indicado no cabeçalho
Retry-After. - Tente a requisição novamente.
- Se a requisição falhar com 429 novamente, continue usando o mesmo intervalo até que ela seja bem-sucedida.
A Learn explica o motivo: o Microsoft Graph continua registrando o uso de recursos enquanto um cliente está sob throttling, por isso aguardar conforme o cabeçalho é a forma mais rápida de se recuperar. Tentativas imediatas aumentam o seu consumo. Se a resposta não tiver o cabeçalho Retry-After, a Learn recomenda backoff exponencial.
A Learn afirma que os SDKs do Microsoft Graph já tratam isso. Ela não diz o mesmo sobre os cmdlets do Graph PowerShell, então não presuma que o façam. Se o seu script encapsula chamadas brutas, como Invoke-MgGraphRequest, implemente você mesmo a espera.
Passo 3: identifique as chamadas mais custosas
A página de limites específicos por serviço da Learn tem uma seção para relatórios de identidade e acesso. Ela lista estes números, que podem mudar:
- Qualquer requisição desse grupo: 122 requisições a cada 10 segundos por aplicativo em todos os locatários, e 5 requisições a cada 10 segundos por aplicativo e por locatário.
GET signInActivity: 10 requisições por minuto.
O seu script, com uma chamada a cada dez segundos, faz 6 chamadas por minuto, o que está abaixo de 10 no papel. A discussão não informa se outras tarefas do mesmo registro de aplicativo rodaram ao mesmo tempo. Essas tarefas dividiriam o orçamento, pois os limites se aplicam por aplicativo e por locatário. Esta é uma conclusão da tabela de limites da Learn, e não algo afirmado na discussão.
A Learn também diz que $select=signInActivity em List users pode provocar um throttling mais rigoroso do que as chamadas padrão. O conselho dela é:
- Use
$top=500, o tamanho máximo de página quando você selecionasignInActivity, em vez do padrão de 100. - Use
$filteremcreatedDateTimepara consultar intervalos de tempo menores. Comece com cerca de três dias de dados e reduza o intervalo se sofrer throttling. - A propriedade
signInActivityexige uma licença Microsoft Entra ID P1 ou P2 e a permissãoAuditLog.Read.All, segundo a página List users da Learn.
Se você precisa da atividade de login de muitos usuários, uma chamada de listagem como GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 retorna até 500 usuários por requisição. Isso significa muito menos requisições do que uma chamada por usuário. A página List users da Learn documenta essa requisição com signInActivity. Não é informado se ela também é mais leve do lado do serviço, então meça.
O moderador da discussão de maio sugeriu ler o signInActivity pelo endpoint beta. A referência atual v1.0 da Learn documenta o signInActivity, então você não deveria precisar do beta para isso. Verifique a propriedade no endpoint que você usa.
Passo 4: reduza o número de requisições
As melhores práticas da Learn apontam na mesma direção:
- Reduza o número de operações por requisição e a frequência das chamadas.
- Evite polling contínuo e varreduras regulares de coleções grandes. Use o rastreamento de alterações (consultas delta) e notificações de alteração quando existirem.
- Armazene em cache dados que mudam pouco, como as relações de gerente. Esse é um conselho do moderador da discussão de maio, não uma afirmação da Learn.
Passo 5: use o $batch com cuidado
O agrupamento de requisições (batching) pode reduzir as idas e voltas na rede. A página de JSON batching da Learn define um limite de 20 requisições individuais por lote. Ela também diz:
- Cada solicitação em um lote é avaliada separadamente em relação aos limites de throttling. Se uma delas exceder esses limites, essa solicitação falha com 429, enquanto o lote em si retorna 200. Várias solicitações podem sofrer throttling no mesmo lote.
- Tente novamente cada solicitação com falha usando o valor de
retry-afterno corpo da resposta correspondente a essa solicitação. O Learn diz que você pode reenviar todas elas em um novo lote após o maior valor deretry-after. - Se um SDK repete solicitações limitadas quando elas não estão em lote, as solicitações limitadas dentro de um lote não são repetidas automaticamente.
Portanto, o uso de lotes não elimina o limite. Ele apenas transfere a lógica de repetição para o seu código.
Etapa 6: planeje as leituras do SharePoint e do OneDrive
Para varreduras de drives, a página de throttling do SharePoint no Learn diz que o SharePoint Online retorna 429 ou 503 com um cabeçalho Retry-After, e que as solicitações limitadas contam para os limites. Ela lista o throttling nos escopos de usuário, locatário e aplicativo, e seus únicos limites por site são os de links anônimos e de egresso anônimo. Não planeje com base em uma cota separada por site. Outros pontos dessa página:
- O tráfego sem ID de aplicativo e sem string de User-Agent é considerado não identificado. O Learn diz que o tráfego bem identificado tem prioridade sobre o não identificado. Os formatos de User-Agent documentados são
ISV|CompanyName|AppName/VersioneNONISV|CompanyName|AppName/Version. - Uma consulta de item único custa 1 unidade de recurso, uma consulta de vários itens ou uma gravação custa 2, e operações de permissão, incluindo
$expand=permissions, custam 5. Evite a expansão de permissões em varreduras em massa. - O Learn recomenda o Microsoft Graph em vez de CSOM e REST sempre que possível, porque ele normalmente usa menos recursos.
A discussão de fevereiro também abordou o 410 Gone em consultas delta. A resposta ali disse que isso significa que o token delta não pode mais ser usado e que o cliente deve recomeçar com uma nova consulta delta inicial. Preveja isso em qualquer sincronização incremental.
Verifique
- Registre o número de respostas 429 e os valores de
Retry-Afterde uma execução, antes e depois das suas alterações. - Execute o script sozinho, sem nenhum outro processo usando o mesmo registro de aplicativo, para ver o efeito das suas próprias chamadas.
- Se o throttling continuar mesmo com backoff correto e menos chamadas, colete os cabeçalhos
request-idedatee abra um caso de suporte.
Limites
- A discussão de maio de 2026 não tem um resultado confirmado, e a resposta aceita ali foi gerada por IA. A orientação do Learn acima é a evidência usada aqui.
- A pergunta do autor sobre usuários sem bloco
signInActivitynunca foi respondida na discussão. O Learn também não descreve esse caso, então trate a ausência do bloco como desconhecida. O Learn informa quelastSuccessfulSignInDateTimenão é preenchido retroativamente antes de 1º de dezembro de 2023, então um valor vazio não prova que o usuário nunca fez login. - Os limites listados pelo Learn são marcados como sujeitos a alterações. Consulte a página atual antes de construir algo com base em um número.
Relacionados
Fontes
- Microsoft Learn: diretrizes de throttling do Microsoft Graph
- Microsoft Learn: limites de throttling específicos por serviço do Microsoft Graph
- Microsoft Learn: Combinar várias solicitações com lote JSON
- Microsoft Learn: Listar usuários
- Microsoft Learn: tipo de recurso signInActivity
- Microsoft Learn: Como evitar throttling ou bloqueio no SharePoint Online
- Microsoft Learn: Solucionar erros comuns no Microsoft Graph PowerShell
- Microsoft Q&A: Problema de throttling no endpoint users (maio de 2026)
- Microsoft Q&A: Comportamento de throttling do Microsoft Graph ao processar driveItems em paralelo (fevereiro de 2026)