Introdução à API de Migração do SharePoint

A API de Migração do SharePoint importa conteúdo para o SharePoint em escala. Ele processa pacotes de conteúdo e manifesto como trabalhos em uma fila. A API fornece o status e os logs do processo, facilitando o monitoramento do progresso de cada trabalho de migração.

Use a API de Migração para migrar conteúdo de compartilhamentos de arquivos, do SharePoint Server e de outros serviços baseados em nuvem.

Novidades

Dezembro de 2024

Aplicamos cota nos itens Compartilhar Comigo por usuário. Verifique a cota de eventos ShareWithMe para obter mais detalhes.

Novembro de 2024

Habilitamos o registro em log de todos os eventos no nível de arquivo durante a migração, como a exclusão de arquivos, para dar suporte à auditoria.

Julho de 2024

Começamos a impor conexões HTTPS aos Contêineres do Armazenamento de Blobs do Azure fornecidos pelo SharePoint adicionando um spr=https campo em tokens SAS. Essa aplicação entrará em vigor em 21 de julho de 2024. Confira Usar contêineres e Azure Filas Armazenamento de Blobs do Azure com a API de migração do SharePoint para obter detalhes.

Abril de 2024

Adicionamos novos campos em JobEnd eventos para indicar a contagem e os bytes importados para arquivos. Verifique os eventos de migração na fila do Azure para obter detalhes.

Janeiro de 2024

Reformatamos este documento para trazer maior clareza e corrigir erros.

Visão geral das etapas de migração

Inicie um trabalho de migração com três etapas. Verifique as diretrizes em cada uma das etapas nesta seção.

Provisionar os contêineres de destino e a fila

Use o ProvisionMigrationContainers método para provisionar os contêineres. Consulte Usar Armazenamento de Blobs do Azure Contêineres e Azure Filas com a API de Migração para obter detalhes. Você também pode usar seus próprios contêineres e filas, se necessário.

Preparar o conteúdo

Empacote o conteúdo no formato definido e carregue-o no Armazenamento de Blobs do Azure Containers como o pacote de conteúdo.

Verifique Pacote de conteúdo para ver os requisitos detalhados.

Crie os arquivos de manifesto

Com base no conteúdo, crie arquivos de manifesto no formato XML e carregue-os no Armazenamento de Blobs do Azure como o pacote de manifesto.

Verifique os arquivos de manifesto para ver os requisitos detalhados.

Use a API de migração para iniciar a migração e obter o status

O CreateMigrationJob método cria um trabalho de migração, que é enfileirado para processamento. A API de migração gerencia a fila e retorna status e logs. Use o CreateMigrationEncrypted método para migrar conteúdo criptografado. Verifique a Referência da API de Migração do SharePoint para obter detalhes.

Após a criação de um novo trabalho de migração, a API de Migração retorna a ID do trabalho. Acompanhe o status da importação com a API GetMigrationJobProgress.

A API de migração gera logs no contêiner de manifesto. Verifique as entradas de log para ver os resultados da migração.

A API de migração também gera logs de atividades em nível de arquivo executadas pela migração. As atividades de nível de arquivo com suporte incluem FileUploaded, FileDeleted, FileRenamed, FileMoved. Verifique o Centro de Administração do M365 para obter detalhes da atividade quando necessário.

Prática Recomendada

Usar a autenticação baseada em aplicativo

A migração gera carga de trabalho para o back-end do SharePoint de forma diferente do tráfego gerado pelo usuário final. Para alocar recursos corretamente com nossa funcionalidade elástica, use apenas a autenticação baseada em aplicativo em sua solução de migração.

Não use o modo de usuário em sua solução de migração. A execução da migração no modo de usuário aciona uma limitação maior, resultando em baixo desempenho.

Para saber mais sobre como registrar uma ID do aplicativo e como implementar a autenticação baseada em aplicativo, marque Como registrar uma ID do aplicativo e as diretrizes de Autenticação do Microsoft Graph.

Permissões do Microsoft Entra ID

O Microsoft Entra ID fornece dois tipos de permissão: Permissão Delegada e Permissões de Aplicativo. Verifique Permissões e consentimento no ponto de extremidade do Azure Active Directory v1.0 para obter detalhes.

Para cenários de migração do SharePoint e do OneDrive, siga a especificação de permissão do Microsoft Entra ID.

Para ferramentas de migração que dependem da entrada e presença do usuário final, use a permissão delegada.

Para ferramentas de migração baseadas em serviço executadas sem a presença de um usuário conectado, como aplicativos executados como serviços em segundo plano, use a permissão Aplicativo.

IDs de aplicativo

Você pode optar por compartilhar uma única ID de aplicativo para cobrir várias soluções de migração criadas ou criar uma ID de aplicativo individual para cada um dos produtos. Certifique-se de registrar IDs de aplicativo. O compartilhamento de IDs de Aplicativos não afeta o desempenho ou a limitação.

Manter o Site do SharePoint de destino não ativado

Para evitar problemas de migração, desative o site de destino para os usuários até que a migração seja concluída. A fonte pode permanecer ativa, permitindo o acesso de leitura e gravação para manter a produtividade. Alternar usuários para os novos sites de destino do SharePoint após a conclusão da migração.

Desempenho

A API de migração processa trabalhos por meio de um mecanismo de fila com configurações de gerenciamento de carga de trabalho predefinidas. A API de migração processa os trabalhos com base no melhor esforço, sem Acordo de Nível de Serviço (SLA) ou desempenho garantido.

Otimizar o desempenho da migração

Para garantir o desempenho ideal para seus projetos de migração, é importante planejar cuidadosamente, especialmente ao lidar com migrações em grande escala. Para obter mais informações sobre como estimar intervalos de tempo e otimizar o desempenho, consulte nosso guia de desempenho.

Estou vendo mensagens de limitação

Para garantir boas experiências de usuário para todos os clientes do Microsoft 365, o SharePoint usa limitação para proteger a infraestrutura do SharePoint. Evite ser limitado seguindo as orientações de limitação.

Artigos especiais

Migrando eventos de compartilhamento de arquivos e pastas

Consulte o artigo Eventos de compartilhamento para obter instruções ao migrar metadados de eventos compartilhados com arquivos e pastas.

Web Parts

Use a DLL do serializador de Web Part da SPMT (Ferramenta de Migração do SharePoint) para migrar Web Parts para o SharePoint. Consulte Web Parts de Migração para obter instruções.