アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> getArchiveImportSettings
 
getArchiveImportSettings
アーカイブのインポートを制御するために使用されるインポート設定を取得します。
このオペレーションは、インポートアーカイブでのみ使用できます。 createImportArchiveが呼び出された後は、同じトランザクション内にあり、アーカイブが閉じられていない限り、いつでも使用できます。
importOptionsエレメントでいくつかのオプションを指定できます。オプションが指定されている場合、関連する情報がエクスポートされます。そうでなければ、そうではありません。デフォルトでは、呼び出し元が管理者権限を持っている場合、importOptionsの設定はexportSettingsの設定になります。呼び出し元に管理者権限がない場合、デフォルトは同じですが、管理者のみとしてマークされたアイテムは含まれません。
有効なオプションは次のとおりです。
INCLUDE_CACHING:リソースのキャッシュ構成を含めます。
INCLUDE_CUSTOM_JAVA_JARS:カスタムJavaJARをエクスポートに含めます。 (管理者のみ)
INCLUDE_STATISTICS:テーブルの境界や列の境界など、既知のリソース統計をすべて含めます。
INCLUDE_DEPENDENCY:エクスポートすることを選択したリソースのすべての依存リソースを収集して含めます。
INCLUDE_PHYSICAL_SOURCE_INFO:含まれている物理ソースの機密接続情報を含めます。 (所有者のみ)
INCLUDE_REQUIRED_USERS:必要なユーザーに関する情報をエクスポートファイルに含めます。
INCLUDE_SECURITY:リソース特権設定を含めます。 (所有者のみ)
オプションがOWNERONLYとマークされている場合、そのオプションは、呼び出し元が所有者であるリソースにのみ適用されます。呼び出し元が管理者権限を持っている場合、オプションは所有権に関係なくすべてのリソースに適用されます。このオプションを適用できない場合、メッセージは生成されますが、インポート中に障害は発生しません。
ロケーション
/services/webservices/system/admin/archive/operations/
リクエストエレメント
archiveId:アーカイブのID。
応答エレメント
settings:インポートするアーカイブの量と、インポート中に行う必要のある変更の説明。設定の構造は次のとおりです。
extractResources(オプション):インポートしてはならないリソースのリスト。デフォルトでは、これは設定されていません。
entries(オプション):エントリのパスとタイプ。
relocateResources(オプション):アーカイブ内の場所からインポートする場所へのリソースのマッピング(パスとタイプのペアを使用)のリスト。デフォルトでは、これは設定されていません。
rebindResources(オプション):アーカイブ内のリソース参照の参照先へのマッピング(パスとタイプのペアを使用)のリスト。デフォルトでは、これは設定されていません。
rebindUsers(オプション):アーカイブ内のユーザーのユーザーからユーザーへのマッピングのリスト(domainNameとuserNameのペアを使用)。デフォルトでは、これは設定されていません。
remapAttributes(オプション):インポート時に適用する必要のあるリソース属性設定のリスト。デフォルトでは、これは設定されていません。各リソースには、リソースを指定するパスとタイプのペアを含むmapエレメントと、属性エレメントがあります。 属性エレメントを参照してください。
importOptions(オプション):インポートする追加機能を示す、スペースで区切られたアーカイブオプション(名前エレメント)のリスト。デフォルトでは、エクスポートに使用されるのと同じオプションがインポートに使用されます。
エラー解析
IllegalState:このオペレーションがエクスポートアーカイブIDを使用して呼び出された場合。
NotFound:アーカイブIDのアーカイブが存在しない場合。