taskFileAttachment: createUploadSession

命名空间:microsoft.graph

重要

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

创建上传会话,以迭代方式将文件的范围作为附件上传到 todoTask

作为响应的一部分,此操作返回可在后续顺序 PUT 查询中使用的上传 URL。 通过每个 PUT 操作的请求标头,可以指定要上传的字节的确切范围。 这允许恢复传输,以防在上传过程中断开网络连接。

下面是使用上传会话将文件附加到 Microsoft To Do 任务的步骤:

  1. 创建上传会话。
  2. 在该上传会话中,每次) 时,迭代上传字节范围 (最大为 4 MB,直到上传文件的所有字节,并且文件附加到 todoTask
  3. 可选:删除上传会话。

注意: 使用此方法附加 0 MB 到 25 MB 之间任何受支持大小的文件。

有关描述端到端附件过程的示例,请参阅 将文件附加到 To Do 任务

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

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

权限

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

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

HTTP 请求

POST /me/todo/lists/{id}/tasks/{id}/attachments/createUploadSession
POST /users/{id}/todo/lists/{id}/tasks/{id}/attachments/createUploadSession

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权
Content-Type application/json. 必需。

请求正文

在请求正文中,提供参数的 JSON 表示形式。

下表显示了可用于此操作的参数。

参数 类型 说明
attachmentInfo attachmentInfo 表示要上传和附加的项的属性。 至少指定附件类型 (file) 、名称和文件大小。

响应

如果成功,此操作将在响应正文中返回响应 200 OK 代码和新的 uploadSession

示例

请求

以下示例显示创建上传会话的请求。

POST https://graph.microsoft.com/beta/me/todo/lists/AAMDiFkfh=/tasks/AAMkADliMm=/attachments/createUploadSession
Content-Type: application/json

{
  "attachmentInfo": {
    "attachmentType": "file",
    "name": "flower",
    "size": 3483322
  }
}

响应

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

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.uploadSession",
    "uploadUrl": "https://graph.microsoft.com/beta/users/6f9a2a92-8527-4d64-837e-b5312852f36d/todo/lists/AAMDiFkfh=/tasks/AAMkADliMm=/attachmentSessions/AAMkADliMm=",
    "expirationDateTime": "2022-06-09T10:45:27.4324526Z",
    "nextExpectedRanges": [
        "0-"
    ]
}