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

工作物件非同步處理

貢獻者 netapp-shwetav
PDF

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

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

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

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

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

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

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

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

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

  • 長時間輪詢要求：當工作狀態移至時 NORMAL, ERROR, 或 PARTIAL_FAILURES.

非同步要求的步驟

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

  1. 發出非同步 API 呼叫。

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

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

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

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