命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
驱动器资源是代表用户的 OneDrive 或在 SharePoint 中文档库的顶级对象。
OneDrive 用户始终至少有一个驱动器可用，即默认驱动器。 没有 OneDrive 许可证的用户不能拥有可用的默认驱动器。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 列出驱动器 | drive 集合 | 检索可用于目标用户、组或站点的驱动器资源列表。 |
| Get drive | drive | 获取有关驱动器的元数据。 |
| Get drive root | driveItem | 获取驱动器的根文件夹。 |
| 列出活动 | itemActivity 集合 | 列出驱动器下发生的活动。 |
| 列出关注的项 | driveItem 集合 | 列出用户关注的 driveItems。 |
| 列出子项 | driveItem 集合 | 列出驱动器根文件夹的子级。 |
| 列出变更 | driveItem 集合 | 列出驱动器中所有 driveItems 的更改。 |
| 搜索 | driveItem 集合 | 在驱动器中搜索 driveItems。 |
| 获取特殊文件夹 | driveItem | 按规范名称访问特殊文件夹。 |
| 最近弃用 () | driveItem 集合 | 列出登录用户最近使用的一组项。 |
| 与我共享 (已弃用) | driveItem 集合 | 获取与驱动器所有者共享的 driveItem 对象的列表。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| createdBy | identitySet | 创建项的用户、设备或应用程序的标识。 只读。 |
| createdDateTime | dateTimeOffset | 创建项的日期和时间。 只读。 |
| description | String | 提供驱动器的用户可见说明。 读写。 |
| driveType | String | 说明了由该资源表示的驱动器的类型。 OneDrive 个人驱动器返回 personal。 OneDrive for Business返回 business。 SharePoint 文档库返回 documentLibrary。 只读。 |
| id | String | 驱动器唯一标识符。 只读。 |
| lastModifiedBy | identitySet | 上次修改项的用户、设备和应用程序的标识。 只读。 |
| lastModifiedDateTime | dateTimeOffset | 上次修改项目的日期和时间。 只读。 |
| name | string | 项目名称。 读写。 |
| owner | identitySet | 可选。 拥有此驱动器的用户帐户。 此为只读属性。 |
| quota | quota | 可选。 有关驱动器的存储空间配额的信息。 此为只读属性。 |
| sharepointIds | sharepointIds | 返回对 SharePoint REST 兼容性有用的标识符。 只读。 默认情况下不返回此属性，必须使用查询参数选择 $select 此属性。 |
| system | systemFacet | 如果存在，则指示它是系统托管的驱动器。 只读。 |
| webUrl | string (url) | 在浏览器中显示此资源的 URL。 只读。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| activities | itemActivity 集合 | 最近发生在此驱动器下的活动的列表。 |
| 捆绑 | driveItem 集合 | bundles (相册和多选共享项目集) 的集合。 只在个人的 OneDrive 中。 |
| following | driveItem 集合 | 用户关注的项列表。 仅适用于 OneDrive for Business 中。 |
| items | driveItem 集合 | 驱动器中包含的所有项。 只读。 可为 NULL。 |
| root | driveItem | 驱动器的根文件夹。 只读。 |
| special | driveItem 集合 | OneDrive 中可用的公用文件夹的集合。 只读。 可为 Null。 |
| list | 列表 | 适合于 SharePoint 中的驱动器，基本文档库列表。 只读。 可为 Null。 |
JSON 表示形式
下面是驱动器资源的 JSON 表示形式。
drive 资源派生自 baseItem 并继承该资源的属性。
{
"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",
}