エフサステクノロジーズ株式会社

本ページの製品は2024年4月1日より、エフサステクノロジーズ株式会社に統合となり、順次、切り替えを実施してまいります。一部、富士通表記が混在することがありますので、ご了承ください。

Active IQ Unified Manager 9.14

to English version

ジョブ オブジェクトの非同期プロセス

Active IQ Unified Managerには、他のAPIの実行中に実行されたジョブに関する情報を取得するjobs APIがあります。非同期プロセスがジョブ オブジェクトを使用してどのように機能するかを把握しておく必要があります。

一部のAPI呼び出し、特にリソースの追加や変更に使用されるAPI呼び出しは、他の呼び出しよりも完了に時間がかかることがあります。Unified Managerは、これらの長時間実行されている要求を非同期的に処理します。

ジョブ オブジェクトを使用して記述された非同期要求

非同期的に実行されるAPI呼び出しを行うと、HTTP応答コード202が返されます。この応答コードは、要求が正常に検証され受け入れられたものの、まだ完了していないことを示します。要求はバックグラウンド タスクとして処理され、クライアントへの最初のHTTP応答後も引き続き実行されます。応答には、要求に対応するジョブ オブジェクトと、その一意の識別子が含まれます。

API要求に関連付けられたジョブ オブジェクトの照会

HTTP応答で返されるジョブ オブジェクトには、いくつかのプロパティが含まれています。状態プロパティを照会して、要求が正常に完了したかを確認できます。ジョブ オブジェクトは次のいずれかの状態になります。

  • NORMAL

  • WARNING

  • PARTIAL_FAILURES

  • ERROR

ジョブ オブジェクトをポーリングしてタスクの最終状態(成功または失敗)を検出するには、2つの方法があります。

  • 標準のポーリング要求:現在のジョブの状態がすぐに返されます。

  • ロング ポーリング要求:ジョブの状態がNORMALERRORPARTIAL_FAILURESに移行したときに応答が返されます。

非同期要求の手順

以下は、非同期API呼び出しを完了する手順の概要です。

  1. 非同期API呼び出しを実行します。

  2. 要求が正常に受け取られたことを示すHTTP応答202を受信します。

  3. 応答の本文からジョブ オブジェクトの識別子を抽出します。

  4. ループ内で、ジョブ オブジェクトがNORMALERRORPARTIAL_FAILURESのいずれかの最終状態になるまで待ちます。

  5. ジョブの最終状態を確認し、ジョブの結果を取得します。

Top of Page