Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Image Management Service/ Referência de API/ As API do IMS/ Trabalhos de imagem/ Consulta dos trabalhos assíncronos

Atualizado em 2022-11-16 GMT+08:00

Ver PDF

Consulta dos trabalhos assíncronos

Função

Esta é uma API de extensão. Ela é usada para consultar o status de execução de um trabalho assíncrono, por exemplo, consultar o status de execução de um trabalho de exportação de imagem.

URI

GET /v1/{project_id}/trabalhos/{trabalho_id}

Tabela 1 lista os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	SIM	Especifica o ID do projeto.
trabalho_id	SIM	Especifica o ID do trabalho assíncrono.

Solicitação

Parâmetros de solicitação
None

Exemplo de solicitação

GET /v1/ac234de25c6741d2b1273da49eea1b9e/trabalhos/ff8080814dbd65d7014dbe0d84db0013

Resposta

Parâmetros de resposta

Parâmetro	Tipo	Descrição
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.
trabalho_id	Cadeia	Especifica o 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.
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
id_imagem	Cadeia	Especifica o ID da imagem.
current_task	Cadeia	Especifica o nome do trabalho.
image_name	Cadeia	Especifica o nome de imagem.
process_percent	Duplo	Especifica o andamento do trabalho.
resultados	Array of result objects	Especifica os resultados da execução do trabalho em lote.

**Tabela 3** Descrição da estrutura de dados do campo de resultados
Parâmetro	Tipo	Descrição
id_imagem	Cadeia	Especifica o ID da imagem.
project_id	Cadeia	Especifica o ID do projeto.
estado	Cadeia	Especifica o status do trabalho.

Exemplo de resposta

CÓDIGO DE STATUS 200

      
       
         
         
           {
    "status": "SUCCESS",
    "entities": {
        "image_id": "e9e91bff-14b6-4a0b-8377-4ed0813e3360",
        "image_name": "asdfasdfasdfas",
        "process_percent": 0.20,
        "current_task": "CreateImageByInstanceTask",
        "results": [{
                "image_id": "49e9447f-7dff-41e0-8036-f66fe5488c8b",
                "project_id": "089b2f9a3d80d3062f24c00ca4ed5cbd",
                "status": "success"
            }
        ]
    },
    "job_id": "ff8080814dbd65d7014dbe0d84db0013",
    "job_type": "createImageByInstance",
    "begin_time": "04-Jun-2015 18:11:06:586",
    "end_time": "",
    "error_code": null,
    "fail_reason": null
}

          

        

      
     

Valores retornados

Normal
200

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.