简体中文版经机器翻译而成,仅供参考。如与英语版出现任何冲突,应以英语版为准。
Job对象异步进程
Active IQ Unified Manager提供 `jobs`API 检索有关在运行其他 API 时执行的作业的信息。您必须知道如何使用作业对象进行异步处理。
某些 API 调用(尤其是用于添加或修改资源的调用)可能比其他调用需要更长的时间才能完成。 Unified Manager 异步处理这些长时间运行的请求。
使用 Job 对象描述的异步请求
进行异步运行的 API 调用后,HTTP 响应代码 202 表示请求已成功验证并接受,但尚未完成。该请求将作为后台任务处理,并在客户端收到初始 HTTP 响应后继续运行。响应中包含锚定该请求的 Job 对象及其唯一标识符。
查询与 API 请求关联的 Job 对象
HTTP 响应中返回的 Job 对象包含多个属性。您可以查询 state 属性来确定请求是否已成功完成。Job对象可以处于以下状态之一:
-
NORMAL
-
WARNING
-
PARTIAL_FAILURES
-
ERROR
轮询 Job 对象来检测任务的最终状态(成功或失败)时,可以使用两种技术:
-
标准轮询请求:立即返回当前作业状态。
-
长轮询请求:当作业状态转移到
NORMAL, ERROR,`或者 `PARTIAL_FAILURES.
异步请求中的步骤
您可以使用以下高级过程来完成异步 API 调用:
-
发出异步 API 调用。
-
收到 HTTP 响应 202,表示成功接受请求。
-
从响应主体中提取 Job 对象的标识符。
-
在循环中,等待 Job 对象达到终止状态
NORMAL, ERROR,`或者 `PARTIAL_FAILURES.
-
验证作业的最终状态并检索作业结果。