Listar as unidades disponíveis

Namespace: microsoft.graph

Recupera a lista de recursos Drive disponíveis para um User, Group ou Site de destino.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Solicitação HTTP

Lista as unidades de um grupo

Para listar as bibliotecas de documentos de um grupo, seu aplicativo solicita a relação de unidades no Grupo.

GET /groups/{groupId}/drives

Lista as unidades do site

Para listar as bibliotecas de documentos de um site, seu aplicativo solicita a relação de unidades no Site.

GET /sites/{siteId}/drives

Lista as unidades de um usuário

GET /users/{userId}/drives

Lista as unidades do usuário atual

GET /me/drives

Parâmetros de consulta opcionais

Este método suporta os $expandparâmetros de consulta , $select, $skipToken, $tope $orderbyOData para personalizar a resposta.

Cabeçalhos de solicitação

Resposta

Se bem sucedido, este método retorna um código de resposta 200 OK e uma coleção de objetos Drive no corpo da resposta.

Exemplos

Solicitação

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();

mgc users drives list --user-id {user-id}

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

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-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')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


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


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

Import-Module Microsoft.Graph.Files

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

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph 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()

Resposta

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#drives",
    "value": [
        {
            "createdDateTime": "2017-07-27T02:41:36Z",
            "description": "",
            "id": "b!-RIj2DuyvEyV1T4NlOaMHk8XkS_I8MdFlUCq1BlcjgmhRfAj3-Z8RY2VpuvV_tpd",
            "lastModifiedDateTime": "2018-03-27T07:34:38Z",
            "name": "OneDrive",
            "webUrl": "https://m365x214355-my.sharepoint.com/personal/meganb_m365x214355_onmicrosoft_com/Documents",
            "driveType": "business",
            "createdBy": {
                "user": {
                    "displayName": "System Account"
                }
            },
            "lastModifiedBy": {
                "user": {
                    "email": "MeganB@contoso.com",
                    "id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
                    "displayName": "Megan Bowen"
                }
            },
            "owner": {
                "user": {
                    "email": "MeganB@contoso.com",
                    "id": "48d31887-5fad-4d73-a9f5-3c356e68a038",
                    "displayName": "Megan Bowen"
                }
            },
            "quota": {
                "deleted": 0,
                "remaining": 1099217021300,
                "state": "normal",
                "total": 1099511627776,
                "used": 294606476
            }
        }
    ]
}

Comentários

A maioria dos usuários só terá um único recurso Drive.

Grupos e Sites podem ter vários recursos de unidade disponíveis.

Unidades com a faceta sistema estão ocultas por padrão. Para listá-los, inclua system na instrução $select.