tipo de recurso de 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.
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.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Obter unidade | unidade | Obter metadados sobre uma unidade |
| Obter raiz da unidade | driveItem | Obter pasta raiz de uma unidade |
| Listar atividades | Coleção de itemActivity | Listar atividades que ocorreram na unidade |
| Listar itens seguidos | Coleção de driveItem | Listar os driveItems seguidos do usuário |
| Listar secundários | Coleção de driveItem | Listar secundários da pasta raiz de uma unidade |
| Listar alterações | Coleção de driveItem | Listar alterações de todos os driveItems na Unidade |
| Pesquisa | Coleção de driveItem | Pesquisar driveItems em uma unidade |
| Obter pasta especial | driveItem | Acessar uma pasta especial por nome canônico |
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 retornam personal. OneDrive for Business retorna business. As bibliotecas de documentos do SharePoint retornam 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. Essa propriedade não é retornada por padrão e deve ser selecionada usando o $select parâmetro de consulta. |
| 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. |
| pacotes | Coleção de driveItem | Coleção de pacotes (álbuns e conjuntos de itens compartilhados com seleção múltipla). Somente no OneDrive pessoal. |
| following | Coleção driveItem | A lista de itens que o usuário está seguindo. Somente no OneDrive for Business. |
| 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. |
Representação JSON
Aqui está 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",
"following": [{"@odata.type": "microsoft.graph.driveItem"}],
"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": "string",
}