Todos os produtos
Search
Central de documentação

Drive and Photo Service:GetAsyncTask

Última atualização: Jul 04, 2026

Obtém informações sobre uma tarefa assíncrona.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /v2/async_task/get HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

body

object

Não

Os parâmetros da solicitação.

async_task_id

string

Sim

O ID da tarefa assíncrona.

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

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

async_task_id

string

O ID da tarefa assíncrona.

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

status

string

Aviso

Obsoleto. Use o campo state em vez disso.

O status da tarefa.

  • Failed

  • Running

  • PartialSucceed

  • Succeed

Valores válidos:

  • Failed :

    Com falha.

  • Running :

    Em execução.

  • PartialSucceed :

    Parcialmente bem-sucedido.

  • Succeed :

    Bem-sucedido.

Succeed

state

string

O status da tarefa.

  • Failed

  • Running

  • PartialSucceed

  • Succeed

Succeed

message

string

Aviso

Obsoleto. Use o campo error_message em vez disso.

A mensagem de erro da tarefa assíncrona.

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

err_code

integer

Aviso

Obsoleto. Use o campo error_code em vez disso.

O código de erro da tarefa assíncrona.

404

total_process

integer

O número total de itens a serem processados para a tarefa assíncrona, como o número de arquivos a serem compactados para empacotamento e download no lado do servidor.

1000

consumed_process

integer

O número total de itens processados para a tarefa assíncrona, como o número de arquivos já empacotados para empacotamento e download no lado do servidor.

100

url

string

A URL de download para os dados gerados pela tarefa assíncrona, como a URL de download gerada por uma tarefa de empacotamento e download no lado do servidor.

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

error_code

string

O código de erro da tarefa.

InternalError

error_message

string

A mensagem de erro da tarefa.

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

uncompress_file_list

array

A lista de informações de arquivos não compactados.

UncompressedFileInfo

As informações de arquivos não compactados.

category

string

A categoria personalizada da tarefa.

album

created_at

string

A hora de criação da tarefa, no formato ISO, como: 2019-03-28T13:03:29.298Z.

2019-08-20T06:51:27.292Z

started_at

string

A hora de início da tarefa, no formato ISO, como: 2019-03-28T13:03:29.298Z.

2019-08-20T06:51:27.292Z

finished_at

string

A hora de conclusão da tarefa, no formato ISO, como: 2019-03-28T13:03:29.298Z.

2019-08-20T06:51:27.292Z

skipped_process

integer

O número de itens ignorados para a tarefa assíncrona.

0

failed_process

integer

O número de itens com falha para a tarefa assíncrona.

0

task_type

string

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.