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/ Elastic Volume Service/ Referência de API/ API/ Gerenciamento de tarefas/ Consulta do status da tarefa
Atualizado em 2024-09-25 GMT+08:00
Ver PDF
Compartilhar

Consulta do status da tarefa

Função

Essa API é usada para consultar o status de execução de uma tarefa. Ela pode ser usada para consultar o status de execução de uma tarefa de criação de disco, expansão de capacidade ou exclusão.

Método de chamada

Para obter detalhes, consulte Chamada de APIs.

URI

GET /v1/{project_id}/jobs/{job_id}

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

job_id

Sim

String

O ID da tarefa.

project_id

Sim

String

O ID do projeto. Para obter detalhes sobre como obter o ID de projeto, consulte Obtenção de um ID de projeto.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

O token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

status

String

O status da tarefa. SUCCESS: a tarefa foi bem sucedida. RUNNING: a tarefa está em andamento. FAIL: a tarefa falhou. INIT: a tarefa está sendo inicializada.

Valores de enumeração:

  • SUCCESS

  • RUNNING

  • FAIL

  • INIT

  • WAITING_EXECUTE

entities

JobEntities object

As informações de resposta à tarefa.

job_id

String

O ID da tarefa.

job_type

String

O tipo de tarefa.

  • *createVolume: criar um disco.

  • batchCreateVolume: criar discos em lote.

  • deleteVolume: excluir um disco.

  • extendVolume: expandir a capacidade de um disco.

  • bulkDeleteVolume: excluir discos em lote.

  • deleteSingleVolume: excluir discos um a um durante uma exclusão em lote.

  • retypeVolume: alterar o tipo de um disco.

begin_time

String

A hora de início.

end_time

String

A hora de término.

error_code

String

O código de erro retornado se a execução da tarefa falhar.

fail_reason

String

A causa da falha na execução da tarefa.
Tabela 4 JobEntities

Parâmetro

Tipo

Descrição

volume_type

String

O tipo de disco.

size

Integer

O tamanho do disco, em GiB.

volume_id

String

O ID do disco.

name

String

O nome do disco.

sub_jobs

Array of SubJob objects

As informações de uma subtarefa. Se houver uma subtarefa, outros campos em entities não serão retornados.
Tabela 5 SubJob

Parâmetro

Tipo

Descrição

Estado

String

O status da subtarefa. SUCCESS: a tarefa foi bem sucedida. RUNNING: a tarefa está em andamento. FAIL: a tarefa falhou. INIT: a tarefa está sendo inicializada.

Valores de enumeração:

  • SUCCESS

  • RUNNING

  • FAIL

  • INIT

entities

SubJobEntities object

As informações de resposta da subtarefa.

job_id

String

O ID da subtarefa.

job_type

String

O tipo de subtarefa.

  • *createVolume: criar um disco.

  • batchCreateVolume: criar discos em lote.

  • deleteVolume: excluir um disco.

  • extendVolume: expandir a capacidade de um disco.

  • bulkDeleteVolume: excluir discos em lote.

  • deleteSingleVolume: excluir discos um a um durante uma exclusão em lote.

  • retypeVolume: alterar o tipo de um disco.

begin_time

String

A hora de início.

end_time

String

A hora de término.

error_code

String

O código de erro retornado se a execução da subtarefa falhar.

fail_reason

String

A causa da falha na execução da subtarefa.
Tabela 6 SubJobEntities

Parâmetro

Tipo

Descrição

volume_type

String

O tipo de disco.

size

Integer

O tamanho do disco, em GiB.

volume_id

String

O ID do disco.

name

String

O nome do disco.

Código de status: 400

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error

Error object

A mensagem de erro retornada se ocorrer um erro. Para obter detalhes, consulte Parâmetros no campo error.
Tabela 8 Error

Parâmetro

Tipo

Descrição

code

String

O código de erro retornado se ocorrer um erro. Para os códigos de erro e seus significados, consulte Códigos de erro.

message

String

A mensagem de erro retornada se ocorrer um erro.

Exemplo de solicitações

GET https://{endpoint}/v1/{project_id}/jobs/{job_id}

https://{endpoint}/v1/{project_id}/jobs/{job_id}

Exemplo de respostas

Código de status: 200

OK

{
  "status" : "RUNNING",
  "entities" : {
    "volume_id" : "bdf1bb37-f20f-4266-9a04-f43e0a127376"
  },
  "job_id" : "4010a32d535527910153552b492c0002",
  "job_type" : "createVolume",
  "begin_time" : "2016-03-08T07:40:13.219Z",
  "end_time" : ""
}

Código de status: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

Códigos de status

Código de status

Descrição

200

OK

400

Bad Request

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de tarefas