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 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
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. |
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
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
Nome do parâmetro | Valor | Descrição |
---|---|---|
idOrUserPrincipalName | string | Obrigatório. O identificador de objeto do usuário proprietário do OneDrive. |
Para acessar uma biblioteca de documentos padrão de um Grupo, o aplicativo solicita a relação drive no grupo.
GET /groups/{groupId}/drive
Nome do parâmetro | Valor | Descrição |
---|---|---|
groupId | string | Obrigatório. O identificador do grupo que detém a biblioteca de documentos. |
Para acessar uma biblioteca de documentos padrão de um Site, o aplicativo solicita a relação drive no Site.
GET /sites/{siteId}/drive
Nome do parâmetro | Valor | Descrição |
---|---|---|
siteId | string | Obrigatório. O identificador do site que contém a biblioteca de documentos. |
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}
Nome do parâmetro | Valor | Descrição |
---|---|---|
driveId | cadeia de caracteres | Obrigatório. O identificador da unidade solicitada. |
Estes métodos suportam o parâmetro de consulta $select para moldar a resposta.
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Cada um desses métodos retorna um Recurso de Unidade para a unidade correspondente no corpo da resposta.
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.
GET /me/drive
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
}
}