Consulta del progreso de un trabajo asincrónico

Función

Esta es una API de extensión. Se utiliza para consultar el progreso de un trabajo asincrónico.

URI

GET /v1/cloudimages/job/{job_id}

Solicitud

• Parámetros de solicitud

  Ninguna

Ejemplo de solicitud

Consulta del progreso de un trabajo asincrónico

GET /v1/cloudimages/job/ff8080814dbd65d7014dbe0d84db0013

Respuesta

• Parámetros de respuesta

  Parámetro	Tipo	Descripción
  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.
  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.
  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. Para obtener más información, véase Tabla 2.

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

  Parámetro	Tipo	Descripción
  image_name	String	Especifica el nombre de la imagen.
  process_percent	Double	Especifica el progreso del trabajo.
  current_task	String	Especifica el nombre del trabajo.
  subJobId	String	Especifica un ID de subtrabajo.
  image_id	String	Especifica el ID de imagen.
  sub_jobs_result	Array of SubJobResult objects	Especifica los resultados de ejecución de subtrabajo. Para obtener más información, véase Tabla 3.
  sub_jobs_list	Array of string	Especifica los ID de subtrabajo.

  Tabla 3 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 4. 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 4 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

  {
      "job_id": "ff80808280c204e30180d2784c3c0d86",
      "job_type": "imsCopyImageInRegionJob",
      "begin_time": "2022-05-17T14:42:20.859Z",
      "end_time": "",
      "status": "RUNNING",
      "error_code": null,
      "fail_reason": null,
      "entities": {
          "image_name": "d0d2e701-dfc4-4520-9247-f92907f38eb0",
          "process_percent": 0.40,
          "current_task": "CopyImageInRegionTask:",
          "subJobId": "ff80808280ca6cd30180d278b9db0221",
          "image_id": "498cc67e-7795-482c-8c47-32bcece2d7ec"
      }
  }

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.