Skip to main content
Active IQ Unified Manager
本繁體中文版使用機器翻譯，譯文僅供參考，若與英文版本牴觸，應以英文版本為準。

Job物件異步進程

PDF

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 呼叫：

  1. 發出異步 API 呼叫。

  2. 收到 HTTP 回應 202，表示成功接受請求。

  3. 從回應主體中提取 Job 物件的識別碼。

  4. 在循環中，等待 Job 物件達到終止狀態 NORMAL, ERROR,`或者 `PARTIAL_FAILURES.

  5. 驗證作業的最終狀態並擷取作業結果。