API de cópia e movimentação do Microsoft 365 (CreateCopyJobs)

Importante

A API de Cópia e Movimentação do Microsoft Office SharePoint Online e Microsoft OneDrive substitui a API CreateCopyJob. A API CreateCopyJob foi preterida.

A API a seguir é baseada no uso do Modelo de Objeto do Cliente do Microsoft Office SharePoint Online (CSOM). Recomendamos o uso de pacotes NuGet ao fazer referência ao CSOM em sua solução.

Você pode encontrar a versão mais recente do pacote CSOM do SharePoint Online na biblioteca NuGet usando o ID Microsoft.SharePoint Online.CSOM.

Importante

Saiba mais sobre as limitações desta API antes de começar.

Método

CreateCopyJobs

Esse método cria uma nova cópia ou um trabalho de movimentação que permite copiar ou mover um arquivo ou pasta de um site no SharePoint, OneDrive ou Teams, para outro site.

Sintaxe

public List<SPCopyMigrationInfo> CreateCopyJobs(Uri[] exportObjectUris, Uri destinationUri, SPCopyMigrationOptions options)

Parâmetros

Parâmetro	Descrição
exportObjectUris	A URL de um arquivo ou pastas em uma lista que você deseja copiar ou mover
destinationUri	URL para o local de destino.

SPCopyMigrationOptions

public bool IsMoveMode { get; set; }

Importante

Por padrão, isso é definido para copiar. Para uma operação de movimento, defina este parâmetro como verdadeiro.

public bool IgnoreVersionHistory { get; set; }

Se não for especificado, o histórico da versão será ignorado e não movido para o destino.

public bool AllowSchemaMismatch { get; set; }

Isso permite que o item se mova mesmo se o destino tiver uma definição de esquema incompatível da lista de origem.

public bool AllowSmallerVersionLimitOnDestination { get; set; }

Isso permite que a movimentação ocorra se o arquivo de destino tiver uma versão mais antiga. Por padrão, não é permitido evitar a perda de dados.

public SPMigrationNameConflictBehavior NameConflictBehavior { get; set; }

Se ocorrer um conflito de nome no site de destino, o padrão relata uma falha.

public bool IncludeItemPermissions { get; set; }

Reservado apenas para uso interno.

public SPMoveAndShareFileInfo MoveAndShareFileInfo { get; set; }

Reservado apenas para uso interno.

public bool BypassSharedLock { get; set; }

Isso indica se um arquivo com um bloqueio de compartilhamento ainda pode ser movido em um trabalho de movimentação. Se você deseja mover um arquivo que está bloqueado, você precisa definir isso.

public string[] ClientEtags { get; set; }

Se definido e a eTag de origem não corresponder à eTag especificada, a cópia e a movimentação não ocorrerão. Se for deixado NULO, nenhuma verificação será realizada.

public bool MoveButKeepSource { get; set; }

Uma vez definida, esta operação de movimentação é semelhante à cópia. O arquivo será movido para o destino, mas o conteúdo de origem não será excluído. Se definido, isso fará uma cópia com o histórico da versão e preservará os metadados originais. Nenhuma exclusão de item de origem ocorre no final.

Observação

Não é como a cópia normal, que apenas copia a versão principal mais recente e não mantém todos os metadados.

public bool ExcludeChildren { get; set; }

Para esta operação, apenas a pasta de nível raiz da URL é copiada. As subpastas ou arquivos dentro da pasta não serão movidos ou copiados.

Saída

Parâmetro de saída.	Descrição
JobID/GUID	Retornar uma ID de trabalho exclusiva associado a essa leitura assíncrona
SourceListItemUniqueIds	Devolver a fonte
JobQueueUri	URL para acessar a fila do Azure usada para retornar notificação de processo de cópia e movimentação
EncryptionKey	Chave de criptografia AES256CBC usada para descriptografar mensagens da fila de trabalho/manifesto

public Uri JobQueueUri { get; set; }

Os recursos de relatório são iguais aos de CreateMigrationJob. O registro em log rastreia o status do createCopyJobs. Por padrão, as permissões e configurações da fila de blob são definidas como "acesso total". Ela fornece o status do trabalho da seguinte maneira: início, término do trabalho e informações de erro do trabalho.

Limitações

Atualmente, as seguintes limitações são:

O que	Limitação
Tamanho do arquivo	Limites do Microsoft Office SharePoint Online
Número de itens	Limites do Microsoft Office SharePoint Online
Tamanho total do trabalho	Limites do Microsoft Office SharePoint Online