简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。

作业对象异步进程

提供者

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

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

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

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

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

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

  • 正常

  • 警告

  • partial_failures

  • 错误

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

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

  • 长轮询请求:当作业状态变为 normal , error ,partial_failures 时。

异步请求中的步骤

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

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

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

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

  4. 在环路中,等待作业对象达到终端状态 normal , error ,partial_failures 。

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