本产品推出了新版本。
简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。
作业对象异步进程
贡献者
建议更改
Active IQ Unified Manager 提供 jobs
一种API、用于检索有关在运行其他API时执行的作业的信息。您必须了解使用作业对象时异步处理的工作原理。
某些 API 调用(尤其是用于添加或修改资源的 API 调用)的完成时间可能比其他调用更长。Unified Manager 会异步处理这些长时间运行的请求。
使用作业对象描述的异步请求
发出异步运行的 API 调用后, HTTP 响应代码 202 表示此请求已成功验证并被接受,但尚未完成。此请求将作为后台任务进行处理,在对客户端进行初始 HTTP 响应后,此任务将继续运行。响应包括作业对象锁定请求,包括其唯一标识符。
正在查询与 API 请求关联的作业对象
HTTP 响应中返回的作业对象包含多个属性。您可以查询 state 属性以确定请求是否成功完成。作业对象可以处于以下状态之一:
-
NORMAL
-
WARNING
-
PARTIAL_FAILURES
-
ERROR
在轮询作业对象以检测任务的终端状态时,可以使用两种方法:成功或失败:
-
标准轮询请求:立即返回当前作业状态。
-
长轮询请求:作业状态移至时
NORMAL
,ERROR`或 `PARTIAL_FAILURES
。
异步请求中的步骤
您可以使用以下高级操作步骤完成异步 API 调用。
-
问题描述异步 API 调用。
-
接收表示已成功接受请求的 HTTP 响应 202 。
-
从响应正文中提取作业对象的标识符。
-
在环路中、等待作业对象达到终端状态
NORMAL
,ERROR`或 `PARTIAL_FAILURES
。 -
验证作业的终端状态并检索作业结果。