大网数据广告活动
Microsoft Graph 接口

列出捆绑包

· 52CE 我爱测

列出用户驱动器中的捆绑包

命名空间: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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。