Skip to main content
Active IQ Unified Manager
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.

Objetos de trabajo procesos asincrónicos

PDF

Active IQ Unified Manager proporciona la jobs API que recupera información sobre los trabajos realizados mientras se ejecutan otras API. Debe saber cómo funciona el procesamiento asincrónico utilizando el objeto Job.

Algunas de las llamadas API, particularmente aquellas que se utilizan para agregar o modificar recursos, pueden tardar más en completarse que otras llamadas. Unified Manager procesa estas solicitudes de larga ejecución de forma asincrónica.

Solicitudes asincrónicas descritas mediante el objeto Trabajo

Tras realizar una llamada a la API asincrónica, 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 después de la respuesta HTTP inicial al cliente. La respuesta incluye el objeto Job que la ancla, incluyendo su identificador único.

Consultar el objeto de trabajo asociado con una solicitud de API

El objeto Job devuelto en la respuesta HTTP contiene varias propiedades. Puede consultar la propiedad de estado para determinar si la solicitud se completó correctamente. Un objeto Job puede estar en uno de los siguientes estados:

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

Hay dos técnicas que puede utilizar al sondear un objeto de trabajo para detectar un estado terminal para la tarea, ya sea éxito o fracaso:

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

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

Pasos en una solicitud asincrónica

Puede utilizar el siguiente procedimiento de alto nivel para completar una llamada API asincrónica:

  1. Emite la llamada API asincrónica.

  2. Recibir una respuesta HTTP 202 indicando la aceptación exitosa de la solicitud.

  3. Extraiga el identificador del objeto Trabajo del cuerpo de la respuesta.

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

  5. Verificar el estado terminal del trabajo y recuperar el resultado del trabajo.