アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> reintrospectDataSource
 
reintrospectDataSource
APIバージョン6.0で非推奨になりました。代わりに、introspectResourcesTaskを使用してください。
注:このWebサービスオペレーションは、リソースツリーの /lib/resourceにある同じ名前のプロシージャとは異なります。
指定されたデータソースの再イントロスペクションを実行します。
isBlockingがTRUEの場合、このオペレーションは再イントロスペクトが完了するまで戻りません。 isBlockingがFALSEの場合、呼び出しは、cancelDataSourceReintrospectおよびgetDataSourceReintrospectResultで使用できる再イントロスペクトIDですぐに戻ります。
isBlockingがFALSEであり、このオペレーションが明示的なトランザクションで呼び出された場合、再イントロスペクトが完了する前にトランザクションが完了するまでトランザクションをコミットします。このオペレーションが暗黙のトランザクションで呼び出された場合、再イントロスペクションはバックグラウンドで実行され、成功時にコミットするか、失敗時にロールバックします。この場合、cancelDataSourceReintrospectまたはgetDataSourceReintrospectResultの呼び出しでは、再イントロスペクトIDは見つかりません。暗黙的なトランザクションの再イントロスペクトをキャンセルしたり、レポートを生成したりすることはできません。
ロケーション
/services/webservices/system/admin/resource/operations/
リクエストエレメント
path:再イントロスペクトされるデータソースへのパス。
isBlocking:TRUEの場合、この呼び出しは再イントロスペクションが完了するまで戻りません。 FALSEの場合、この呼び出しは完了に関係なくすぐに戻ります。
attributes(オプション):リソースに使用されるオプションの値。ログイン情報がデータソース定義で保持されていない場合、これらはログイン情報を指定するために必要になる場合があります。 属性エレメントを参照してください。
応答エレメント
status:
このオペレーション中に再イントロスペクトが完了した場合は、成功または失敗(必要に応じて)。
再イントロスペクトがまだ進行中の場合は不完全です。
reintrospectReport(オプション):再イントロスペクトがSUCCESSまたはFAILの場合、このレポートには、再イントロスペクション中に発生した変更が一覧表示されます。それ以外の場合、このエレメントは存在しません。 レポートエレメントの再イントロスペクトを参照してください。
reintrospectId(オプション):ステータスがINCOMPLETEの場合、reintrospectIDが提供されます。
エラー解析
IllegalArgument:パスの形式が正しくない場合。
NotFound:指定されたパスでデータソースリソースが見つからない場合。
IllegalState:データソースが無効になっている場合。
セキュリティ:ユーザーがパス内の最後のアイテム以外のすべてのアイテムに対する読み取りアクセス権を持っていない場合。
セキュリティ:ユーザーがパスの最後のアイテムに対する書き込みアクセス権を持っていない場合。
セキュリティ:ユーザーがACCESS_TOOLS権限を持っていない場合。