Drive 资源类型

驱动器资源是表示用户的 OneDrive 或 SharePoint 中文档库的顶级对象。

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

JSON 表示形式

下面是 Drive 资源的 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",
  "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": "url"
}

属性

属性	类型	说明
createdBy	identitySet	识别创建项目的用户、设备或应用程序。 只读。
createdDateTime	dateTimeOffset	创建项的日期和时间。 只读。
说明	String	提供驱动器的用户可见说明。 读写。
driveType	String	说明了由该资源表示的驱动器的类型。 OneDrive 个人版驱动器将返回 personal。 OneDrive for Business 将返回 business。 SharePoint 文档库将返回 documentLibrary。 只读。
id	String	驱动器唯一标识符。 只读。
lastModifiedBy	identitySet	上次修改项目的用户、设备和应用程序的标识。 只读。
lastModifiedDateTime	dateTimeOffset	上次修改项目的日期和时间。 只读。
name	string	项目名称。 读写。
所有者	identitySet	可选。 拥有此驱动器的用户帐户。 只读。
配额	配额	可选。 有关驱动器的存储空间配额的信息。 只读。
sharepointIds	sharepointIds	返回对 SharePoint REST 兼容性有用的标识符。 只读。
system	systemFacet	如果存在，则表示这是系统管理的驱动器。 只读。
webUrl	string (url)	在浏览器中显示此资源的 URL。 只读。

关系

关系	类型	说明
activities	itemActivity 集合	最近发生在此驱动器下的活动的列表。
items	DriveItem 集合	驱动器中包含的所有项。 只读。 可为 NULL。
root	DriveItem	驱动器的根文件夹。 只读。
special	DriveItem 集合	OneDrive 中可用的公用文件夹的集合。 只读。 可为 Null。
list	List	适合于 SharePoint 中的驱动器，基本文档库列表。 只读。 可为 Null。

方法

常见任务	HTTP 方法
获取其他驱动器的驱动器元数据	GET /drives/{drive-id}
获取用户默认驱动器的根文件夹	GET /drive/root
列出驱动器下的活动	GET /drive/activities
列出驱动器下的子项	GET /drive/root/children
列出驱动器中所有项的变更	GET /drive/root/delta
搜索驱动器中的项	GET /drive/root/search
访问特殊文件夹	GET /drive/special/{name}

在上表中，各示例使用的是 /drive，但其他路径也同样有效。