Tipo de unidade de recurso

O recurso drive é o objeto de nível superior que representa o OneDrive de um usuário ou uma biblioteca de documentos no SharePoint.

Os usuários do OneDrive sempre terão pelo menos uma unidade disponível, sua unidade padrão. Usuários sem uma licença do OneDrive talvez não tenham uma unidade padrão disponível.

Representação JSON

Veja a seguir uma representação JSON de um recurso Drive.

O recurso drive é derivado de baseItem e herda propriedades desse recurso.

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "id": "string",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "string (timestamp)",
  "description": "string",
  "driveType": "personal | business | documentLibrary",
  "items": [ { "@odata.type": "microsoft.graph.driveItem" } ],
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "string (timestamp)",
  "name": "string",
  "owner": { "@odata.type": "microsoft.graph.identitySet" },
  "quota": { "@odata.type": "microsoft.graph.quota" },
  "root": { "@odata.type": "microsoft.graph.driveItem" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "special": [ { "@odata.type": "microsoft.graph.driveItem" }],
  "system": { "@odata.type": "microsoft.graph.systemFacet" },
  "webUrl": "url"
}

Propriedades

Propriedade	Tipo	Descrição
createdBy	identitySet	Identidade do usuário, dispositivo ou aplicativo que criou o item. Somente leitura.
createdDateTime	dateTimeOffset	Data e hora de criação do item. Somente leitura.
description	String	Fornecer uma descrição visível para os usuários da unidade. Leitura e gravação.
driveType	String	Descreve o tipo de unidade representado por esse recurso. As unidades pessoais do OneDrive retornarão personal. O OneDrive for Business retornará business. As bibliotecas de documentos do SharePoint retornarão documentLibrary. Somente leitura.
id	String	O identificador exclusivo da unidade. Somente leitura.
lastModifiedBy	identitySet	Identidade do usuário, dispositivo e aplicativo que modificou o item pela última vez. Somente leitura.
lastModifiedDateTime	dateTimeOffset	Data e hora em que o item foi modificado pela última vez. Somente leitura.
name	string	O nome do item. Leitura e gravação.
owner	identitySet	Opcional. A conta do usuário que é proprietário da unidade. Somente leitura.
quota	quota	Opcional. Informações sobre a cota de espaço de armazenamento da unidade. Somente leitura.
sharepointIds	sharepointIds	Retorna os identificadores úteis para fins de compatibilidade do REST do SharePoint. Somente leitura.
sistema	systemFacet	Se estiver presente, indica que se trata de uma unidade gerenciada pelo sistema. Somente leitura.
webUrl	string (url)	URL que exibe o recurso no navegador. Somente leitura.

Relações

Relação	Tipo	Descrição
activities	Conjunto itemActivity	A lista de atividades recentes que ocorreram nesta unidade.
items	Coleção DriveItem	Todos os itens contidos na unidade. Somente leitura. Anulável.
root	DriveItem	A pasta raiz da unidade. Somente leitura.
special	Coleção DriveItem	Coleção de pastas comuns disponíveis no OneDrive. Somente leitura. Anulável.
list	List	Para unidades no SharePoint, a lista de biblioteca de documentos subjacentes. Somente leitura. Anulável.

Métodos

Tarefa comum	Método HTTP
Recuperar metadados de outra Unidade	GET /drives/{drive-id}
Recuperar a pasta raiz da Unidade padrão do usuário	GET /drive/root
Liste as atividades na Unidade	GET /drive/activities
Listar filhos na Unidade	GET /drive/root/children
Listar alterações de todos os Itens na Unidade	GET /drive/root/delta
Pesquisar Itens na Unidade	GET /drive/root/search
Acessar pasta especial	GET /drive/special/{name}

Na tabela anterior, os exemplos usam /drive, mas outros caminhos também são válidos.