Obtenir un lecteurGet Drive

Récupérez les propriétés et les relations d’une ressource Drive.Retrieve the properties and relationships of a Drive resource.

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.A Drive is the top-level container for a file system, such as OneDrive or SharePoint document libraries.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
ApplicationApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Obtenir le lecteur OneDrive de l’utilisateur actuelGet current user's OneDrive

Le lecteur de l’utilisateur connecté (lors de l’utilisation de l’authentification déléguée) est accessible à partir du singleton me.The signed in user's drive (when using delegated authentication) can be accessed from the me singleton.

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.If a user's OneDrive is not provisioned but the user has a license to use OneDrive, this request will automatically provision the user's drive, when using delegated authentication.

Requête HTTPHTTP request

GET /me/drive

Exemple de code SDKSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var drive = await graphClient.Me.Drive
    .Request()
    .GetAsync();

Pour plus d’informations sur la façon d' Ajouter le kit de développement logiciel (SDK) à votre projet et de créer une instance authProvider , consultez la documentation SDK .Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Obtenir le lecteur OneDrive d’un utilisateurGet a user's OneDrive

Pour accéder au lecteur OneDrive ou OneDrive Entreprise d’un utilisateur, votre application doit demander la relation drive sur la ressource User.To access a user's OneDrive or OneDrive for Business, your app must request the drive relationship on the User resource.

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.If a user's OneDrive is not provisioned but the user has a license to use OneDrive, this request will automatically provision the user's drive, when using delegated authentication.

Requête HTTPHTTP request

GET /users/{idOrUserPrincipalName}/drive

Exemple de code SDKSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var drive = await graphClient.Users["{idOrUserPrincipalName}"].Drive
    .Request()
    .GetAsync();

Pour plus d’informations sur la façon d' Ajouter le kit de développement logiciel (SDK) à votre projet et de créer une instance authProvider , consultez la documentation SDK .Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Paramètres du chemin d’accèsPath parameters

Nom du paramètreParameter name ValeurValue DescriptionDescription
idOrUserPrincipalNameidOrUserPrincipalName stringstring Obligatoire.Required. Identificateur de l’objet de l’utilisateur propriétaire du lecteur OneDrive.The identifier for the user object who owns the OneDrive.

Obtenir la bibliothèque de documents associée à un groupeGet the document library associated with a group

Pour accéder à la bibliothèque de documents par défaut d’un groupe, votre application demande la relation drive sur la ressource Group.To access a Group's default document library, your app requests the drive relationship on the Group.

Requête HTTPHTTP request

GET /groups/{groupId}/drive

Exemple de code SDKSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var drive = await graphClient.Groups["{groupId}"].Drive
    .Request()
    .GetAsync();

Pour plus d’informations sur la façon d' Ajouter le kit de développement logiciel (SDK) à votre projet et de créer une instance authProvider , consultez la documentation SDK .Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Paramètres du chemin d’accèsPath parameters

Nom du paramètreParameter name ValeurValue DescriptionDescription
groupIdgroupId stringstring Obligatoire.Required. Identificateur du groupe propriétaire de la bibliothèque de documents.The identifier for the group which owns the document library.

Obtenir la bibliothèque de documents pour un siteGet the document library for a 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.To access a Site's default document library, your app requests the drive relationship on the Site.

Requête HTTPHTTP request

GET /sites/{siteId}/drive

Exemple de code SDKSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var drive = await graphClient.Sites["{siteId}"].Drive
    .Request()
    .GetAsync();

Pour plus d’informations sur la façon d' Ajouter le kit de développement logiciel (SDK) à votre projet et de créer une instance authProvider , consultez la documentation SDK .Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Paramètres du chemin d’accèsPath parameters

Nom du paramètreParameter name ValeurValue DescriptionDescription
siteIdsiteId stringstring Obligatoire.Required. Identificateur du site contenant la bibliothèque de documents.The identifier for the site that contains the document library.

Obtenir un lecteur par le biais de son IDGet a drive by 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.If you have the unique identifier for a drive, you can access it directly from the top-level drives collection.

Requête HTTPHTTP request

GET /drives/{drive-id}

Paramètres du chemin d’accèsPath parameters

Nom du paramètreParameter name ValeurValue DescriptionDescription
driveIddriveId stringstring Obligatoire. Identificateur du lecteur demandé.Required. The identifier for the drive requested.

Paramètres facultatifs de la requêteOptional query parameters

Ces méthodes prennent en charge le paramètre de requête $select pour formuler la réponse.These method support the $select query parameter to shape the response.

RéponseResponse

Chacune de ces méthodes renvoie une ressource Drive du lecteur correspondant dans le corps de la réponse.Each of these methods returns a Drive resource for the matching drive in the response body.

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,
        "remaining": 1099447353539,
        "state": "normal",
        "total": 1099511627776
    }
}

Exemple de code SDKSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var drive = await graphClient.Drives["{drive-id}"]
    .Request()
    .GetAsync();

Pour plus d’informations sur la façon d' Ajouter le kit de développement logiciel (SDK) à votre projet et de créer une instance authProvider , consultez la documentation SDK .Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Codes de réponse d’erreurError response codes

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.If the drive does not exist and cannot be provisioned automatically (when using delegated authentication) an HTTP 404 response will be returned.