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.