You need to enable JavaScript to run this app.
文档中心
大数据文件存储

大数据文件存储

复制全文
下载 pdf
管理任务
DescribeTasks - 查询任务
复制全文
下载 pdf
DescribeTasks - 查询任务
调用 DescribeTasks 接口查询任务信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Query​
Action string 必选 示例值:DescribeTasks​
要执行的操作,取值:DescribeTasks。​
​
Version string 必选 示例值:2024-08-01​
API的版本,取值:2024-08-01。​
​
​
​
Body​
TaskId string 可选 示例值:abcd​
任务 ID。​
​
TaskType string 可选 示例值:WARMUP_NAMESPACE​
任务类型。​
​
FileSystemId string 可选 示例值:1801439850948****​
文件系统 ID。​
​
FileSystemName string 可选 示例值:test​
文件系统名称。​
​
NamespaceId string 可选 示例值:123456​
命名空间 ID。​
​
AccessId string 可选 示例值:access-abc123​
缓存接入 ID。​
​
PageNumber integer 可选 示例值:1​
实例信息列表的页码,取值为不超过 Integer 数据类型的最大值,起始值为 1。​
​
PageSize integer 可选 示例值:10​
每页记录数。取值为 1~100 间的整数,默认为 10。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
Tasks object[] 示例值:详情请参见返回示例​
任务列表信息。​
TaskId string 示例值:abcd​
任务 ID。​
​
TaskType string 示例值:WARMUP_NAMESPACE​
任务类型。​
​
TaskStatus string 示例值:FINISHED​
任务状态。​
​
StartTime string 示例值:2024-08-01T00:00:00+08:00​
任务开始时间。​
​
EndTime string 示例值:2024-08-01T01:00:00+08:00​
任务结束时间。​
​
TaskProgress string 示例值:100​
任务进度。​
​
FileSystemId string 示例值:1801439850948****​
文件系统 ID。​
​
FileSystemName string 示例值:test​
文件系统名称。​
​
NamespaceId string 示例值:123456​
命名空间 ID。​
​
AccessId string 示例值:access-abc123​
缓存接入 ID。​
​
Status string 示例值:UP​
资源状态。​
​
​
PageNumber integer 示例值:1​
实例信息列表的页码,取值为不超过 Integer 数据类型的最大值,起始值为 1。​
​
PageSize integer 示例值:10​
每页记录数。取值为 1~100 间的整数,默认为 10。​
​
TotalCount integer 示例值:1​
文件系统总数。​
​
​
​
请求示例​
​
POST /?Action=DescribeTasks&Version=2024-08-01 HTTP/1.1​
Host: open.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20241215T113747Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241215/cn-beijing/cfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"TaskId": "abcd"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202412151938192422301520975DBD1F",​
"Action": "DescribeTasks",​
"Version": "2024-08-01",​
"Service": "cfs",​
"Region": "cn-beijing"​
},​
"Result": {​
"Tasks": [​
{​
"TaskId": "abcd",​
"TaskType": "WARMUP_NAMESPACE",​
"TaskStatus": "FINISHED",​
"StartTime": "2024-08-01T00:00:00+08:00",​
"EndTime": "2024-08-01T01:00:00+08:00",​
"NamespaceId": "123456",​
"Status": "UP"​
}​
],​
"PageNumber": 1,​
"PageSize": 10,​
"TotalCount": 1​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
MissingParameter​
The required parameter %s is not supplied.​
缺少参数。​
400​
InvalidRequest​
Invalid request in request body: %s.​
请求体无效。​
400​
InvalidParameter​
The specified parameter %s is not valid.​
参数值无效。​
500​
InternalError​
The request processing has failed due to some unknown error, exception or failure.​
内部错误。​
​
​
最近更新时间:2025.08.05 11:39:53
这个页面对您有帮助吗?
有用
有用
无用
无用