updateArchiveImportSettings
アーカイブのインポートを制御するために使用されるインポート設定を更新します。
このオペレーションは、インポートアーカイブでのみ使用できます。
createImportArchiveが呼び出された後は、同じトランザクション内にあり、アーカイブが閉じられていない限り、いつでも使用できます。
設定エレメント内に特定のオプションエレメントを設定しないということは、インポート中にその設定のどの側面も適用されないことを意味します。指定されたリソースが存在するかどうか、またはマッピングが循環関係を作成するかどうかを判断するためのチェックは行われません。
importOptionsエレメントでいくつかのオプションを指定できます。オプションを指定すると、関連する情報がエクスポートされます。それ以外の場合はエクスポートされません。有効なオプションは次のとおりです。
•INCLUDE_CACHING：リソースのキャッシュ構成を含めます。
•INCLUDE_CUSTOM_JAVA_JARS：カスタムJavaJARをエクスポートに含めます。 （管理者のみ）
•INCLUDE_STATISTICS：テーブルの境界と列の境界についてわかっているリソース統計を含めます。
•INCLUDE_DEPENDENCY：エクスポートすることを選択したリソースのすべての依存リソースを収集して含めます。
•INCLUDE_PHYSICAL_SOURCE_INFO：含まれている物理ソースの機密接続情報を含めます。 （所有者のみ）
•INCLUDE_REQUIRED_USERS：必要なユーザーに関する情報をエクスポートファイルに含めます。
•INCLUDE_SECURITY：リソース特権設定を含めます。 （所有者のみ）
— 呼び出し元がADMINONLYとマークされたオプションを要求し、管理者権限を持たない場合、セキュリティ障害が生成されます。
— 呼び出し元がOWNERONLYとマークされたオプションを要求した場合、そのオプションは、呼び出し元が所有者であるリソースにのみ適用されます。呼び出し元が管理者権限を持っている場合、このオプションは所有権に関係なくすべてのリソースに適用されます。このオプションを適用できない場合、メッセージは生成されますが、インポート中に障害は発生しません。
ロケーション
/services/webservices/system/admin/archive/operations/
リクエストエレメント
archiveId：アーカイブのID。
settings：インポートするアーカイブの量と、インポート中に行う必要のある変更の説明。設定の構造は次のとおりです。
•excludeResources（オプション）：インポートしてはならないリソースを示すパスとタイプのペアのリスト。デフォルトでは、これは設定されていません。
•relocateResources（オプション）：アーカイブ内の場所からインポートする場所へのリソースのマッピング。デフォルトでは、これは設定されていません。各マッピングは、「from」の場所を示すパスタイプのペアと「to」の場所を示すパスタイプのペアです。
•rebindResources（オプション）：アーカイブ内のリソース参照を、参照する必要のある場所にマッピングします。デフォルトでは、これは設定されていません。各マッピングは、「from」リソースバインディングを示すパスタイプペアと「to」リソースバインディングを示すパスタイプペアです。
•rebindUsers（オプション）：アーカイブ内のユーザーのマッピング先。デフォルトでは、これは設定されていません。各マッピングは、fromユーザーバインディングを示すdomainName-userNameペアと、touserバインディングを示すdomainName-userNameペアです。
•remapAttributes（オプション）：インポート時に適用する必要のあるリソース属性設定のリスト。デフォルトでは、これは設定されていません。
•マップ（オプション）:
— resource：リソースを示すパスとタイプのペア。
•importOptions（オプション）：インポートする追加機能を示す名前エレメント（アーカイブオプション）のスペース区切りのリスト。デフォルトでは、エクスポートに使用されるのと同じオプションがインポートに使用されます。
応答エレメント
該当なし
エラー解析
IllegalArgument：リソースパスまたはタイプのいずれかが不正な形式である場合。
IllegalArgument：指定された属性の形式が正しくない場合。
IllegalArgument：インポートオプションのいずれかが不正な形式の場合。
IllegalState：このオペレーションがエクスポートアーカイブIDを使用して呼び出された場合。
NotAllowed：アーカイブタイプがBACKUPまたはROOTであり、relocateResourcesエレメントが設定されている場合。
NotAllowed：アーカイブタイプがBACKUPで、excludeResourcesエレメントが設定されている場合。
NotAllowed：アーカイブタイプがBACKUPで、rebindResourcesエレメントが設定されている場合。
NotAllowed：アーカイブタイプがBACKUPで、rebindUsersエレメントが設定されている場合。
NotAllowed：アーカイブタイプがBACKUPで、remapAttributesエレメントが設定されている場合。
NotFound：アーカイブIDのアーカイブが存在しない場合。
NotFound：対応するexportOptionが設定されていないimportOptionが設定されている場合。
セキュリティ：呼び出し元がADMIN ONLYインポートオプションを設定しようとし、呼び出し元に管理者権限がない場合。