创建捆绑包

项目
04/06/2022

命名空间：microsoft.graph

将新 [捆绑包][] 添加到用户驱动器。

权限

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

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

HTTP 请求

POST /drive/bundles

请求标头

名称	说明
Authorization	持有者 {token}。必需。

请求正文

在请求正文中，提供要创建的捆绑包的 JSON 表示形式。

响应

如果请求成功，将返回表示新创建的捆绑包的 driveItem 。

有关错误响应的信息，请参阅错误响应。

示例

示例 1：创建捆绑包

以下示例演示如何创建基本的新捆绑包。此请求将创建一个名为的新捆绑包 Just some files ，并添加两个现有项到该捆绑包。此捆绑包可用于与其他用户共享文件集合，而无需共享存储这些项目的文件夹。

请求

POST https://graph.microsoft.com/beta/drive/bundles
Content-Type: application/json

{
  "name": "Just some files",
  "@microsoft.graph.conflictBehavior" : "rename",
  "bundle": { },
  "children": [
    { "id": "1234asdf" },
    { "id": "1234qwerty" }
  ]
}

响应

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "1234321!abc",
  "name": "Just some files",
  "bundle": {
    "childCount": 2
  }
}

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

示例 2：创建相册

创建新相册的请求相似，尽管在 bundle Facet 中，相册属性设置为非 null 值。

请求

POST https://graph.microsoft.com/beta/drive/bundles
Content-Type: application/json

{
  "name": "My Day at the Beach",
  "@microsoft.graph.conflictBehavior" : "rename",
  "bundle": { "album": {} },
  "children": [
    { "id": "1234asdf" }
  ]
}

响应

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "1234321!abc",
  "name": "Just some files",
  "bundle": {
    "childCount": 2,
    "album": { }
 }
}