Charger ou remplacer le contenu d’un objet DriveItem

  • Article

L’API de chargement simple vous permet de fournir le contenu d’un nouveau fichier ou de mettre à jour le contenu d’un fichier existant dans un seul appel API. Cette méthode prend en charge uniquement les fichiers jusqu’à 4 Mo.

Pour télécharger des fichiers volumineux, voir Télécharger des fichiers volumineux avec une session de téléchargement.

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 (pour remplacer un élément existant)

PUT /drives/{drive-id}/items/{item-id}/content
PUT /groups/{group-id}/drive/items/{item-id}/content
PUT /me/drive/items/{item-id}/content
PUT /sites/{site-id}/drive/items/{item-id}/content
PUT /users/{user-id}/drive/items/{item-id}/content

Requête HTTP (pour charger un nouveau fichier)

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drives/{drive-id}/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

Corps de la demande

Le contenu du corps de la demande doit être le flux binaire du fichier à télécharger.

Réponse

Si elle réussit, cette méthode renvoie une ressource driveItem dans le corps de la réponse pour le fichier créé ou mis à jour.

Exemple (charger un nouveau fichier)

Cet exemple montre comment charger la chaîne « Le contenu du fichier va ici ». dans un fichier du lecteur de l’utilisateur connecté sous FolderA nommé FileB.txt.

PUT /me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

Réponse

Si elle réussit, cette méthode renvoie une ressource driveItem dans le corps de la réponse pour le fichier nouvellement créé.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Exemple (mise à jour d’un fichier existant)

Cet exemple remplace le contenu d’un fichier avec un ID connu.

PUT /me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

Réponse

Si elle réussit, cette méthode renvoie une ressource driveItem dans le corps de la réponse pour le fichier nouvellement créé.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Remarques

Types de fichiers bloqués

SharePoint Server 2016 bloque le chargement vers le serveur de plusieurs extensions de fichier.

  • .ashx - Fichier de gestionnaire web ASP.NET
  • .asmx - Fichier source des services web ASP.NET
  • .json - Fichier JavaScript Object Notation
  • .soap - Fichier SOAP (Simple Object Access Protocol)
  • .svc - Fichier du service Windows Communication Foundation (WCF)
  • .xamlx - Fichier du service de workflow Visual Studio

Pour plus d’informations sur les extensions de fichiers bloquées, consultez les types de fichiers qui ne peuvent pas être ajoutés à une liste ou bibliothèque.

Comportement de résolution des conflits

Par défaut, l’API remplace un élément existant portant le même nom. Pour personnaliser le comportement de résolution des conflits, ajoutez un paramètre de requête nommé @microsoft.graph.conflictBehavior avec les valeurs fail, replace ou rename à la requête.

Réponses d’erreur

Consultez la rubrique Réponses d’erreur pour plus de détails sur la façon dont les erreurs sont renvoyées.