Introdução à API de Migração do SharePoint
A API de Migração do SharePoint importa conteúdos para o SharePoint em escala. Processa conteúdos e pacotes de manifesto como tarefas numa fila. A API fornece o estado e os registos do processo, facilitando a monitorização do progresso de cada tarefa de migração.
Utilize a API de Migração para migrar conteúdos de partilhas de ficheiros, do SharePoint Server e de outros serviços baseados na cloud.
Novidades
Julho de 2024
Começámos a impor a ligação HTTPS aos Contentores de Armazenamento de Blobs do Azure fornecidos pelo SharePoint ao adicionar um spr=https campo em tokens DE SAS. Esta imposição está totalmente em vigor a 21 de julho de 2024. Veja Utilizar Contentores de Armazenamento de Blobs do Azure e Filas do Azure com a API de Migração do SharePoint para obter detalhes.
Abril de 2024
Adicionámos novos campos em JobEnd eventos para indicar a contagem e bytes importados para ficheiros. Veja Eventos de migração na Fila do Azure para obter detalhes.
Janeiro de 2024
Reformatámos este documento para trazer clareza e erros corretos.
Descrição geral dos passos de migração
Inicie uma tarefa de migração com três passos. Verifique a documentação de orientação em cada um dos passos nesta secção.
Aprovisionar os contentores de destino e a fila
Utilize ProvisionMigrationContainers o método para aprovisionar os contentores. Veja Utilizar Contentores de Armazenamento de Blobs do Azure e Filas do Azure com a API de Migração para obter detalhes. Também pode utilizar os seus próprios contentores e filas, se necessário.
Preparar o conteúdo
Empacote os conteúdos no formato definido e carregue-os para os Contentores de Armazenamento de Blobs do Azure como o pacote de conteúdos.
Verifique o Pacote de conteúdo para ver os requisitos detalhados.
Criar os ficheiros de manifesto
Com base no conteúdo, crie ficheiros de manifesto no formato XML e carregue-os para Os Contentores de Armazenamento de Blobs do Azure como o pacote de manifesto.
Verifique os ficheiros do Manifesto para ver os requisitos detalhados.
Utilizar a API de Migração para iniciar a migração e obter o estado
CreateMigrationJob O método cria uma tarefa de migração, que é em fila de espera para processamento. A API de Migração gere a fila e devolve o estado e os registos. Utilize o CreateMigrationEncrypted método para migrar conteúdos encriptados. Veja Referência da API de Migração do SharePoint para obter detalhes.
Após a criação de uma nova tarefa de migração, a API de Migração devolve o ID da Tarefa. Controle o estado da importação com GetMigrationJobStatus o método, se necessário, com a Fila do Azure fornecida.
A API de Migração gera registos no contentor de manifesto. Verifique as entradas de registo para obter os resultados da migração.
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 utilizador final. Para alocar corretamente recursos com a nossa capacidade elástica, utilize apenas a autenticação baseada em aplicações na sua solução de migração.
Não utilize o modo de utilizador na sua solução de migração. A execução da migração no modo de utilizador aciona um aumento da limitação, o que resulta num fraco desempenho.
Para saber mais sobre como registar um ID de aplicação e como implementar a autenticação baseada em aplicações, veja Como registar um ID de aplicação e a documentação de orientação do Microsoft Graph Auth.
Permissões de ID do Microsoft Entra
O ID do Microsoft Entra fornece dois tipos de permissão: Permissões Delegadas e Permissões de Aplicação. Verifique permissões e consentimento no ponto final 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 do utilizador final com sessão iniciada e presença, utilize a permissão Delegada.
Para ferramentas de migração baseadas no serviço que são executadas sem um utilizador com sessão iniciada presente, como aplicações que são executadas como serviços em segundo plano, utilize a Permissão da aplicação.
IDs da Aplicação
Pode optar por partilhar um único ID de Aplicação para abranger várias soluções de migração criadas ou criar um ID de Aplicação individual para cada um dos produtos. Certifique-se de que regista os IDs da Aplicação. A partilha de IDs de Aplicações não afeta o desempenho nem a limitação.
Manter o Site SharePoint de destino desativado
Para evitar problemas de migração, desative o site de destino dos utilizadores até à conclusão da migração. A origem pode permanecer ativa, permitindo a leitura e escrita para manter a produtividade. Mude os utilizadores para os novos sites de destino do SharePoint após a conclusão da migração.
Desempenho
A API de Migração processa tarefas através de um mecanismo de fila com definições de gestão de cargas de trabalho pré-configuradas. A API de Migração processa as tarefas com base no melhor esforço, sem o Contrato de Nível de Serviço (SLA) ou o desempenho garantido.
Otimizar o desempenho da migração
Para garantir um desempenho ideal para os seus projetos de migração, é importante planear cuidadosamente, especialmente ao lidar com migrações em grande escala. Para obter mais informações sobre como estimar períodos de tempo e otimizar o desempenho, veja o nosso guia de desempenho.
Estou a ver mensagens de limitação
Para garantir boas experiências de utilizador para todos os clientes do Microsoft 365, o SharePoint utiliza a limitação para proteger a infraestrutura do SharePoint. Evite ser limitado ao seguir as orientações de limitação.
Artigos especiais
Migrar eventos de partilha de ficheiros e pastas
Consulte o artigo Partilhar eventos para obter instruções ao migrar metadados de eventos partilhados com ficheiros e pastas.
Web Parts
Utilize a DLL do serializador de Peças Web da Ferramenta de Migração do SharePoint (SPMT) para migrar Peças Web para o SharePoint. Consulte Migrar Peças Web para obter instruções.