Product Introduction

Product Overview

Feature Description

Product Strengths

Use Cases

Basic Concept

Purchase Guide

Quick Start

Create Media Library

Initiate request

Service Level API Document

History

Introduction

API Category

Making API Requests

PaaS Service APIs

Official Cloud Disk APIs

Data Types

Error Codes

Business Level API Document

Introduction

Access Token Operation API

Tenant Space Operation API

File Operation API

Directory or Album Operation API

Recycle Bin Operation API

Quota Operation API

Query Task Operation API

Search Operation API

Historical Version Operations API

Directory and File Batch Operation API

Collection Operation API

Error Codes

SDK Documentation

Android SDK

iOS SDK

HarmonyOS SDK

FAQs

Enterprise Network Disk

Product Introduction

Purchase Guide

Quick Start

FAQs

Service Level Agreement

Glossary

Renew a Multipart Upload Task

PDF

フォーカスモード

フォントサイズ

最終更新日: 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.

ヘルプとサポート

この記事はお役に立ちましたか？

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

tencent cloud

Smart Media Hosting

Renew a Multipart Upload Task

Description

Request

Request Example

Request Parameter

Request Body

Response

Response code

Response Body

Error Codes

ヘルプとサポート

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

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