アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> introspectResourcesResult
 
introspectResourcesResult
introspectResourcesTaskから結果を取得します。返される結果の数は、ページサイズと既知のフィールドの総数によって制限されます。
結果は、イントロスペクション変更エントリの形式になります。このエントリには、イントロスペクトされたリソースのパス、タイプ、サブタイプ、発生したイントロスペクションアクション、およびそのリソースのイントロスペクションに関するメッセージ(利用可能な場合)が含まれます。
その後のこのオペレーションの呼び出しは、結果の完全なセットを段階的に返します。
ブロックエレメントが設定され、TRUEの場合、このオペレーションはタスクが完了するまでブロックされます。それ以外の場合、このオペレーションはブロックされません。
ページサイズは、この呼び出しから返される変更エントリの最大数を制御します。
ページの開始により、最初に返される結果が決まります。これを使用して、結果リストを先に進めることができます。このジャンプは、現在のロケーションを基準にしています。このオペレーションを呼び出すたびにゼロ以外のページ開始を提供すると、毎回ページサイズの結果をスキップする効果があります。
ページ開始を指定すると、結果の受信を開始するロケーションが設定されます。このオペレーションへの後続の呼び出しは、その時点から開始されます。このオペレーションの呼び出し中に不十分な数の結果が検出された場合、このオペレーションはタイムアウトするか、COMPLETEDをTRUEに設定して戻ります。いずれの場合も、結果の空のリストが返されます。
このオペレーションは、を使用して結果を取得するために使用できる、またはcancelServerTaskを使用してキャンセルできるtaskIdを返します。
このオペレーションは、totalResultsエレメントの結果の総数を返します。結果の総数がわからない場合、このエレメントは設定されていません。
このオペレーションは、処理が完了したかどうかを示す完了エレメントを返します。これらは、呼び出し元が受け取る最後の結果です。 TRUEの場合、getIntrospectableResourceFieldsResultへの後続の呼び出しはNotFoundフォールトを生成します。
このオペレーションは、detailエレメントで指定された値に基づいてstatusエレメントのイントロスペクションステータスを返します。
NONE:タスクの実行状態を示すために最小限の情報が返されます。
SIMPLE:全体的なステータスとカウントが返されます。
FULL:イントロスペクション変更エントリのリストが返されます。
ステータスstartTimeエレメントは、イントロスペクションが開始された後にのみ設定されます。ステータスendTimeエレメントは、イントロスペクトが完了した場合にのみ設定されます。
イントロスペクション変更エントリのリストには、introspectResourcesResultへの最後の呼び出し以降に新しく追加されたメッセージまたはリソース識別子のエントリのみが含まれます。
ロケーション
/services/webservices/system/admin/resource/operations/
リクエストエレメント
taskId:元の呼び出しに関連付けられたサーバータスクID。
block(オプション):処理が完了するまでブロックするかどうか。デフォルトはFALSEです。
page(オプション):
size:結果で返されるリソース識別子の数。
start:データの取得を開始するページ番号。デフォルトは0です。
detail:応答に含めるリソースに関する詳細レベル。有効な値は、NONE、SIMPLE、およびFULLです。
応答エレメント
taskId:元の呼び出しに関連付けられたサーバータスクID。
totalResults(オプション):わかっている場合は、結果セットの合計サイズ。それ以外の場合、このエレメントは存在しません。
completed:処理が完了し、結果セットが使い果たされた場合はTRUE。
status:イントロスペクションステータスレポート。 イントロスペクションレポートステータスエレメントを参照してください。
エラー解析
DataSourceError:データソース接続を確立できない場合、またはデータソース要求がエラーを返した場合。
IllegalArgument:taskId、page、またはdetailLevelの形式が正しくない場合。
IllegalState:データソースが無効になっている場合。
NotFound:taskIdが存在しないか、完了している場合。
セキュリティ:ユーザーがACCESS_TOOLS権限を持っていない場合。
セキュリティ:サーバータスクの作成に別のTDVセッションが使用された場合。