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