Copier un objet DriveItem

Article
04/08/2023

Crée de manière asynchrone une copie d’un élément driveItem (y compris les enfants) sous un nouvel élément parent ou avec un nouveau nom.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel)	Files.ReadWrite, Files.ReadWrite.All
Application	Files.ReadWrite.All, Sites.ReadWrite.All

Requête 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

Corps de la demande

Dans le corps de la demande, fournissez un objet JSON avec les paramètres suivants.

Nom	Valeur	Description
parentReference	ItemReference	Facultatif. Référence à l’élément parent dans lequel la copie sera créée.
name	string	Facultatif. Nouveau nom de la copie. S’il n’est pas fourni, le même nom sera utilisé en tant qu’original.

Remarque : l’objet parentReference doit inclure les paramètres driveId et id pour le dossier cible.

Exemple

Cet exemple copie un fichier défini par la valeur {item-id} dans un dossier défini par les valeurs driveId et id. La nouvelle copie du fichier sera nommée 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"
}

Réponse

Renvoie des détails sur la manière de surveiller la progression de la copie, lorsque la demande est acceptée.

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

La valeur de l’en-tête Location fournit une URL pour un service qui renvoie l’état actuel de l’opération de copie. Vous pouvez utiliser ces informations pour déterminer le moment où la copie est terminée.

Remarques

Dans de nombreux cas, l’action de copie est exécutée de façon asynchrone. La réponse de l’API indiquera uniquement que l’opération de copie a été acceptée ou refusée, par exemple, en raison du nom de fichier de destination déjà en cours d’utilisation.

Partager via