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