API de Copiar y mover de Microsoft 365 (CreateCopyJobs)

Importante

La API de Copiar y mover de SharePoint y OneDrive reemplaza la API de CreateCopyJob. La API CreateCopyJob está en desuso.

La API siguiente se basa en el uso del modelo de objetos del lado cliente (CSOM) de SharePoint. Se recomienda usar paquetes NuGet cuando se hace referencia a CSOM en la solución.

Puede encontrar la versión más reciente del paquete CSOM de SharePoint Online de la biblioteca de NuGet usando el Id. Microsoft.SharePointOnline.CSOM.

Importante

Obtenga más información sobre las limitaciones de esta API antes de empezar.

Método

CreateCopyJobs

Este método crea un nuevo trabajo de copia o traslado que le permite copiar o mover un archivo o carpeta de un sitio de SharePoint, OneDrive o Teams a otro sitio.

Sintaxis

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

Parámetros

Parámetro	Descripción
exportObjectUris	La dirección URL de un archivo o carpeta en una lista que quiera copiar o mover.
destinationUri	Dirección URL de la ubicación de destino.

SPCopyMigrationOptions

public bool IsMoveMode { get; set; }

Importante

De forma predeterminada, este es el conjunto para copiar. En el caso de una operación de movimiento, establezca este parámetro en true.

public bool IgnoreVersionHistory { get; set; }

Si no se especifica, el historial de versiones se ignorará y no se moverá al destino.

public bool AllowSchemaMismatch { get; set; }

Esto permite que el elemento se mueva incluso si el destino tiene una definición de esquema que no coincide con la lista de origen.

public bool AllowSmallerVersionLimitOnDestination { get; set; }

Esto permite que el desplazamiento se realice si el archivo de destino tiene una versión anterior. De forma predeterminada, no se permite para evitar la pérdida de datos.

public SPMigrationNameConflictBehavior NameConflictBehavior { get; set; }

Si se produce un conflicto de nombres en el sitio de destino, el valor predeterminado informa de un error.

public bool IncludeItemPermissions { get; set; }

Reservado solo para uso interno.

public SPMoveAndShareFileInfo MoveAndShareFileInfo { get; set; }

Reservado solo para uso interno.

public bool BypassSharedLock { get; set; }

Esto indica si un archivo con un bloqueo de uso compartido aún se puede mover en un trabajo de movimiento. Si quiere mover un archivo que está bloqueado, debe establecer esta configuración.

public string[] ClientEtags { get; set; }

Si se establece y la etiqueta electrónica de origen no coincide con la etiqueta electrónica especificada, la copia y el movimiento no se llevarán a cabo. Si se deja en NULL, no se realizará ninguna comprobación.

public bool MoveButKeepSource { get; set; }

Una vez establecida, la operación de movimiento es similar a la de copiar. El archivo se moverá al destino, pero no se eliminará el contenido de origen. Si se establece, realizará una copia con el historial de versiones y conservará los metadatos originales. Ninguna eliminación de elemento de origen se produce al final.

Nota:

Esto no es como la copia normal, que solo copia la versión principal más reciente y no mantiene todos los metadatos.

public bool ExcludeChildren { get; set; }

Para esta operación, solo se copia la carpeta del nivel raíz de la dirección URL. Las subcarpetas o los archivos de la carpeta no se moverán ni copiarán.

Salida

Parámetro de salida	Descripción
JobID/GUID	Devuelve un identificador de trabajo único asociado a esta solicitud de lectura asincrónica.
SourceListItemUniqueIds	Devuelve la fuente.
JobQueueUri	Dirección URL de acceso a la cola de Azure que se usa para devolver la notificación del proceso de copiar y mover.
EncryptionKey	Clave de cifrado AES256CBC que se usa para descifrar mensajes de la cola de trabajos y manifiestos.

public Uri JobQueueUri { get; set; }

Las características de la creación de informes son las mismas que las de CreateMigrationJob. El registro realiza un seguimiento del estado de la createCopyJobs. De forma predeterminada, la configuración y los permisos de cola de blob se establecen en "acceso total”. Proporciona el estado del trabajo de la siguiente manera: inicio del trabajo, finalización del trabajo e información del error del trabajo.

Limitaciones

Actualmente se aplican las limitaciones siguientes:

Qué	Limitación
Tamaño de archivos	Límites de SharePoint
Número de elementos	Límites de SharePoint
Tamaño total del trabajo	Límites de SharePoint