Copiar un objeto DriveItem

Artículo
04/08/2023

Crea de forma asincrónica una copia de un objeto driveItem (incluidos los elementos secundarios), en un nuevo elemento primario o con un nuevo nombre.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft)	Files.ReadWrite, Files.ReadWrite.All
Aplicación	Files.ReadWrite.All, Sites.ReadWrite.All

Solicitud HTTP

POST /drives/{driveId}/items/{itemId}/copy
POST /groups/{groupId}/drive/items/{itemId}/copy
POST /me/drive/items/{item-id}/copy
POST /sites/{siteId}/drive/items/{itemId}/copy
POST /users/{userId}/drive/items/{itemId}/copy

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.

Nombre	Valor	Descripción
parentReference	ItemReference	Opcional. Referencia al elemento primario en que se creará la copia.
name	string	Opcional. El nuevo nombre de la copia. Si no se proporciona, se usará el mismo nombre que el original.

Nota: El valor parentReference debe incluir los parámetros driveId y id para la carpeta de destino.

Ejemplo

Este ejemplo copia un archivo identificado por {item-id} en una carpeta identificada con un valor driveId y id. La nueva copia del archivo se denominará contoso plan (copy).txt.

POST /me/drive/items/{item-id}/copy
Content-Type: application/json

{
  "parentReference": {
    "driveId": "6F7D00BF-FC4D-4E62-9769-6AEA81F3A21B",
    "id": "DCD0D3AD-8989-4F23-A5A2-2C086050513F"
  },
  "name": "contoso plan (copy).txt"
}

Respuesta

Devuelve detalles sobre cómo supervisar el progreso de la copia tras aceptar la solicitud.

HTTP/1.1 202 Accepted
Location: https://contoso.sharepoint.com/_api/v2.0/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

El valor del encabezado Location proporciona una dirección URL para un servicio que devolverá el estado actual de la operación de copia. Puede usar esta información para determinar cuándo ha finalizado la copia.

Comentarios

En muchos casos, la operación de copia se realiza de forma asincrónica. La respuesta de la API solo indicará que la operación de copia se ha aceptado o rechazado, debido a que el nombre de archivo de destino ya está en uso.