Consulta del estado de un trabajo asincrónico

Función

Esta es una API de extensión. Se utiliza para consultar el estado de ejecución de un trabajo asincrónico, por ejemplo, consultar el estado de ejecución de un trabajo de exportación de imagen.

URI

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

Solicitud

Parámetros de solicitud

Ninguna

Ejemplo de solicitud

Consulta del estado de un trabajo asincrónico

GET /v1/ac234de25c6741d2b1273da49eea1b9e/jobs/ff8080814dbd65d7014dbe0d84db0013

Respuesta

• Parámetros de respuesta

  Parámetro	Tipo	Descripción
  status	String	Especifica el estado del trabajo. El valor puede ser: SUCCESS: El trabajo se ejecuta correctamente. FAIL: No se pudo ejecutar el trabajo. RUNNING: El trabajo está en progreso. INIT: El trabajo está siendo inicializado.
  job_id	String	Especifica el ID del trabajo.
  job_type	String	Especifica el tipo de trabajo. imsCreateImageByInstance: Creación de una imagen de disco del sistema desde un servidor en la nube imsImportImageJob: Creación de una imagen de disco del sistema a partir de un archivo de imagen externo imsImportOvaImageJob: Creación de una imagen a partir de un archivo de imagen OVA imsVolumeCreateImageJob: Creación de una imagen de disco de datos desde un servidor en la nube imsImportDataImageJob: Creación de una imagen de disco de datos a partir de un archivo de imagen externo imsCreateWholeImageByInstanceJob: Creación de una imagen completa del ECS a partir de un ECS imsCreateWholeImageByBackupJob: Creación de una imagen completa del ECS a partir de una copia de respaldo de CBR o CSBS imsNativeImportImageJob: Registro de una imagen imsNativeExportImageJob: Exportación de imagen imsAddImageMembersJob: Adición de tenants que pueden usar una imagen compartida imsDelImageMembersJob: Eliminación de tenants que pueden usar una imagen compartida imsUpdateImageMembersJob: Actualización del estado de los tenants que aceptarán o rechazarán imágenes compartidas imsCopyImageInRegionJob: Replicación de imágenes dentro de una región imsCopyImageCrossUserJob: Replicación de imágenes entre regiones
  begin_time	String	Especifica la hora de inicio del trabajo. El valor está en formato UTC.
  end_time	String	Especifica la hora de finalización del trabajo. El valor está en formato UTC.
  error_code	String	Especifica el código de error.
  fail_reason	String	Especifica la causa del error.
  entities	Object	Especifica los atributos personalizados del trabajo. Si el estado del trabajo es normal, se devolverá el ID de la imagen. Si el estado es anormal, se devolverá un código de error y detalles. Consulte Tabla 2 para obtener más detalles.

  Tabla 2 Descripción de la estructura de datos del campo de entidades

  Parámetro	Tipo	Descripción
  image_id	String	Especifica el ID de imagen.
  current_task	String	Especifica el nombre del trabajo.
  image_name	String	Especifica el nombre de la imagen.
  process_percent	Double	Especifica el progreso del trabajo.
  results	Array of result objects	Especifica los resultados de la ejecución del trabajo. Consulte Tabla 3 para obtener más detalles.
  sub_jobs_result	Array of objects	Especifica los resultados de ejecución de subtrabajo. Consulte Tabla 4 para obtener más detalles.
  sub_jobs_list	Array of string	Especifica los ID de subtrabajo.
  addition_error_code	string	Agrega un código de error.
  addition_error_msg	string	Agrega un mensaje de error.
  error_code	string	Especifica un código de error.
  error	string	Especifica un mensaje de error.
  alarm_code	string	Especifica un código de alarma.

  Tabla 3 Descripción de la estructura de datos del campo de resultados

  Parámetro	Tipo	Descripción
  image_id	String	Especifica el ID de imagen.
  project_id	String	Especifica el ID del proyecto.
  status	String	Especifica el estado del trabajo.

  Tabla 4 Descripción de la estructura de datos del campo SubJobResult

  Parámetro	Tipo	Descripción
  status	String	Especifica el estado de subtrabajo. El valor puede ser: SUCCESS: Se ha ejecutado correctamente el subtrabajo. FAIL: No se pudo ejecutar el subtrabajo. RUNNING: El subtrabajo está en curso. INIT: Se está inicializando el subtrabajo.
  job_id	String	Especifica un ID de subtrabajo.
  job_type	String	Especifica el tipo de subtrabajo.
  begin_time	String	Especifica la hora de inicio del subtrabajo. El valor está en formato UTC.
  end_time	String	Especifica la hora de fin del subtrabajo. El valor está en formato UTC.
  error_code	String	Especifica el código de error.
  fail_reason	String	Especifica la causa del error.
  entities	Object	Especifica los atributos personalizados del subtrabajo. Para obtener más información, véase Tabla 5. Si un subtrabajo se ejecuta correctamente, se devuelve un ID de imagen. Si se produce una excepción en el subtrabajo, se devuelve un código de error y la información asociada.

  Tabla 5 Descripción de la estructura de datos del campo SubJobEntities

  Parámetro	Tipo	Descripción
  image_id	String	Especifica el ID de imagen.
  image_name	String	Especifica el nombre de la imagen.

• Ejemplo de respuesta

  STATUS CODE 200

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

  { "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 devueltos

• Normal

  200

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Error de solicitud.
  401 Unauthorized	Error de autenticación.
  403 Forbidden	Usted no tiene los derechos para realizar la operación.
  500 Internal Server Error	Error interno del servicio.
  503 Service Unavailable	El servicio no está disponible.