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.

En esta página

Función
Método de invocación
URI
Parámetros de solicitud
Parámetros de respuesta
Ejemplo de solicitudes
Ejemplo de respuestas
Códigos de estado
Códigos de error

Mostrar todo

Centro de ayuda/ Elastic Volume Service/ Referencia de la API/ API/ Gestión de tareas/ Consulta de estado de tarea

Consulta de estado de tarea

Actualización más reciente 2024-09-04 GMT+08:00

Ver PDF

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	Sí	String	El ID de la tarea.
project_id	Sí	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	Sí	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.

Tema principal: Gestión de tareas

Tema anterior: Gestión de tareas

Tema siguiente: API de Cinder

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar