すべてのプロダクト
Search
ドキュメントセンター

:GetAsyncTask

最終更新日:Mar 05, 2026

非同期タスクに関する情報を取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /v2/async_task/get HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

body

object

任意

async_task_id

string

必須

非同期タスクの ID。

000e89fb-cf8f-11e9-8ab4-b6e980803a3b

レスポンスフィールド

フィールド

説明

object

応答のスキーマ

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

非同期タスクによって生成されたデータのダウンロード URL。たとえば、サーバー側のパッケージングとダウンロードタスクによって生成されたダウンロード URL などです。

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

成功レスポンス

JSONJSON

{
  "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": ""
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。