アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> changeResourceOwner
 
changeResourceOwner
リソースの所有者を、newOwnerName入力属性で指定されたユーザーに変更します。新しいリソース所有者はGRANT特権のみを取得しますが、これにより、必要に応じてリソースの管理とリソース特権の委任が可能になります。
このオペレーションは、MODIFY_ALL_RESOURCES権限を持つユーザーのみが呼び出すことができます。
システムがすでに所有しているリソースの所有権を変更することはできません。逆もまた真です。リソースが所有権を変更してシステム所有のリソースになることはできません。さらに、動的ドメインのユーザー、または複合ドメインの匿名ユーザーがリソースを所有することはできません。この方法でリソースを変更しようとする試みは、静かに無視されます。
recurseエレメントがTRUE(1に設定)で、リソースがコンテナーである場合、所有権の変更は、コンテナー自体を含む、コンテナー内のすべてのリソースに影響します。
物理データソースの所有権を変更すると、含まれているすべてのリソースに暗黙的に影響します。
物理データソース内のリソースは、所有権を直接変更することはできません。 recurseがTRUEの場合、物理データソースは変更されますが、子リソースの所有権の変更はデータソースと一致するように暗黙的に変更されるため、このオペレーションはデータ構造に再帰しません。
currentOwnerName属性は、リソースの所有権の変更を、現在名前が付けられている所有者が所有しているリソースのみに制限します。 currentOwnerName機能をrecurse機能と一緒に使用すると、複合効果により、currentOwnerNameが所有する子リソースのみの所有権が変更されます。
特に指定がない限り、newOwnerDomainとcurrentOwnerDomainのデフォルト値は複合です。これらはオプションの入力属性です。
ロケーション
/services/webservices/system/admin/resource/operations/
リクエストエレメント
path:新しい所有者に割り当てるリソースのパス。
type:指定されたパスで指定されたリソースのタイプ。有効な値は、CONTAINER、DATA_SOURCE、DEFINITION_SET、LINK、PROCEDURE、TABLE、TREE、およびTRIGGERです。
detail:応答に含めるリソースに関する詳細レベル。有効な値は、NONE、SIMPLE、およびFULLです。
newOwnerName:新しい所有者の名前。
newOwnerDomain(オプション):新しい所有者のドメイン名。設定されていない場合、デフォルトでコンポジットになります。
currentOwnerName(オプション):現在の所有者の名前。ユーザー名が設定されている場合、これにより、所有権の変更が、指定されたユーザーが現在所有しているリソースに制限されます。
currentOwnerDomain(オプション):現在の所有者のドメイン名。デフォルトでは、設定されていない場合は複合、設定されている場合はcurrentOwnerNameになります。
recurse(オプション):TRUE(1)に設定すると、所有権の変更がリソースコンテナー内の子リソースに再帰的に適用されます。デフォルト値は0で、再帰が試行されないことを意味します。
応答エレメント
resource:変更されたリソースとリソース定義のリスト。 リソースエレメントを参照してください。
エラー解析
IllegalArgument:パスエレメントの形式が正しくないか、不正なタイプまたは詳細が指定されました。
NotAllowed:リソースが物理データソースの子である場合。
NotAllowed:リソースが現在システムによって所有されている場合。
NotAllowed:newOwnerNameが複合ドメインのシステムである場合。
NotAllowed:複合ドメインでnewOwnerNameが匿名の場合。
NotAllowed:newOwnerDomainが動的である場合。
NotAllowed:currentOwnerNameが複合ドメインのシステムである場合。
NotAllowed:不十分なライセンスでこのオペレーションを使用しようとした場合。
NotFound:リソースまたはリソースへのパスの一部が存在しない場合。
NotFound:newOwnerNameまたはcurrentOwnerNameが存在しない場合。
NotFound:newOwnerDomainまたはcurrentOwnerDomainが存在しない場合。
セキュリティ:ユーザーがリソースへのパス内のすべてのアイテムに対する読み取りアクセス権を持っていない場合。
セキュリティ:ユーザーがパスの最後のアイテムへの書き込みアクセス権を持っていない場合。
セキュリティ:ユーザーがACCESS_TOOLSおよびMODIFY_ALL_RESOURCES権限を持っていない場合。
注:新しい所有者がリソースにアクセスして表示できるようにするには、個別のアクションが必要になる場合があります。 changeResourceOwnerオペレーションは、リソースをアクセス可能なディレクトリに移動しません。新しいオーナーがすべての親コンテナの読み取り権限を持つディレクトリにリソースを配置するには、moveResourceまたはmoveResourcesを使用します。