Get a DriveItem resource

  • Article

Récupérer les métadonnées d’un objet DriveItem dans un lecteur par son chemin d’accès dans le système de fichiers ou par son ID.

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.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Application Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Requête HTTP

GET /drives/{drive-id}/items/{item-id}
GET /drives/{drive-id}/root:/{item-path}
GET /groups/{group-id}/drive/items/{item-id}
GET /groups/{group-id}/drive/root:/{item-path}
GET /me/drive/items/{item-id}
GET /me/drive/root:/{item-path}
GET /sites/{siteId}/drive/items/{itemId}
GET /sites/{siteId}/drive/root:/{item-path}
GET /users/{userId}/drive/items/{itemId}
GET /users/{userId}/drive/root:/{item-path}

Paramètres facultatifs de la requête

Cette méthode prend en charge les paramètres de $expandrequête OData et $select pour personnaliser la réponse.

Vous pouvez utiliser le paramètre de chaîne de requête$expand pour inclure les enfants d’un élément dans le même appel que pour récupérer les métadonnées d’un élément si l’élément a une relation enfant.

En-têtes de demande facultatifs

Nom Valeur Description
if-none-match String Si cet en-tête de demande est inclus et que l’eTag (ou cTag) fourni correspond à l’identité actuelle sur le fichier, une réponse HTTP 304 Not Modified est renvoyée.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et la ressource DriveItem dans le corps de la réponse.

Exemple

Demande

Voici un exemple de la demande sur le dossier racine du lecteur OneDrive de l’utilisateur.

GET /me/drive/root

Réponse

Voici un exemple de réponse.

HTTP/1.1 200 OK
Content-type: application/json

{
  "createdBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "createdDateTime": "2016-03-21T20:01:37Z",
  "cTag": "\"c:{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},0\"",
  "eTag": "\"{86EB4C8E-D20D-46B9-AD41-23B8868DDA8A},1\"",
  "folder": { "childCount": 120 },
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "lastModifiedBy": {
      "user": {
          "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
          "displayName": "Ryan Gregg"
      }
  },
  "lastModifiedDateTime": "2016-03-21T20:01:37Z",
  "name": "OneDrive",
  "root": { },
  "size": 157286400,
  "webUrl": "https://contoso-my.sharepoint.com/personal/rgregg_contoso_com/Documents"
}

Requêtes HEAD

Dans la plupart des cas, une requête HEAD se comporte de la même façon qu’une requête GET.

Il existe quelques différences :

  1. Les requêtes HEAD renvoient uniquement les en-têtes de la requête GET correspondante. Il s’agit d’une pratique standard pour une réponse HEAD.
  2. Les requêtes HEAD ne fournissent pas automatiquement un dossier spécifique. En revanche, si un dossier spécifique est absent, une erreur 404 est renvoyée.

Dans cet exemple, vous pouvez constater que la demande de racine de votre OneDrive génère simplement 200 OK.

Requête HTTP

HEAD /drive/root
Accept: application/json

Réponse

HTTP/1.1 200 OK

Remarques

Pour plus d’informations sur la façon dont les erreurs sont renvoyées, voir Réponses d’erreur.