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é.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour