功能描述
用于取消上传任务。
接口说明
要求权限:
非 acl 鉴权:admin、space_admin、upload_file、upload_file_force、begin_upload 或 begin_upload_force。
注意
虽然本接口为删除接口,但因为删除的是上传任务信息,故仍需上传文件的相关权限。
acl 鉴权:canUpload(当前文件夹可上传)
如果上传任务为分块上传任务,那么该请求将同时放弃 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。
响应体
该响应无响应体。