Compartir a través de


driveItem: copiar

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.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
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 de @microsoft.graph.conflictBehavior consulta para personalizar el comportamiento cuando se produce un conflicto.

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

Nota:ConflictBehavior no se admite para el consumidor de OneDrive.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

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 https://graph.microsoft.com/v1.0/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 terminado 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 se ha aceptado o rechazado la operación de copia; por ejemplo, debido a que el nombre de archivo de destino ya está en uso.