Obtenir un lecteur
Récupérez les propriétés et les relations d’une ressource Drive.
Une ressource Drive est le conteneur de niveau supérieur pour un système de fichiers, tel que les bibliothèques de documents OneDrive ou SharePoint.
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 |
Obtenir le lecteur OneDrive de l’utilisateur actuel
Le lecteur de l’utilisateur connecté (lors de l’utilisation de l’authentification déléguée) est accessible à partir du singleton me.
Si le lecteur OneDrive d’un utilisateur n’est pas approvisionné, mais que l’utilisateur dispose d’une licence qui lui permet d’utiliser OneDrive, cette demande permettra de configurer automatiquement le lecteur de l’utilisateur, lorsque l’authentification déléguée est utilisée.
Requête HTTP
GET /me/drive
Lorsque vous utilisez le point de terminaison de service OneDrive direct, quittez le segment /me.
GET /drive
Obtenir le lecteur OneDrive d’un utilisateur
Pour accéder au lecteur OneDrive ou OneDrive Entreprise d’un utilisateur, votre application doit demander la relation drive sur la ressource User.
Si le lecteur OneDrive d’un utilisateur n’est pas approvisionné, mais que l’utilisateur dispose d’une licence qui lui permet d’utiliser OneDrive, cette demande permettra de configurer automatiquement le lecteur de l’utilisateur, lorsque l’authentification déléguée est utilisée.
Requête HTTP
GET /users/{idOrUserPrincipalName}/drive
Paramètres du chemin d’accès
| Nom du paramètre | Valeur | Description |
|---|---|---|
| idOrUserPrincipalName | string | Obligatoire. Identificateur de l’objet de l’utilisateur propriétaire du lecteur OneDrive. |
Obtenir la bibliothèque de documents associée à un groupe
Pour accéder à la bibliothèque de documents par défaut d’un groupe, votre application demande la relation drive sur la ressource Group.
Requête HTTP
GET /groups/{groupId}/drive
Paramètres du chemin d’accès
| Nom du paramètre | Valeur | Description |
|---|---|---|
| groupId | string | Obligatoire. Identificateur du groupe propriétaire de la bibliothèque de documents. |
Obtenir la bibliothèque de documents pour un site
Pour accéder à la bibliothèque de documents par défaut d’un site, votre application demande la relation drive sur la ressource Site.
Requête HTTP
GET /sites/{siteId}/drive
Paramètres du chemin d’accès
| Nom du paramètre | Valeur | Description |
|---|---|---|
| siteId | string | Obligatoire. Identificateur du site contenant la bibliothèque de documents. |
Obtenir un lecteur par le biais de son ID
Si vous disposez de l’identificateur unique d’un lecteur, vous pouvez y accéder directement à partir de la collection de lecteurs de niveau supérieur.
Requête HTTP
GET /drives/{drive-id}
Paramètres du chemin d’accès
| Nom du paramètre | Valeur | Description |
|---|---|---|
| driveId | string | Obligatoire. Identificateur du lecteur demandé. |
Paramètres facultatifs de la requête
Ces méthodes prennent en charge le paramètre de requête $select pour formuler la réponse.
Réponse HTTP
Chacune de ces méthodes renvoie une ressource Drive du lecteur correspondant dans le corps de la réponse.
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7",
"driveType": "business",
"owner": {
"user": {
"id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
"displayName": "Ryan Gregg"
}
},
"quota": {
"deleted": 256938,
"fileCount": 2,
"remaining": 1099447353539,
"state": "normal",
"total": 1099511627776
}
}
Codes de réponse d’erreur
Si le lecteur n’existe pas et qu’il ne peut pas être approvisionné automatiquement (lorsque l’authentification déléguée est utilisée), une réponse HTTP 404 est renvoyée.