获取捆绑包

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

基于捆绑包的唯一 ID 检索 捆绑包 的元数据。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ✅

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

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

HTTP 请求

GET /drive/bundles/{bundle-id}
GET /drive/items/{bundle-id}

由于捆绑包是项,因此可以使用 items 集合返回有关捆绑包的元数据。 还可使用 bundles 集合来方便,确保在响应中获得捆绑包。

可选的查询参数

可以使用 OData查询参数限制通过此调用返回的对象的形状。

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
if-none-match eTag。 可选。 如果包含此请求标头,并且提供的 eTag (或 cTag) 与文件上的当前标记匹配,则返回响应 304 Not Modified 。

请求正文

请勿使用此方法提供请求正文。

响应

如果成功,此方法将返回一个 200 OK 响应代码和一个 driveItem 对象,其中包含响应正文中的 捆绑包 。

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

示例

示例 1:获取捆绑包

请求

以下示例显示了一个请求。

GET https://graph.microsoft.com/v1.0/drive/bundles/{bundle-id}

响应

以下示例显示了相应的响应。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "0123456789abc",
  "name": "My Photo Album Bundle",
  "eTag": "etag",
  "cTag": "etag",
  "createdBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
  "createdDateTime": "datetime",
  "lastModifiedBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
  "lastModifiedDateTime": "datetime",
  "size": 1234,
  "webUrl": "http://onedrive.com/...",
  "bundle": {
    "childCount": 4,
     "album": { }
  }
}

示例 2:在一次调用中获取捆绑包及其子级

使用 expand查询字符串参数 可在检索捆绑包元数据的同一请求中包含捆绑包的子级。

请求

以下示例显示了一个请求。

GET https://graph.microsoft.com/v1.0/drive/items/{bundle-id}?expand=children

响应

以下示例显示了相应的响应。 此调用返回捆绑包元数据和捆绑包的子级列表。 如果捆绑包没有子捆绑包,它将返回空集合。

如果捆绑包中的子级数大于默认页面大小,则返回带有 children@odata.nextLink 可用于请求捆绑包中下一页子级的 URL 的属性。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "101230100alkc",
  "name": "My Cool Day at the Beach",
  "children": [
    { "id": "120100abab", "name": "image1.jpg", "file": {} },
    { "id": "120100abo1", "name": "image2.jpg", "file": {} }
  ],
  "children@odata.nextLink": "https://api.onedrive.com/v1.0/..."
}