Partager via


driveItem : copy

Espace de noms: microsoft.graph

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.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
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

Paramètres facultatifs de la requête

Cette méthode prend en charge le @microsoft.graph.conflictBehavior paramètre de requête pour personnaliser le comportement en cas de conflit.

Valeur Description
fail Le comportement par défaut consiste à signaler l’échec.
replace Remplacer l’élément existant sur le site cible.
rename Renommez l’élément.

Note:ConflictBehavior n’est pas pris en charge pour le consommateur OneDrive.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json. Obligatoire.

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.

Réponse

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

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.

Demande

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"
}

Réponse

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 quand 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 indique uniquement que l’opération de copie a été acceptée ou rejetée . par exemple, en raison du nom de fichier de destination déjà utilisé.