列出捆绑包

命名空间:microsoft.graph

获取用户驱动器 中所有 包的列表。

Permissions

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) 不支持。
委派(个人 Microsoft 帐户) Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All
应用程序 不支持。

HTTP 请求

GET /drive/bundles

可选的查询参数

此方法支持使用 $filter OData 查询参数来帮助自定义响应。

你不能使用查询参数 expand=children 列出捆绑包。

请求头

名称 说明
Authorization Bearer {token}。必需。

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法在响应200 OK正文中返回 响应代码和 [bundlebundle] 对象集合。[]

有关错误响应的信息,请参阅 Microsoft Graph错误响应和资源类型

示例

示例 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/v1.0/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": { }
        }
      ]
    }
  ]
}