驱动器资源类型

命名空间：microsoft.graph

表示用户的 OneDrive 或 SharePoint 中文档库的顶级对象。

OneDrive 用户始终至少有一个驱动器可用，即默认驱动器。 没有 OneDrive 许可证的用户不能拥有可用的默认驱动器。

方法

方法	返回类型	说明
列出驱动器	drive 集合	检索可用于目标用户、组或站点的驱动器资源列表。
Get drive	drive	获取有关驱动器的元数据。
Get drive root	driveItem	获取驱动器的根文件夹。
列出关注的项	driveItem 集合	列出用户关注的 driveItems。
列出子项	driveItem 集合	列出驱动器根文件夹的子级。
列出变更	driveItem 集合	列出驱动器中所有 driveItems 的更改。
搜索	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。 只读。

关系

关系	类型	说明
bundles	driveItem 集合	bundles (相册和多选共享项目集) 的集合。 只在个人的 OneDrive 中。
following	driveItem 集合	用户关注的项列表。 仅适用于 OneDrive for Business 中。
items	driveItem 集合	驱动器中包含的所有项。 只读。 可为 Null。
list	列表	适合于 SharePoint 中的驱动器，基本文档库列表。 只读。 可为 NULL。
root	driveItem	驱动器的根文件夹。 只读。
special	driveItem 集合	OneDrive 中可用的公用文件夹的集合。 只读。 可为 Null。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

drive 资源派生自 baseItem 并继承该资源的属性。

{

  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "string (timestamp)",
  "description": "string",
  "driveType": "personal | business | documentLibrary",
  "following": [{"@odata.type": "microsoft.graph.driveItem"}],
  "id": "string",
  "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",

}