Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2024-09-04 GMT+08:00

Consulta de estado de tarea

Función

Esta API se utiliza para consultar el estado de ejecución de una tarea. Se puede utilizar para consultar el estado de ejecución de una tarea de creación de disco, de expansión de capacidad o de eliminación.

Método de invocación

Para obtener más información, consulte Invocación a las API.

URI

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

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

job_id

String

El ID de la tarea.

project_id

String

El ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

El token del usuario. Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

status

String

El estado de la tarea. SUCCESS: La tarea se realizó correctamente. RUNNING: La tarea está en progreso. FAIL: El error en la tarea. INIT: Se está inicializando la tarea.

Valores de enumeración:

  • SUCCESS

  • RUNNING

  • FAIL

  • INIT

  • WAITING_EXECUTE

entities

JobEntities object

La información de respuesta a la tarea.

job_id

String

El ID de la tarea.

job_type

String

El tipo de tarea.

  • *createVolume: Creación de un disco.

  • batchCreateVolume: creación de discos por lotes.

  • deleteVolume: eliminación de un disco.

  • extendVolume: ampliación de la capacidad de un disco.

  • bulkDeleteVolume: eliminación de discos por lotes.

  • deleteSingleVolume: eliminación de discos uno por uno durante una eliminación por lotes.

  • retypeVolume: cambio del tipo de disco.

begin_time

String

La hora de inicio.

end_time

String

El tiempo final.

error_code

String

El código de error devuelto si se produce un error en la ejecución de la tarea.

fail_reason

String

La causa del error de ejecución de la tarea.

Tabla 4 JobEntities

Parámetro

Tipo

Descripción

volume_type

String

El tipo de disco.

size

Integer

El tamaño del disco, en GiB.

volume_id

String

El ID del disco.

name

String

El nombre del disco.

sub_jobs

Array of SubJob objects

La información de una subtarea. Si hay una subtarea, no se devuelven otros campos de entities.

Tabla 5 SubJob

Parámetro

Tipo

Descripción

status

String

El estado de la subtarea. SUCCESS: La tarea se realizó correctamente. RUNNING: La tarea está en progreso. FAIL: El error en la tarea. INIT: Se está inicializando la tarea.

Valores de enumeración:

  • SUCCESS

  • RUNNING

  • FAIL

  • INIT

entities

SubJobEntities object

La información de respuesta a la subtarea.

job_id

String

El ID de la subtarea.

job_type

String

El tipo de subtarea.

  • *createVolume: Creación de un disco.

  • batchCreateVolume: creación de discos por lotes.

  • deleteVolume: eliminación de un disco.

  • extendVolume: ampliación de la capacidad de un disco.

  • bulkDeleteVolume: eliminación de discos por lotes.

  • deleteSingleVolume: eliminación de discos uno por uno durante una eliminación por lotes.

  • retypeVolume: cambio del tipo de disco.

begin_time

String

La hora de inicio.

end_time

String

El tiempo final.

error_code

String

El código de error devuelto si se produce un error en la ejecución de la subtarea.

fail_reason

String

La causa del error de ejecución de la subtarea.

Tabla 6 SubJobEntities

Parámetro

Tipo

Descripción

volume_type

String

El tipo de disco.

size

Integer

El tamaño del disco, en GiB.

volume_id

String

El ID del disco.

name

String

El nombre del disco.

Código de estado: 400

Tabla 7 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error

Error object

El mensaje de error devuelto si se produce un error. Para obtener más detalles, consulte Parámetros en el campo error.

Tabla 8 Error

Parámetro

Tipo

Descripción

code

String

El código de error devuelto si se produce un error. Para conocer los códigos de error y sus significados, véase Códigos de error.

message

String

El mensaje de error devuelto si se produce un error.

Ejemplo de solicitudes

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

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

Ejemplo de respuestas

Código de estado: 200

Aceptar

{
  "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 estado: 400

Error en la solicitud

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

Códigos de estado

Código de estado

Descripción

200

Aceptar

400

Error en la solicitud

Códigos de error

Consulte Códigos de error.