アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> getResourceUpdates
 
getResourceUpdates
特定のリソースセットに対して発生したすべての更新を確認します。更新には、新しい兄弟リソースの追加、リソースの変更、リソースの移動、および削除が含まれます。
デフォルトでは、指定されたリソースのリストは、それ自体の最新バージョンと比較されます。 changeIdエレメントが設定されている場合、リソースは代わりに指定されたchangeIdと比較されます。指定されたchangeIdが特定のリソースの現在のバージョンよりも古い場合、そのリソースの変更は報告されません。
changeIdエレメントまたはversionエレメントのいずれかを指定することも、指定しないこともできます。両方を指定することはできません。
存在しないリソースまたはアクセスできないリソースのidエレメントが指定されている場合、そのIDは削除済みリストに表示されます。
ロケーション
/services/webservices/system/admin/resource/operations/
リクエストエレメント
detail:追加、変更、および移動されたリストの詳細レベル。有効な値は、NONE、SIMPLE、およびFULLです。
DiscoverChildren:指定されたリソースのすべての子孫を返す必要がある場合はTRUE。指定されたリソースのみをチェックする場合はFALSE。 FALSEの場合、新しい兄弟リソースは検出されますが、子孫は検出されません。
includeLockState:ロック状態への変更をリソースの更新と見なす必要がある場合はTRUE。
changeId(オプション):設定されている場合、指定された変更IDより大きい変更IDを持つリソースのみが返されます。
version(オプション、サポートされていません):エレメントは現在サポートされていません。
resourcesToUpdate:更新を確認するリソースのリスト。
entries:チェックするリソースのエントリ。
path:リソースのパス。
type:指定されたパスで指定されたリソースのタイプ。有効な値は、CONTAINER、DATA_SOURCE、DEFINITION_SET、LINK、PROCEDURE、TABLEです。
id(オプション):リソースのID。これは、リソースの移動を追跡するために必要です。それ以外の場合、移動されたリソースは削除および追加されたものとして表示されます。
changeId(オプション):リソースの変更ID。これは、リソースへの正確な変更を識別するために必要です。
hasChildren(オプション):TRUEの場合、クライアントはこのリソースに子があると信じています。これは、すべての子リソースの削除を検出するために使用されます。
isExpanded(オプション):このリソースの子がクライアントによって既に認識されているかどうか。クライアントツリービューで使用します。 TRUEの場合、discoverChildrenの設定に関係なく、展開されたコンテナーの直接の子が検出されます。
lastClientRefresh(オプション):このリソースがクライアントによって最後に更新された時刻。時間はサーバーを基準にしています。変更IDを使用して変更を検出する代わりに使用できます。これは、変更IDを使用する場合ほど正確ではありません。
lockCreateTime(オプション):このリソースに対してロックが作成された既知の時刻。時間はサーバーを基準にしています。 includeLockStateがTRUEの場合、この値は、現在の状態がクライアントの以前の既知の状態と類似しているが完全に同じではない複数のロック状態の変化を検出するために使用されます。
応答エレメント
resourceUpdates(オプション):
addedResources(オプション):提供されたリソースの兄弟として作成されたリソースのリスト。
changedResources(オプション):変更されたリソースのリスト。
movedResources(オプション):パスを含む、変更されたリソースのリスト。
deletedResources(オプション):削除されたリソースのリソースIDのリスト。
エラー解析
IllegalArgument:詳細、discoverChildren、includeLockState、changeId、version、またはresourcesエレメントのいずれかが不正な形式である場合。
NotAllowed:changeIdエレメントとversionエレメントの両方が設定されている場合。
NotSupported:バージョンエレメントが設定されている場合。これは将来の使用のために予約されています。