Skip to main content
Active IQ Unified Manager
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Entenda como o Active IQ Unified Manager utiliza objetos Job para processamento assíncrono

PDFs

O Active IQ Unified Manager fornece a jobs API que recupera informações sobre os Jobs executados durante a execução de outras APIs. Você deve saber como o processamento assíncrono funciona usando o objeto Job.

Algumas chamadas de API, principalmente aquelas usadas para adicionar ou modificar recursos, podem demorar mais para serem concluídas do que outras. O Unified Manager processa essas solicitações de longa duração de forma assíncrona.

Solicitações assíncronas descritas usando o objeto Job

Após uma chamada de API assíncrona, o código de resposta HTTP 202 indica que a solicitação foi validada e aceita com sucesso, mas ainda não foi concluída. A solicitação é processada como uma tarefa em segundo plano que continua a ser executada após a resposta HTTP inicial ao cliente. A resposta inclui o objeto Job que ancora a solicitação, incluindo seu identificador exclusivo.

Consultar o objeto Job associado a uma solicitação de API

O objeto Job retornado na resposta HTTP contém diversas propriedades. Você pode consultar a propriedade state para determinar se a solicitação foi concluída com sucesso. Um objeto Job pode estar em um dos seguintes estados:

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

Existem duas técnicas que você pode usar ao consultar um objeto Job para detectar o estado final da tarefa, seja sucesso ou falha:

  • Solicitação de sondagem padrão: o estado atual do trabalho é retornado imediatamente.

  • Solicitação de long polling: quando o estado do trabalho passa para NORMAL, ERROR, ou PARTIAL_FAILURES.

Etapas em uma solicitação assíncrona

Você pode usar o seguinte procedimento de alto nível para concluir uma chamada de API assíncrona:

  1. Emita a chamada de API assíncrona.

  2. Receba uma resposta HTTP 202 indicando aceitação bem-sucedida da solicitação.

  3. Extraia o identificador do objeto Job do corpo da resposta.

  4. Dentro de um loop, aguarde até que o objeto Job atinja o estado terminal NORMAL, ERROR, ou PARTIAL_FAILURES.

  5. Verifique o estado terminal do Job e recupere o resultado do Job.