擷取非同步任務資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST /v2/async_task/get HTTP/1.1
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| 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 |
樣本
正常返回樣本
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
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。