Obter unidade
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Recupere as propriedades e as relações de um recurso de unidade .
Uma unidade é o contêiner de nível superior para um sistema de arquivos, como bibliotecas de documentos do OneDrive ou do SharePoint.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
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 atual de um usuário
A unidade do usuário conectado (ao usar a autenticação delegada) pode ser acessada do me
singleton.
Se um usuário tiver uma licença para o OneDrive, mas o OneDrive ainda não estiver configurado, essa solicitação provisionará automaticamente a unidade do usuário ao usar a autenticação delegada.
GET /me/drive
Obter 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 um usuário tiver uma licença para o OneDrive, mas o OneDrive ainda não estiver configurado, essa solicitação provisionará automaticamente a unidade do usuário ao usar a autenticação delegada.
GET /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 possui 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
Esses métodos dão suporte ao 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 provisionada automaticamente (ao usar a autenticação delegada), uma HTTP 404
resposta será retornada.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET /me/drive
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
}
}