Tipo de recurso Drive

El recurso de unidad es el objeto de nivel superior que representa el OneDrive de un usuario o una biblioteca de documentos de SharePoint.

Los usuarios de OneDrive siempre tendrán al menos una unidad disponible, la unidad predeterminada. Es posible que los usuarios sin licencia de OneDrive no tengan una unidad predeterminada disponible.

Representación JSON

A continuación se muestra una representación JSON de un recurso Drive.

El recurso drive deriva de baseItem y hereda las propiedades de ese 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"
}

Propiedades

Propiedad	Tipo	Descripción
createdBy	identitySet	Identidad del usuario, del dispositivo o de la aplicación que ha creado el elemento. Solo lectura.
createdDateTime	dateTimeOffset	Fecha y hora de creación del elemento. Solo lectura.
description	String	Proporciona una descripción de la unidad visible para el usuario. Lectura y escritura.
driveType	String	Describe el tipo de unidad que representa este recurso. Las unidades personales de OneDrive devolverán personal. OneDrive para la Empresa devolverá business. Las bibliotecas de documentos de SharePoint devolverán documentLibrary. Solo lectura.
id	String	El identificador único de la unidad. Solo lectura.
lastModifiedBy	identitySet	Identidad del usuario, el dispositivo y la aplicación que modificó por última vez el elemento. Solo lectura.
lastModifiedDateTime	dateTimeOffset	Fecha y hora de la última modificación del elemento. Solo lectura.
name	string	Nombre del elemento. Lectura y escritura.
owner	identitySet	Opcional. La cuenta de usuario propietaria de la unidad. Solo lectura.
quota	quota	Opcional. Información sobre la cuota de espacio de almacenamiento de la unidad. Solo lectura.
sharepointIds	sharepointIds	Devuelve los identificadores útiles para la compatibilidad con REST de SharePoint. Solo lectura.
system	systemFacet	Si está presente, indica que se trata de una unidad administrada por el sistema. Solo lectura.
webUrl	string (url)	Dirección URL que muestra el recurso en el explorador. Solo lectura.

Relaciones

Relación	Tipo	Descripción
activities	Colección itemActivity	Lista de actividades recientes que tuvieron lugar en esta unidad.
items	Colección DriveItem	Todos los elementos contenidos en la unidad. Solo lectura. Admite valores NULL.
root	DriveItem	La carpeta raíz de la unidad. Solo lectura.
special	Colección DriveItem	Colección de carpetas comunes disponibles en OneDrive. Solo lectura. Admite un valor NULL.
lista	List	Para unidades en SharePoint, la lista subyacente de la biblioteca de documentos. Solo lectura. Admite valores NULL.

Métodos

Tarea común	Método HTTP
Obtener los metadatos de la unidad de otra unidad	GET /drives/{drive-id}
Obtener la carpeta raíz de la unidad predeterminada del usuario	GET /drive/root
Enumerar las actividades en la unidad	GET /drive/activities
Mostrar los elementos secundarios en la unidad	GET /drive/root/children
Mostrar los cambios para todos los elementos de la unidad	GET /drive/root/delta
Buscar los elementos en la unidad	GET /drive/root/search
Acceso a la carpeta especial	GET /drive/special/{name}

En la tabla anterior, los ejemplos usan /drive pero también son válidas otras rutas.