全部產品
Search
文件中心

Drive and Photo Service:GetAsyncTask - 擷取非同步任務資訊

更新時間:Feb 26, 2026

擷取非同步任務資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

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 欄位替代)

任務狀態

  • Failed(失敗)

  • Running(運行中)

  • PartialSucceed(部分成功)

  • Succeed(成功)

枚舉值:

  • Failed :

    失敗

  • Running :

    運行中

  • PartialSucceed :

    部分成功

  • Succeed :

    成功

Succeed

state

string

任務狀態

  • Failed(失敗)

  • Running(運行中)

  • PartialSucceed(部分成功)

  • Succeed(成功)

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
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情