此產品有較新版本可以使用。
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。
工作物件非同步處理
貢獻者
建議變更
支援支援「jobs」API、可擷取執行其他API時所執行工作的相關資訊。Active IQ Unified Manager您必須瞭解使用工作物件進行非同步處理的方式。
有些 API 呼叫(尤其是用於新增或修改資源的呼叫)可能需要比其他呼叫更長的時間才能完成。Unified Manager會以非同步方式處理這些長時間執行的要求。
使用工作物件說明的非同步要求
在非同步執行 API 呼叫之後、 HTTP 回應代碼 202 表示該要求已成功驗證並接受、但尚未完成。此要求會以背景工作的形式處理、並在對用戶端的初始 HTTP 回應之後繼續執行。回應包括繫留要求的工作物件、包括其唯一識別碼。
查詢與API要求相關聯的工作物件
HTTP回應中傳回的工作物件包含數個內容。您可以查詢狀態內容、以判斷要求是否成功完成。工作物件可以處於下列其中一種狀態:
-
正常
-
警告
-
"party_f失敗"
-
錯誤
輪詢工作物件以偵測工作的終端機狀態時、您可以使用兩種技巧:成功或失敗:
-
標準輪詢要求:立即傳回目前的工作狀態。
-
長時間輪詢要求:當工作狀態移至「正常」、「錯誤」或「部分失敗」時
非同步要求的步驟
您可以使用下列高階程序來完成非同步 API 呼叫:
-
發出非同步 API 呼叫。
-
接收 HTTP 回應 202 、表示已成功接受要求。
-
從回應本文擷取工作物件的識別碼。
-
在迴圈內、等待工作物件達到終端機狀態「正常、錯誤」或「部分失敗」
-
確認工作的終端狀態、並擷取工作結果。