Lote Grande de Migração é Limitado Durante a Noite: Solução para OneDrive for Business

Quando você executa um lote grande de migração durante a noite para o OneDrive for Business, o processo pode ficar extremamente lento ou parar completamente pela manhã. Isso acontece porque o Microsoft 365 aplica limitação no lado do serviço para proteger a estabilidade do sistema quando as solicitações de migração excedem certos limites. A limitação restringe o número de chamadas de API que sua ferramenta de migração pode fazer por minuto, fazendo com que o progresso pare. Este artigo explica por que os lotes noturnos são limitados e fornece etapas específicas para reduzir o impacto da limitação e manter sua migração em andamento.

Por que os Lotes de Migração Noturnos São Limitados

O Microsoft 365 limita o tráfego de migração para evitar que um único locatário sobrecarregue os recursos compartilhados do serviço. O limite padrão de limitação para chamadas de API de migração do OneDrive é de 150 solicitações por minuto por aplicativo. Quando seu lote excede essa taxa, o serviço retorna erros HTTP 429 ou atrasa as respostas. Lotes noturnos são especialmente vulneráveis porque muitas organizações agendam migrações grandes durante janelas de baixo uso. Sem um ritmo cuidadoso, a explosão inicial de solicitações aciona a limitação imediatamente, e a ferramenta de migração pode não se recuperar até o dia seguinte.

O mecanismo de limitação usa uma janela deslizante. Se você enviar 200 solicitações em um minuto, o serviço registra o excesso e continua aplicando limites pelos próximos minutos. Esse efeito cascata pode parar um lote por horas. Além disso, algumas ferramentas de migração não lidam automaticamente com respostas de limitação. Elas continuam tentando novamente em velocidade máxima, o que piora o problema. Entender essa causa ajuda você a aplicar a correção correta: diminuir a taxa de solicitações em vez de aumentá-la.

Etapas para Corrigir a Limitação em Lotes Grandes de Migração do OneDrive

Estas etapas se aplicam a qualquer ferramenta de migração que use a API do SharePoint Online ou OneDrive, incluindo scripts nativos do PowerShell, ShareGate, Mover e ferramentas de terceiros. Execute cada etapa na ordem mostrada.

1. Verifique o status atual da limitação no centro de administração do Microsoft 365
   Faça login no centro de administração do Microsoft 365 em admin.microsoft.com. Vá para Configurações > Configurações da organização > Migração. Procure a seção Limitação. Observe o limite padrão de 150 solicitações por minuto. Se seu locatário tiver uma solicitação de suporte de migração, você pode ver um limite temporário maior. Não confie nisso sem confirmação do Suporte da Microsoft.
2. Solicite um aumento de limite de migração ao Suporte da Microsoft
   Abra um tíquete de suporte no centro de administração do Microsoft 365. Explique que você está executando um lote grande de migração do OneDrive durante a noite e precisa de um aumento temporário de limite. Solicite um limite de 500 a 1000 solicitações por minuto para um intervalo de datas específico. Forneça os horários exatos de início e término da janela do lote. A Microsoft geralmente concede esses aumentos por 72 horas ou menos. Aguarde a confirmação antes de prosseguir.
3. Configure sua ferramenta de migração para usar backoff exponencial
   Em ferramentas como o ShareGate, abra as configurações de migração. Encontre a seção Política de repetição ou Backoff. Ative Backoff exponencial com uma espera inicial de 5 segundos e uma espera máxima de 60 segundos. Isso faz com que a ferramenta pause e tente novamente quando receber um erro de limitação 429. Para o Mover, defina o Atraso de repetição para 10 segundos e ative Repetição consciente de limitação. Salve as configurações.
4. Ajuste o tamanho do lote e o paralelismo na ferramenta de migração
   Reduza o número de itens migrados simultaneamente. No ShareGate, defina Máximo de operações simultâneas para 10 em vez do padrão 50. No Mover, defina Máximo de transferências simultâneas para 5. Para scripts do PowerShell, limite o número de trabalhos paralelos a 5. Isso reduz diretamente a taxa de solicitações por minuto.
5. Adicione lógica de ritmo a scripts personalizados do PowerShell
   Se você usa um script personalizado, insira um comando Start-Sleep após cada chamada de API. Use um atraso aleatório entre 200 e 500 milissegundos para evitar explosões sincronizadas. Exemplo: Start-Sleep -Milliseconds (Get-Random -Minimum 200 -Maximum 500). Adicione também tratamento de erros que capture respostas 429 e espere 30 segundos antes de tentar novamente essa solicitação específica.
6. Execute um lote de teste antes da janela noturna completa
   Inicie um pequeno teste de 50 usuários 24 horas antes do lote principal. Monitore os Relatórios de migração no centro de administração. Verifique se há erros 429 ou atrasos. Se o teste for concluído sem limitação, prossiga com o lote completo. Se ocorrer limitação, reduza ainda mais o paralelismo e repita o teste.
7. Monitore a migração em tempo real
   Durante o lote noturno, abra o Painel de migração no centro de administração. Observe o gráfico de Solicitações por minuto. Se ele se aproximar de 150, pause o lote manualmente por 10 minutos. Retome após o gráfico cair abaixo de 100. Algumas ferramentas suportam pausa automática com base nos tempos de resposta da API. Ative esse recurso se disponível.

Se a Limitação Persistir Após Aplicar as Correções

Mesmo após seguir as etapas acima, alguns lotes de migração ainda podem sofrer limitação. Esta seção aborda padrões de falha adicionais e suas soluções específicas.

A ferramenta de migração mostra erros 429 repetidos apesar das configurações de backoff

Se sua ferramenta ainda mostrar erros 429, a configuração de backoff pode não estar ativa. Verifique se a política de repetição é aplicada ao endpoint de migração correto. Algumas ferramentas têm configurações separadas para SharePoint e OneDrive. Confirme também se a versão da ferramenta suporta backoff exponencial. Atualize para a versão mais recente, se necessário. Como alternativa, reduza o máximo de operações simultâneas para 3 e execute o lote novamente.

A limitação ocorre apenas para tipos ou tamanhos de arquivo específicos

O OneDrive limita de forma diferente para arquivos grandes acima de 250 MB. Se seu lote incluir muitos arquivos grandes, a ferramenta de migração pode atingir um limite de limitação por arquivo. Separe arquivos grandes em lotes distintos ou use o aplicativo de sincronização do OneDrive para esses arquivos em vez da API de migração. Para arquivos acima de 15 GB, use a Ferramenta de Migração do SharePoint, que lida com arquivos grandes de forma mais eficiente.

A migração para completamente em um determinado horário todas as noites

Esse padrão indica uma janela de manutenção em todo o locatário. O Microsoft 365 realiza manutenção periódica que pode bloquear chamadas de API de migração por 15 a 30 minutos. Verifique o painel Saúde do serviço no centro de administração para eventos de manutenção agendados. Se houver manutenção agendada, desloque seu lote noturno para uma janela diferente ou divida-o em dois lotes menores antes e depois do período de manutenção.

Solicitação de Aumento de Limite vs. Ritmo Baseado em Ferramenta: Principais Diferenças

Item	Solicitar Aumento de Limite da Microsoft	Ritmo Baseado em Ferramenta (Backoff e Paralelismo)
Descrição	Um aumento temporário do limite de solicitações de API por minuto concedido pelo Suporte da Microsoft	Alterações de configuração na ferramenta de migração para diminuir as solicitações e lidar automaticamente com respostas de limitação
Tempo para implementar	4 a 24 horas dependendo do tempo de resposta do suporte	15 minutos para a maioria das ferramentas
Duração do efeito	Limitada ao intervalo de datas especificado, geralmente 72 horas	Permanente para a configuração da ferramenta
Risco de uso excessivo	Baixo se o aumento estiver dentro das diretrizes da Microsoft	Nenhum, pois a ferramenta permanece abaixo do limite padrão
Melhor para	Lotes grandes únicos que excedem 1000 usuários	Migrações recorrentes ou lotes menores com menos de 500 usuários

Agora você pode executar lotes grandes de migração do OneDrive durante a noite sem parar devido à limitação. Comece solicitando um aumento temporário de limite ao Suporte da Microsoft se seu lote exceder 1000 usuários. Em seguida, configure sua ferramenta de migração com backoff exponencial e paralelismo reduzido. Para scripts personalizados do PowerShell, adicione intervalos de suspensão entre as chamadas de API. Uma dica avançada: Use o cmdlet Get-SPOMigrationJobProgress para monitorar o status do trabalho e pausar automaticamente o lote quando a taxa de solicitações exceder 120 por minuto.