All Products
Search
Document Center

Drive and Photo Service:GetAsyncTask

Last Updated:Mar 05, 2026

Mengambil informasi mengenai tugas asinkron.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /v2/async_task/get HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

body

object

No

async_task_id

string

Yes

ID tugas asinkron.

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

Elemen respons

Element

Type

Description

Example

object

Skema Respons

async_task_id

string

ID tugas asinkron

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

status

string

Peringatan Usang. Gunakan bidang state sebagai gantinya.

Status task

  • Failed

  • Running

  • PartialSucceed

  • Succeed

Valid values:

  • Failed :

    Failed

  • Running :

    Running

  • PartialSucceed :

    PartialSucceed

  • Succeed :

    Succeed

Succeed

state

string

Status task

  • Failed

  • Running

  • PartialSucceed

  • Succeed

Succeed

message

string

Peringatan Usang. Gunakan bidang error_message sebagai gantinya.
Pesan kesalahan tugas asinkron

The request has been failed due to some unknown error. Please try again later.

err_code

integer

Peringatan Usang. Gunakan bidang error_code sebagai gantinya.
Kode kesalahan tugas asinkron

404

total_process

integer

Jumlah total item yang perlu diproses untuk tugas asinkron, seperti jumlah file yang akan dikemas untuk pengemasan dan unduhan sisi server.

1000

consumed_process

integer

Jumlah total item yang telah diproses untuk tugas asinkron, seperti jumlah file yang sudah dikemas untuk pengemasan dan unduhan sisi server.

100

url

string

URL unduhan untuk data yang dihasilkan oleh tugas asinkron, seperti URL unduhan yang dihasilkan oleh tugas pengemasan dan unduhan sisi server.

https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx

error_code

string

Kode kesalahan task

InternalError

error_message

string

Pesan kesalahan task

The request has been failed due to some unknown error. Please try again later.

uncompress_file_list

array

Daftar informasi file yang tidak terkompresi

UncompressedFileInfo

Informasi file yang tidak terkompresi

category

string

Kategori task kustom

album

created_at

string

Waktu pembuatan task, dalam format ISO, contohnya: 2019-03-28T13:03:29.298Z

2019-08-20T06:51:27.292Z

started_at

string

Waktu mulai task, dalam format ISO, contohnya: 2019-03-28T13:03:29.298Z

2019-08-20T06:51:27.292Z

finished_at

string

Waktu penyelesaian task, dalam format ISO, contohnya: 2019-03-28T13:03:29.298Z

2019-08-20T06:51:27.292Z

skipped_process

integer

Jumlah item yang dilewati untuk tugas asinkron

0

failed_process

integer

Jumlah item yang gagal untuk tugas asinkron

0

task_type

string

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.