Skip to main content
Active IQ Unified Manager 9.9
此產品有較新版本可以使用。
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

工作物件非同步處理

貢獻者

提供Active IQ Unified Manager jobs 擷取執行其他API時所執行工作相關資訊的API。您必須瞭解使用工作物件進行非同步處理的方式。

有些 API 呼叫(尤其是用於新增或修改資源的呼叫)可能需要比其他呼叫更長的時間才能完成。Unified Manager會以非同步方式處理這些長時間執行的要求。

使用工作物件說明的非同步要求

在非同步執行 API 呼叫之後、 HTTP 回應代碼 202 表示該要求已成功驗證並接受、但尚未完成。此要求會以背景工作的形式處理、並在對用戶端的初始 HTTP 回應之後繼續執行。回應包括繫留要求的工作物件、包括其唯一識別碼。

查詢與API要求相關聯的工作物件

HTTP回應中傳回的工作物件包含數個內容。您可以查詢狀態內容、以判斷要求是否成功完成。工作物件可以處於下列其中一種狀態:

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

輪詢工作物件以偵測工作的終端機狀態時、您可以使用兩種技巧:成功或失敗:

  • 標準輪詢要求:立即傳回目前的工作狀態。

  • 長時間輪詢要求:當工作狀態移至時 NORMALERROR`或 `PARTIAL_FAILURES

非同步要求的步驟

您可以使用下列高階程序來完成非同步 API 呼叫:

  1. 發出非同步 API 呼叫。

  2. 接收 HTTP 回應 202 、表示已成功接受要求。

  3. 從回應本文擷取工作物件的識別碼。

  4. 在迴圈內、等待工作物件到達終端機狀態 NORMALERROR`或 `PARTIAL_FAILURES

  5. 確認工作的終端狀態、並擷取工作結果。