Compartir a través de


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

}