tencent cloud

Smart Media Hosting

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
DokumentasiSmart Media HostingBusiness Level API DocumentQuery Task Operation APIQuery Media Library Task API

Query Media Library Task API

PDF
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-01-07 14:28:00

Description

Used for querying the task execution status of media library-level duration tasks (querying the task status of emptying earlier versions is supported).

API Description

Note:
Used to query the execution status of media library-level time-consuming tasks (currently only supports querying the status of tasks that clear historical versions).
Only tasks completed within the last 30 days can be queried; earlier tasks cannot be queried.

Request

Request Example

GET /api/v1/task/{LibraryId}/{TaskIdList}?access_token={AccessToken}&user_id={UserId}

Request Parameter

Request parameters.
Description
Type
Required or Not
LibraryId
Media Library ID, obtained after creating a media library in the media hosting console. Please refer to Create Media Library
String
Yes
TaskIdList
Task ID list, separated by commas, such as 10 or 10,12,13
Int
Yes
AccessToken
Access token, see Generate Access Token
String
Yes
UserId
User identity recognition. When the access token has admin permission and user identity recognition is empty during token request, it is used to temporarily specify user identity. For details, see Generate Access Token API
String
No

Request Body

This request does not have a request body.

Response

Response code

Successfully obtained, returning HTTP 200 OK.

Response Body

application/json
Response body example:

[
    {
        "taskId": 1000xxx,
        "status": 200,
        "result": [
            {
                "err": "",
                "status": 0,
                "deleteCount": 3
            }
        ]
    }
]
Response body field description:
Request parameters.
Description
Type
taskId
Task ID
Int
status
Task status code, including the following statuses:
202: Task in progress.
200: Task successfully completed with returned results in the result field.
204: Task successfully completed with no returned results.
500: Task execution failed.
Int
result
Return result of a successful task.
Object

Error Codes

This request operation has no special error messages. For common error messages, see Error Codes.

Topik sebelumnya: Query Task APITopik selanjutnya: Search Directory and File

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan