tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表
文档智能媒资托管业务级 API 文档查询任务操作接口查询媒体库任务接口

查询媒体库任务接口

PDF
聚焦模式
字号
最后更新时间： 2026-01-07 14:28:00

功能描述

用于查询媒体库级别耗时任务执行情况（目前只支持查询清空历史版本任务的状态）。

接口说明

说明：
任务的具体返回请参阅会产生异步任务的接口说明，部分接口会根据任务耗时情况返回同步或异步结果，此时异步结果通常与同步结果的格式保持一致。
仅能查询到任务结束时间在最近30天的任务，更早期的任务无法查询。

请求

请求示例

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

请求参数

请求参数
描述
类型
是否必选
LibraryId
媒体库 ID，在媒体托管控制台创建媒体库后获取，请参见 创建媒体库
String
是
TaskIdList
任务 ID 列表，用逗号分隔，例如 10 或 10,12,13
Int
是
AccessToken
访问令牌，获取请参见 生成访问令牌
String
是
UserId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份，详情请参阅 生成访问令牌接口
String
否

请求体

该请求无请求体。

响应

响应码

获取成功，返回 HTTP 200 OK。

响应体

application/json
响应体示例：

[
    {
        "taskId": 1000xxx,
        "status": 200,
        "result": [
            {
                "err": "",
                "status": 0,
                "deleteCount": 3
            }
        ]
    }
]
响应体字段说明：
请求参数
描述
类型
taskId
任务 ID
Int
status
任务状态码，包含以下状态：
202：任务进行中。
200：任务成功完成且有返回结果，返回结果在 result 字段中。
204：任务成功完成且无返回结果。
500：任务执行失败。
Int
result
任务成功完成后的返回结果
Object

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

上一篇: 查询任务接口下一篇: 搜索目录与文件

帮助和支持

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

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

文档反馈