功能描述
用于分块上传任务续期。
说明:
要求权限: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 | String | 是 | |
SpaceId | String | 否 | |
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 |