Consulta de andamento de trabalho assíncrono
Função
Esta é uma API de extensão. Ela é usada para consultar o progresso de um trabalho assíncrono.
Solicitação
Resposta
- Parâmetros de resposta
Parâmetro
Tipo
Descrição
trabalho_id
Cadeia
Especifica a ID do trabalho.
trabalho_type
Cadeia
Especifica o tipo de trabalho.
begin_time
Cadeia
Especifica a hora de início do trabalho. O valor está no formato UTC.
end_time
Cadeia
Especifica o horário de término do trabalho. O valor está no formato UTC.
estado
Cadeia
Especifica o status do trabalho. O valor pode ser:
- SUCCESS: O trabalho foi executado com sucesso.
- FAIL: O trabalho falhou em ser executado.
- RUNNING: O trabalho está em andamento.
- INIT: O trabalho está sendo inicializado.
error_code
Cadeia
Especifica o código de erro.
fail_reason
Cadeia
Especifica a causa da falha.
entities
Objeto
Especifica os atributos personalizados do trabalho.
Se o status do trabalho for normal, o ID da imagem será retornado. Se o status for anormal, um código de erro e detalhes serão retornados.
Para mais detalhes, consulte Tabela 2.
Tabela 2 Descrição da estrutura de dados do campo entidades Parâmetro
Tipo
Descrição
image_name
Cadeia
Especifica o nome de imagem.
process_percent
Duplo
Especifica o andamento do trabalho.
current_task
Cadeia
Especifica o nome do trabalho.
subJobId
Cadeia
Especifica um ID de subtrabalho.
id_imagem
Cadeia
Especifica o ID da imagem.
- Exemplo de resposta
CÓDIGO DE STATUS 200
{ "job_id": "ff80808280c204e30180d2784c3c0d86", "job_type": "imsCopyImageInRegionJob", "begin_time": "2022-05-17T14:42:20.859Z", "end_time": "", "status": "RUNNING", "error_code": null, "fail_reason": null, "entities": { "image_name": "d0d2e701-dfc4-4520-9247-f92907f38eb0", "process_percent": 0.40, "current_task": "CopyImageInRegionTask:", "subJobId": "ff80808280ca6cd30180d278b9db0221", "image_id": "498cc67e-7795-482c-8c47-32bcece2d7ec" } }
Valor retornado
- Normal
- Anormal
Valor retornado
Descrição
400 Solicitação inválida
Erro na solicitação.
401 Não autorizado
Autenticação falhou.
403 Proibido
Você não tem os direitos para realizar a operação.
500 Erro de servidor interno
Erro do serviço interno.
503 Serviço indisponível
Serviço não está disponível.