本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

工作物件非同步處理

貢獻者

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

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

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

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

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

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

  • 正常

  • 警告

  • "party_f失敗"

  • 錯誤

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

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

  • 長時間輪詢要求:當工作狀態移至「正常」、「錯誤」或「部分失敗」時

非同步要求的步驟

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

  1. 發出非同步 API 呼叫。

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

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

  4. 在迴圈內、等待工作物件達到終端機狀態「正常、錯誤」或「部分失敗」

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