Ler em inglês

Compartilhar via


Obter Unidade

Namespace: microsoft.graph

Recupere as propriedades e as relações de um recurso Drive.

Uma unidade é um contêiner de nível superior para um sistema de arquivos como as bibliotecas de documentos do OneDrive ou do SharePoint.

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

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

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.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, User.Read
Delegado (conta pessoal da Microsoft) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

Obter o OneDrive do usuário atual

A unidade do usuário conectado (ao usar a autenticação delegada) poderá ser acessada pelo me singleton.

Se o OneDrive de um utilizador não estiver aprovisionado, mas o utilizador tiver uma licença para utilizar o OneDrive, este pedido aprovisionará automaticamente a unidade do utilizador ao utilizar a autenticação delegada.

GET /me/drive

Obtenha o OneDrive de um usuário

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 o OneDrive de um utilizador não estiver aprovisionado, mas o utilizador tiver uma licença para utilizar o OneDrive, este pedido aprovisionará automaticamente a unidade do utilizador ao utilizar a autenticação delegada.

GET https://graph.microsoft.com/v1.0/users/{idOrUserPrincipalName}/drive

Parâmetros do caminho

Nome do parâmetro Valor Descrição
idOrUserPrincipalName string Obrigatório. O identificador de objeto do usuário proprietário do OneDrive.

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

Nome do parâmetro Valor Descrição
groupId string Obrigatório. O identificador do grupo que detém a biblioteca de documentos.

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

Nome do parâmetro Valor Descrição
siteId string Obrigatório. O identificador do site que contém a biblioteca de documentos.

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

Nome do parâmetro Valor Descrição
driveId cadeia de caracteres Obrigatório. O identificador da unidade solicitada.

Parâmetros de consulta opcionais

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

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), será devolvida uma HTTP 404 resposta.

Exemplos

Solicitação

GET /me/drive

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