tencent cloud

智能媒资托管

文档智能媒资托管业务级 API 文档文件操作接口分块上传任务续期

分块上传任务续期

Download
聚焦模式
字号
最后更新时间： 2026-01-07 14:15:06

功能描述

用于分块上传任务续期。
说明：
要求权限：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，如果媒体库为单租户模式，则该参数固定为连字符(`-`)；如果媒体库为多租户模式，则为具体 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

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。
上一篇: 分块上传文件下一篇: 完成文件上传

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈