命名空间:microsoft.graph
获取用户驱动器 [中所有][捆绑] 包的列表。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | 不支持。 |
| 委派(个人 Microsoft 帐户) | Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All |
| 应用程序 | 不支持。 |
HTTP 请求
GET /drive/bundles
可选的查询参数
此方法支持使用 OData 查询参数筛选响应和生成响应形状。
在枚举捆绑包 expand=children 时,不能使用查询参数。
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者 {token}。必需。 |
请求正文
请勿为此方法提供请求正文。
响应
如果成功,此请求将返回为驱动器定义的捆绑项列表。
有关错误响应的信息,请参阅 错误响应。
示例
示例 1:列出驱动器中所有捆绑包
若要请求枚举驱动器中定义的所有捆绑包,你可以向不带任何参数的 捆绑 包集合提出请求。
请求
GET https://graph.microsoft.com/beta/drive/bundles
响应
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "0123456789abc",
"name": "Vacation photo album",
"bundle": {
"childCount": 1,
"album": { }
}
},
{
"id": "0120310201abd",
"name": "Family shared files",
"bundle": {
"childCount": 1
}
}
],
"@odata.nextLink": "https://..."
}
为了提高可读性,可能缩短了此处显示的响应对象。
示例 2:列出驱动器中所有的相册
若要筛选从对 bundles filter 集合的请求返回的捆绑包列表,可以使用查询字符串参数指定要返回的捆绑包类型,具体方法为检查捆绑包上是否存在 Facet:
请求
GET https://graph.microsoft.com/beta/drive/bundles?filter=bundle/album%20ne%20null
响应
对捆绑包终结点的 GET 响应是包含 [捆绑包的 driveItem][] 资源的 [数组][]。 由于所有捆绑包都是项目,因此您可以使用所有标准项操作。
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "0123456789abc",
"name": "Vacation photo album",
"bundle": {
"childCount": 1,
"album": { }
}
},
{
"id": "120301010abcd",
"name": "Seattle Center event",
"bundle": {
"childCount": 4,
"album": { }
},
"tags": [
{
"name": "outside",
"autoTagged": { }
}
]
}
]
}
为了提高可读性,可能缩短了此处显示的响应对象。
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 JeremyKelley)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
