分块上传任务续期

最近更新时间:2025-10-24 16:30:02

我的收藏

功能描述

用于分块上传任务续期。
说明:
要求权限:admin、space_admin 或 upload_file/upload_file_force/begin_upload/begin_upload_force。有关权限详情请参见 生成访问令牌接口
仅支持分块上传任务的续期。

请求

请求示例

POST /api/v1/file/`{LibraryId}`/`{SpaceId}`/`{ConfirmKey}`?renew&access_token=`{AccessToken}`&user_id=`{UserId}`&traffic_limit=`{TrafficLimit}`

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID,在媒体托管控制台创建媒体库后获取,请参见 创建媒体库
String
SpaceId
空间 ID,如果媒体库为单租户模式,则该参数固定为连字符(`-`);如果媒体库为多租户模式,则必须指定该参数,获取请参见 创建租户空间
String
ConfirmKey
确认参数,指定为开始上传文件时响应体中的 confirmKey 字段的值,获取请参见 分块上传文件
String
AccessToken
访问令牌,获取请参见 生成访问令牌
String
UserId
用户身份识别,当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份,详情请参见 生成访问令牌接口
String
TrafficLimit
单链接下载限速,范围100KB/s-100MB/s,单位B
Number

请求体

该请求无请求体。

响应

响应码

续期成功,返回 HTTP 200 OK。

响应体

application/json
响应体示例:
{
"domain": "examplebucket-1250000000.cos.ap-beijing.myqcloud.com",
"path": "/xxx",
"uploadId": "xxx",
"headers": {
"Content-Type": "application/octet-stream",
"Authorization": "xxx",
"x-cos-security-token": "xxx",
"x-cos-traffic-limit": 102400
},
"confirmKey": "xxx",
"expiration": "2021-07-24T10:34:32.000Z",
"availableDomainNum":1
}
响应体字段说明:
响应参数
描述
类型
domain
实际上传文件时的域名
String
path
实际文件上传时的 URL 路径
String
uploadId
实际文件上传时需指定的请求参数
String
headers
实际上传时需指定的请求头部
String
confirmKey
用于完成文件上传的确认参数
String
expiration
上传信息有效期,超过有效期后将失效,需要调用分块上传任务续期接口获取新的上传参数
String
availableDomainNum
可用域名数量
String

错误码

该请求操作无特殊错误信息,常见的错误信息请参见 错误码 文档。