Skip to main content
Active IQ Unified Manager
Hay disponible una nueva versión de este producto.
Se proporciona el idioma español mediante traducción automática para su comodidad. En caso de alguna inconsistencia, el inglés precede al español.

Entiende cómo Active IQ Unified Manager usa los objetos Job para el procesamiento asíncrono

PDF

Active IQ Unified Manager proporciona la jobs API que recupera información sobre los trabajos realizados al ejecutar otras API. Debes saber cómo funciona el procesamiento asíncrono mediante el objeto Job.

Algunas de las llamadas a la API, sobre todo aquellas que se utilizan para añadir o modificar recursos, pueden tardar más en completarse que otras llamadas. Unified Manager procesa estas solicitudes de larga duración de forma asíncrona.

Solicitudes asíncronas descritas mediante el objeto Job

Tras realizar una llamada a la API que se ejecuta de forma asíncrona, el código de respuesta HTTP 202 indica que la solicitud se ha validado y aceptado correctamente, pero aún no se ha completado. La solicitud se procesa como una tarea en segundo plano que continúa ejecutándose tras la respuesta HTTP inicial al cliente. La respuesta incluye el objeto Job que ancla la solicitud, incluido su identificador único.

Consultar el objeto Job asociado a una solicitud de API

El objeto Job devuelto en la respuesta HTTP contiene varias propiedades. Puedes consultar la propiedad state para determinar si la solicitud se ha completado correctamente. Un objeto Job puede encontrarse en uno de los siguientes estados:

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

Hay dos técnicas que puedes usar cuando sondeas un objeto Job para detectar un estado terminal de la tarea, ya sea éxito o fracaso:

  • Solicitud de consulta estándar: se devuelve inmediatamente el estado actual del trabajo.

  • Solicitud de sondeo prolongado: cuando el estado del trabajo pasa a NORMAL, ERROR, o PARTIAL_FAILURES.

Pasos de una solicitud asíncrona

Puedes usar el siguiente procedimiento a grandes rasgos para completar una llamada asíncrona a la API:

  1. Emite la llamada asíncrona a la API.

  2. Recibe una respuesta HTTP 202 indicando la aceptación satisfactoria de la solicitud.

  3. Extrae el identificador del objeto Job del cuerpo de la respuesta.

  4. Dentro de un bucle, espera a que el objeto Job alcance el estado terminal NORMAL, ERROR, o PARTIAL_FAILURES.

  5. Comprueba el estado final del trabajo y recupera el resultado del trabajo.