Obter unidade

Namespace: microsoft.graph

Obtenha as propriedades e relações de um recurso de unidade .

Uma unidade é o contentor de nível superior para um sistema de ficheiros, como o OneDrive ou bibliotecas de documentos do SharePoint.

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

Obter o OneDrive atual de um utilizador

A unidade do utilizador com sessão iniciada (ao utilizar a autenticação delegada) pode ser acedida a me partir do singleton.

Se um utilizador tiver uma licença para o OneDrive, mas o OneDrive ainda não estiver configurado, este pedido aprovisiona automaticamente a unidade do utilizador ao utilizar a autenticação delegada.

GET /me/drive

Obter o OneDrive de um utilizador

Para acessar o OneDrive ou o OneDrive for Business de um usuário, seu aplicativo deve solicitar a relação drive no recurso User.

Se um utilizador tiver uma licença para o OneDrive, mas o OneDrive ainda não estiver configurado, este pedido aprovisiona automaticamente a unidade do utilizador ao utilizar a autenticação delegada.

GET /users/{idOrUserPrincipalName}/drive

Parâmetros do caminho

Obtenha a biblioteca de documentos associada a um grupo

Para acessar uma biblioteca de documentos padrão de um Grupo, o aplicativo solicita a relação drive no grupo.

GET /groups/{groupId}/drive

Parâmetros do caminho

Obter a biblioteca de documentos de um site

Para acessar uma biblioteca de documentos padrão de um Site, o aplicativo solicita a relação drive no Site.

GET /sites/{siteId}/drive

Parâmetros do caminho

Obtenha uma unidade por ID

Se tiver o identificador exclusivo de uma unidade, você poderá acessá-lo diretamente da coleção de unidades de nível superior.

GET /drives/{driveId}

Parâmetros do caminho

Parâmetros de consulta opcionais

Estes métodos suportam o parâmetro de consulta $select para moldar a resposta.

Resposta

Cada um desses métodos retorna um Recurso de Unidade para a unidade correspondente no corpo da resposta.

Códigos de resposta de erro

Se a unidade não existir e não puder ser aprovisionada automaticamente (ao utilizar a autenticação delegada), é devolvida uma HTTP 404 resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

GET /me/drive

// 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.Drive.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
drive, err := graphClient.Me().Drive().Get(context.Background(), nil)

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Drive result = graphClient.me().drive().get();

const options = {
	authProvider,
};

const client = Client.init(options);

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

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


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


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

Import-Module Microsoft.Graph.Beta.Files

# A UPN can also be used as -UserId.
Get-MgBetaUserDefaultDrive -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.drive.get()

Resposta

O exemplo a seguir mostra a resposta.

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
    }
}