Répertorier les lecteurs disponibles

Espace de noms: microsoft.graph

Récupérez la liste des ressources de lecteur disponibles pour un utilisateur, un groupe ou un site cible.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Requête HTTP

Répertorier les lecteurs d’un groupe

Pour répertorier les bibliothèques de documents d’un groupe, votre application demande la relation drives sur le groupe.

GET /groups/{groupId}/drives

Répertorier les lecteurs d’un site

Pour répertorier les bibliothèques de documents d’un site, votre application demande la relation drives sur le site.

GET /sites/{siteId}/drives

Répertorier les lecteurs d’un utilisateur

GET /users/{userId}/drives

Répertorier les lecteurs actuels d’un utilisateur

GET /me/drives

Paramètres facultatifs de la requête

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

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et la collection d’objets Drive dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

GET /me/drives

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Drives.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
drives, err := graphClient.Me().Drives().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

DriveCollectionResponse result = graphClient.me().drives().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let drives = await client.api('/me/drives')
	.version('beta')
	.get();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->me()->drives()->get()->wait();

Import-Module Microsoft.Graph.Beta.Files

# A UPN can also be used as -UserId.
Get-MgBetaUserDrive -UserId $userId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.me.drives.get()

Réponse

L’exemple suivant illustre la réponse.

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

{
  "value": [
    {
      "id": "942CAEB0-13AE-491B-85E4-7557CDC0F25F",
      "driveType": "documentLibrary",
      "name": "Shared Documents",
      "owner": {
        "user": {
          "id": "AE2A1EE9-81A7-423C-ABE4-B945F47509BB",
          "displayName": "Ryan Gregg"
        }
      }
    },
    {
      "id": "C1CD3ED9-0E98-4B0B-82D3-C8FB784B9DCC",
      "driveType": "documentLibrary",
      "name": "Contoso Project Files",
      "owner": {
        "user": {
          "id": "406B2281-18E8-4416-9857-38C531B904F1",
          "displayName": "Daron Spektor"
        }
      }
    }
  ]
}

Remarques

La plupart des utilisateurs n’ont qu’une seule ressource de lecteur.

Les groupes et les sites peuvent disposer de plusieurs ressources de lecteur.

Les lecteurs avec la facette system sont masqués par défaut. Pour les répertorier, ajoutez system à votre instruction $select.