アプリケーションプログラミングインターフェイスガイド> Webサービスオペレーション> オペレーションリファレンス> updateArchiveExportSettings
 
updateArchiveExportSettings
アーカイブエクスポートで使用される、または使用されるエクスポート設定を更新します。このオペレーションは、エクスポートアーカイブでのみ使用できます。 createExportArchiveが呼び出された後は、同じトランザクション内にあり、アーカイブが閉じられていない限り、いつでも使用できます。
ロケーション
/services/webservices/system/admin/archive/operations/
リクエストエレメント
archiveId:アーカイブのID。
settings:このアーカイブ用にエクスポートされるものの説明。設定の構造は次のとおりです。
name:エクスポートアーカイブの名前。
description:アーカイブの詳細な説明。
type:
BACKUP:このアーカイブ内のすべての情報は、インポート時にサーバー情報に置き換わります。
ROOT:アーカイブ内のリソースは、再インポート時に再配置できません。
PACKAGE:アーカイブ内のリソースは、再インポート時に再配置できます。
resources(オプション):エクスポートされたリソースのリスト。
all(オプション):設定されている場合、サーバー上のすべてのリソースがエクスポートされます。
resources(オプション):各リソースのパスとタイプ、および:
includeChildren(オプション):TRUEまたは未設定の場合、すべての子リソースを再帰的にエクスポートします。 FALSEの場合、子を含めないでください。
users(オプション):エクスポートされたユーザーのリスト。 ユーザーエレメントを参照してください。
exportOptions(オプション):スペースで区切られたアーカイブオプションのリスト。
importHints(オプション):インポート中に使用できるヒント。 インポートのヒントを参照してください。
createInfo(オプション):使用されません。このエレメントの設定はすべて無視されます。
応答エレメント
該当なし
エラー解析
IllegalArgument:タイプが不正な場合。
IllegalArgument:リソースパスまたはタイプのいずれかが不正な形式である場合。
IllegalArgument:設定のいずれかが不正であるか、不正な値が含まれている場合。
IllegalArgument:サーバー属性のいずれかが不正な形式である場合。
IllegalArgument:エクスポートオプションのいずれかが不正な形式の場合。
IllegalArgument:インポートヒントのいずれかが不正な形式である場合。
IllegalState:このオペレーションは、明示的なトランザクションコンテキスト内でのみ呼び出すことができます。 beginTransactioncloseTransactionを使用します。
IllegalState:このオペレーションがインポートアーカイブIDを使用して呼び出された場合。
NotAllowed:明示的に名前が付けられたリソースをエクスポートできない場合。エクスポートが許可されていない暗黙的に識別されたリソース(includeChildrenを使用)を含めても、この障害は発生しません。
NotFound:アーカイブIDのアーカイブが存在しない場合。
NotFound:リソースパスとタイプのいずれかの部分が存在しない場合。
NotFound:ドメイン、ユーザー、またはグループのいずれかが存在しない場合。
NotFound:サーバー属性のいずれかが存在しない場合。
NotFound:importHintsで指定されたリソースのいずれかがエクスポートアーカイブに含まれていない場合。
NotFound:importHintsで指定されたユーザーのいずれかが、エクスポートアーカイブのリソース、特権、またはユーザーデータのいずれにも含まれていない場合。
セキュリティ:ユーザーが明示的に識別されたリソースパス内のすべてのアイテムに対する読み取りアクセス権を持っていない場合。ユーザーがREADアクセス権を持たない(includeChildrenを介して)暗黙的に含まれるリソースへのパスは、この障害を生成しません。
セキュリティ:呼び出し元に管理者権限がなく、管理者専用のエクスポートオプションを使用しようとした場合。
セキュリティ:呼び出し元がOWNER ONLYエクスポートオプションを使用しようとした場合、管理者権限がなく、管理者のみのエクスポートオプションを使用しようとします。