有奖捉虫:行业应用 & 管理与支持文档专题 HOT

功能描述

用于取消上传任务。

接口说明

要求权限:
非 acl 鉴权:admin、space_admin、upload_file、upload_file_force、begin_upload 或 begin_upload_force
注意
虽然本接口为删除接口,但因为删除的是上传任务信息,故仍需上传文件的相关权限。
acl 鉴权:canUpload(当前文件夹可上传)
说明
非 acl 鉴权是指当前用户对所有文件的操作权限,详情可参考 生成访问令牌接口
acl 鉴权是通过共享授权接口给指定用户,以文件夹为单位授予的权限,详情可参考 角色授权模块
如果上传任务为分块上传任务,那么该请求将同时放弃 COS 中的分块上传任务。

请求

请求示例

DELETE /api/v1/file/{LibraryId}/{SpaceId}/{ConfirmKey}?upload&access_token={AccessToken}&user_id={UserId}
请求参数:
LibraryId: 媒体库 ID,必选参数。
SpaceId: 空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(-);如果媒体库为多租户模式,则必须指定该参数。
ConfirmKey: 确认参数,必选参数,指定为开始上传文件时响应体中的 confirmKey 字段的值。
AccessToken: 访问令牌,必选参数。
UserId: 用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参阅 生成访问令牌接口,可选参数。

请求体

该请求无请求体。

响应

响应码

删除成功,返回 HTTP 204 No Content。

响应体

该响应无响应体。


http://www.vxiaotou.com