Tipo de recurso Drive

Espacio de nombres: microsoft.graph

El objeto de nivel superior que representa 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.

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
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
Mostrar la lista de unidades de driveItems seguidos por el usuario Get /drive/following
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.

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 Cadena Proporciona una descripción de la unidad visible para el usuario. Solo lectura.
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. Esta propiedad no se devuelve de forma predeterminada y debe seleccionarse mediante el parámetro de consulta $select.
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
siguiendo Colección DriveItem La lista de elementos que el usuario está siguiendo. Solo en OneDrive para la Empresa.
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 valores NULL.
lista List Para unidades en SharePoint, la lista subyacente de la biblioteca de documentos. Solo lectura. Admite un valor NULL.

Representación JSON

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

El recurso drive deriva de baseItem y hereda las propiedades de ese recurso.

{
  "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": "url"
}