tencent cloud

Smart Media Hosting

DocumentaçãoSmart Media HostingBusiness Level API DocumentFile Operation APIRenew a Multipart Upload Task

Renew a Multipart Upload Task

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2026-01-07 14:15:06

Description

Renew the multipart upload task.
Note:
Required permissions: admin, space_admin, or upload_file/upload_file_force/begin_upload/begin_upload_force. For details on permissions, see Generate Access Token Interface.
Only supports the renewal of multipart upload tasks.

Request

Request Example

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

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console. See Create Media Library
String
Yes
SpaceId
Space ID. If the media library is in single-tenant mode, this parameter is fixed as hyphen (`-`); if the media library is in multi-tenant mode, you must specify this parameter. See Create Tenant Space
String
No
ConfirmKey
Confirm parameters, specified as the confirmKey field value in the response body when starting the file upload. See Multipart Upload
String
Yes
AccessToken
Access token, see Generate Access Token
String
Yes
UserId
User identity recognition. When the access token has admin permission and the user identity recognition during token application is empty, it is used to temporarily specify user identity. For details, see Generate Access Token API.
String
No
TrafficLimit
Single link download speed limit, range 100KB/s-100MB/s, Unit B
Number
No

Request Body

This request does not have a request body.

Response

Response code

Renewal successful, return HTTP 200 OK.

Response Body

application/json
Response body example:
{
    "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
}
Response body field description:
Response Parameters
Description
Type
domain
Domain name during actual file upload
String
path
URL path during actual file upload
String
uploadId
Request parameters to be specified during actual file upload
String
headers
Request header to be specified during actual upload
String
confirmKey
Parameters for file upload confirmation
String
expiration
Upload information valid period. It will become invalid if exceeds validity period. Need to call the multipart upload job renewal API to obtain new upload parameters.
String
availableDomainNum
Number of available domains
String

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.
Anterior: Upload a file in partsPróximo: Completing File Upload

Ajuda e Suporte

Esta página foi útil?

comentários