Tipo de recurso Drive

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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.

Métodos

Método	Tipo devuelto	Descripción
Obtener unidad	unidad	Obtener los metadatos de una unidad
Obtener raíz de la unidad	driveItem	Obtener la carpeta raíz de una unidad
Enumerar actividades	Colección itemActivity	Enumerar las actividades que se han producido en la unidad
Enumerar elementos seguidos	Colección driveItem	Enumerar driveItems seguidos por el usuario
Enumerar elementos secundarios	Colección driveItem	Enumerar los elementos secundarios de la carpeta raíz de una unidad
Enumerar cambios	Colección driveItem	Mostrar los cambios para todos los elementos driveItem de la unidad
Buscar	Colección driveItem	Buscar objetos DriveItem en una unidad
Obtener carpeta especial	driveItem	Acceder a una carpeta especial por su nombre canónico

Propiedades

Propiedad	Tipo	Descripción
createdBy	identitySet	Identidad del usuario, dispositivo o aplicación que creó 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 devuelven personal. OneDrive para la Empresa devuelve business. Las bibliotecas de documentos de SharePoint devuelven documentLibrary. Solo lectura.
id	String	El identificador único de la unidad. Solo lectura.
lastModifiedBy	identitySet	Identidad del usuario, dispositivo y 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 $select consulta.
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.
bundles	Colección driveItem	Conjunto de bundles (álbumes y conjuntos de elementos de selección múltiple compartidos). Solo en OneDrive personal.
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 un valor NULL.
lista	lista	Para unidades en SharePoint, la lista subyacente de la biblioteca de documentos. Solo lectura. Admite valores NULL.

Representación JSON

Esta es 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",
  "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",

}