driveItem: copy

Espacio de nombres: microsoft.graph

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 siguientes permisos 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

Parámetros de consulta opcionales

Este método admite el parámetro @microsoft.graph.conflictBehavior de consulta para personalizar el comportamiento cuando se produce un conflicto.

Valor Descripción
fail El comportamiento predeterminado es notificar el error.
replace Sobrescribir el elemento existente en el sitio de destino.
rename Cambie el nombre del elemento.

Nota: El conflictBehavior no es compatible con OneDrive Consumer.

Cuerpo de la 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.

Respuesta

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

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.

Solicitud

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

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 aceptó o rechazó; por ejemplo, debido a que el nombre de archivo de destino ya está en uso.