获取异步任务信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/async_task/get HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| domain_id |
string |
是 |
||
| body |
object |
否 |
请求体。 |
|
| async_task_id |
string |
是 |
异步任务 id |
000e89fb-cf8f-11e9-8ab4-b6e980803a3b |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| async_task_id |
string |
异步任务 id |
000e89fb-cf8f-11e9-8ab4-b6e980803a3b |
| status |
string |
警告 已废弃（推荐使用 state 字段替代） 任务状态
枚举值：
|
Succeed |
| state |
string |
任务状态
|
Succeed |
| message |
string |
警告 已废弃（推荐使用 error_message 字段替代） |
The request has been failed due to some unknown error. Please try again later. |
| err_code |
integer |
警告 已废弃（推荐使用 error_code 字段替代） |
404 |
| total_process |
integer |
异步任务需处理总量，如服务端打包下载需打包的文件量 |
1000 |
| consumed_process |
integer |
异步任务已处理总量，如服务端打包下载已打包的文件量 |
100 |
| url |
string |
异步任务生成数据的下载地址，如服务端打包下载任务生成下载地址 |
https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx |
| error_code |
string |
任务错误码 |
InternalError |
| error_message |
string |
任务错误信息 |
The request has been failed due to some unknown error. Please try again later. |
| uncompress_file_list |
array |
解压文件信息列表 |
|
| UncompressedFileInfo |
解压文件信息 |
||
| category |
string |
任务自定义类别 |
album |
| created_at |
string |
任务创建时间，ISO 格式， 如：2019-03-28T13:03:29.298Z |
2019-08-20T06:51:27.292Z |
| started_at |
string |
任务开始时间，ISO 格式， 如：2019-03-28T13:03:29.298Z |
2019-08-20T06:51:27.292Z |
| finished_at |
string |
任务完成时间，ISO 格式， 如：2019-03-28T13:03:29.298Z |
2019-08-20T06:51:27.292Z |
| skipped_process |
integer |
异步任务已跳过处理的数量 |
0 |
| failed_process |
integer |
异步任务已处理失败的数量 |
0 |
| task_type |
string |
示例
正常返回示例
JSON格式
{
"async_task_id": "000e89fb-cf8f-11e9-8ab4-b6e980803a3b",
"status": "Succeed",
"state": "Succeed",
"message": "The request has been failed due to some unknown error. Please try again later.",
"err_code": 404,
"total_process": 1000,
"consumed_process": 100,
"url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
"error_code": "InternalError",
"error_message": "The request has been failed due to some unknown error. Please try again later.",
"uncompress_file_list": [
{
"drive_id": "5060",
"file_id": "66972349b2b12fa309a143fb9db29647b2ddabfd",
"is_folder": true,
"name": "1.mov",
"size": 218052,
"updated_at": 1721368014000,
"items": [
{
"drive_id": "5060",
"file_id": "66972349b2b12fa309a143fb9db29647b2ddabfd",
"is_folder": true,
"name": "1.mov",
"size": 218052,
"updated_at": 1721368014000,
"items": [
{
"drive_id": "5060",
"file_id": "66972349b2b12fa309a143fb9db29647b2ddabfd",
"is_folder": true,
"name": "1.mov",
"size": 218052,
"updated_at": 1721368014000,
"items": []
}
]
}
]
}
],
"category": "album",
"created_at": "2019-08-20T06:51:27.292Z",
"started_at": "2019-08-20T06:51:27.292Z",
"finished_at": "2019-08-20T06:51:27.292Z",
"skipped_process": 0,
"failed_process": 0,
"task_type": ""
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。