Skip to main content
Active IQ Unified Manager 9.8
本产品推出了新版本。
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

作业对象异步进程

贡献者

Active IQ Unified Manager 提供 jobs 一种API、用于检索有关在运行其他API时执行的作业的信息。您必须了解使用作业对象时异步处理的工作原理。

某些 API 调用(尤其是用于添加或修改资源的 API 调用)的完成时间可能比其他调用更长。Unified Manager 会异步处理这些长时间运行的请求。

使用作业对象描述的异步请求

发出异步运行的 API 调用后, HTTP 响应代码 202 表示此请求已成功验证并被接受,但尚未完成。此请求将作为后台任务进行处理,在对客户端进行初始 HTTP 响应后,此任务将继续运行。响应包括作业对象锁定请求,包括其唯一标识符。

正在查询与 API 请求关联的作业对象

HTTP 响应中返回的作业对象包含多个属性。您可以查询 state 属性以确定请求是否成功完成。作业对象可以处于以下状态之一:

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

在轮询作业对象以检测任务的终端状态时,可以使用两种方法:成功或失败:

  • 标准轮询请求:立即返回当前作业状态。

  • 长轮询请求:作业状态移至时 NORMALERROR`或 `PARTIAL_FAILURES

异步请求中的步骤

您可以使用以下高级操作步骤完成异步 API 调用。

  1. 问题描述异步 API 调用。

  2. 接收表示已成功接受请求的 HTTP 响应 202 。

  3. 从响应正文中提取作业对象的标识符。

  4. 在环路中、等待作业对象达到终端状态 NORMALERROR`或 `PARTIAL_FAILURES

  5. 验证作业的终端状态并检索作业结果。