翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ファイル、オブジェクト、メタデータの処理方法の設定
<a name="configure-metadata"></a>

ロケーション間で転送するときに、 がファイル、オブジェクト、および関連するメタデータ AWS DataSync を処理する方法を設定できます。

たとえば、定期的な転送では、転送先のファイルを転送元の変更で上書きして、場所間の同期を維持したい場合があります。ファイルやフォルダの POSIX 許可、オブジェクトに関連付けられたタグ、アクセスコントロールリスト (ACL)などのプロパティをコピーできます。

## 転送モードのオプション
<a name="task-option-transfer-mode"></a>

DataSync がタスクを実行するたびに、最初のコピーの後に変更されたデータ (メタデータを含む) のみを転送するか、すべてのデータを転送するかを設定できます。定期的に転送を行う予定の場合は、前回のタスク実行以降に変更されたもののみを転送することをお勧めします。


| コンソールのオプション | API のオプション | 説明 | 
| --- | --- | --- | 
|  **変更されたデータのみを転送する**  |  [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) を `CHANGED` に設定  | 最初の完全転送後、DataSync は、送信元と送信先の場所で異なるデータとメタデータのみをコピーします。 | 
|  **すべてのデータを転送する**  |  [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) を `ALL` に設定  |  DataSync は、場所間の違いを比較せずに、送信元のすべてを送信先にコピーします。  | 

## ファイルとオブジェクトの処理オプション
<a name="task-option-file-object-handling"></a>

DataSync が送信先の場所にあるファイルまたはオブジェクトを処理する方法の一部を制御できます。例えば、DataSync は送信元にない送信先のファイルを削除できます。


| コンソールのオプション | API のオプション | 説明 | 
| --- | --- | --- | 
|  **削除されたファイルを保持する**  |  [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)  |  送信元に存在しない、送信先の場所にある DataSync マニフェストファイルまたはオブジェクトを保持するかどうかを指定します。 タスクが Amazon S3 バケットからオブジェクトを削除するよう設定している場合、特定のストレージクラスに対して最小ストレージ期間料金が発生する可能性があります。詳細については、「[Amazon S3 転送におけるストレージクラスに関する考慮事項](create-s3-location.md#using-storage-classes)」を参照してください。  送信先のデータを削除し、[すべてのデータを転送する](#task-option-transfer-mode)ようにもタスクを設定することはできません。すべてのデータを転送すると、DataSync は転送先の場所をスキャンしないため、何を削除すればよいかがわかりません。   | 
|  **ファイルを上書きする**  |  [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)  |  送信元のデータまたはメタデータが変更されたときに DataSync が送信先の場所のデータを変更するかどうかを指定します。データを上書きするようにタスクを設定していない場合、送信元のデータが異なる場合でも、送信先データは上書きされません。 タスクがオブジェクトを上書きする場合、特定のストレージクラスに対して追加料金が発生する可能性があります (たとえば、取得や早期削除など)。詳細については、「[Amazon S3 転送におけるストレージクラスに関する考慮事項](create-s3-location.md#using-storage-classes)」を参照してください。  | 

## メタデータ処理オプション
<a name="task-option-metadata-handling"></a>

DataSync は転送中にファイルとオブジェクトのメタデータを保存できます。DataSync が保存できるメタデータは、関連するストレージシステムと、それらのシステムが同様のメタデータ構造を使用しているかどうかによって異なります。

タスクの設定を行う前に、DataSync が送信元と送信先の場所の間で転送を行う際に、[メタデータ](metadata-copied.md)と[特殊ファイル](special-files-copied.md)をどのように処理するのかを理解しておいてください。

**重要**  
DataSync は、Google Cloud Storage や IBM Cloud Object Storage など、特定のサードパーティーのクラウドストレージシステムとの間の転送をサポートしています。これらのシステムは、完全に S3 互換ではない方法でシステムメタデータを処理します。これらの転送では、DataSync は `ContentType`、`ContentEncoding`、`ContentLanguage`、`CacheControl` などのメタデータ属性をベストエフォートベースでコピーしようとします。送信先のストレージシステムがこれらの属性を適用しない場合、タスクの検証中は無視されます。


| コンソールのオプション | API のオプション | 説明 | 
| --- | --- | --- | 
|  **所有権のコピー**  | [Gid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid) と [Uid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Uid) |  DataSync が POSIX ファイルやフォルダの所有権 (ファイルの所有者のグループ ID やファイルの所有者のユーザー ID など) をコピーするかどうかを指定します。  | 
|  **権限のコピー**  | [PosixPermissions](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PosixPermissions) |  DataSync がファイルやフォルダに対する POSIX アクセス許可を送信元から送信先にコピーするかどうかを指定します。  | 
| タイムスタンプのコピー | [Atime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime) と [Mtime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Mtime) |  DataSync がタイムスタンプのメタデータを送信元から送信先にコピーするかどうかを指定します。タスクを複数回実行する必要がある場合に必要です。  | 
| オブジェクトタグのコピー | [ObjectTags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-ObjectTags) |  DataSync がオブジェクトストレージシステム間で転送するときに、オブジェクトに関連付けられたタグを保持するかどうかを指定します。  | 
| 所有権、DACL、SACL のコピー | [SecurityDescriptorCopyFlags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) を OWNER\$1DACL\$1SACL に設定 |  DataSync は以下をコピーします。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/datasync/latest/userguide/configure-metadata.html)  | 
| 所有権と DACL のコピー | [SecurityDescriptorCopyFlags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) を OWNER\$1DACL に設定 |  DataSync は以下をコピーします。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/datasync/latest/userguide/configure-metadata.html) このオプションを選択すると、DataSync は SACL をコピーしません。  | 
| 所有権や ACL をコピーしない | [SecurityDescriptorCopyFlags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) を NONE に設定 |  DataSync は所有権や権限のデータをコピーしません。DataSync が転送先に書き込むオブジェクトは、DataSync が転送先の場所にアクセスするための認証情報を提供するユーザーによって所有されています。転送先オブジェクトのアクセス許可は、転送先サーバーで設定されたアクセス許可に基づいて決定されます。  | 

## ファイル、オブジェクト、メタデータの処理オプションの設定
<a name="configure-file-metadata-options"></a>

転送タスクを作成、編集、または開始するときに、DataSync がファイル、オブジェクト、メタデータを処理する方法を設定できます。

### DataSync コンソールの使用
<a name="configure-metadata-console"></a>

次の手順では、タスクの作成時にファイル、オブジェクト、メタデータの処理オプションを設定する方法について説明します。

1. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) で AWS DataSync コンソールを開きます。

1. 左側のナビゲーションペインで **[データ転送]** を展開し、**[タスク]**、**[タスクの作成]** の順に選択します。

1. タスクのソースと送信先の場所を設定します。

   詳細については、[でデータを転送できる場所 AWS DataSync](working-with-locations.md)を参照してください。

1. **転送モード**の場合、以下のいずれかのオプションを選択します。
   + **変更されたデータのみを転送する**
   + **すべてのデータを転送する**

   これらのパラメータの詳細については「[転送モードのオプション](#task-option-transfer-mode)」を参照してください。

1. ソースに存在しないファイルまたはオブジェクトを転送先の場所で DataSync に保持するには、**[削除されたファイルを保持する]** を選択します。

   このオプションを選択せず​​、タスクが Amazon S3 バケットからオブジェクトを削除した場合、特定のストレージクラスに対して最小ストレージ期間料金が発生する可能性があります。詳細については、「[Amazon S3 転送におけるストレージクラスに関する考慮事項](create-s3-location.md#using-storage-classes)」を参照してください。
**警告**  
このオプションを選択解除して [**Transfer all data (すべてのデータを転送)**] を有効にすることはできません。すべてのデータを転送すると、DataSync は転送先の場所をスキャンしないため、何を削除すればよいかがわかりません。

1. ソースデータまたはメタデータが変更されたときに DataSync に転送先のデータを変更する場合は、**[ファイルを上書きする]** を選択します。

   タスクがオブジェクトを上書きする場合、特定のストレージクラスに対して追加料金が発生する可能性があります (たとえば、取得や早期削除など)。詳細については、「[Amazon S3 転送におけるストレージクラスに関する考慮事項](create-s3-location.md#using-storage-classes)」を参照してください。

   このオプションを選択しない場合、転送先のデータが異なっていても転送先のデータは上書きされません。

1. **[転送オプション]** で、DataSync がメタデータを処理する方法を選択します。オプションの詳細については、「[メタデータ処理オプション](#task-option-metadata-handling)」を参照してください。
**重要**  
コンソールに表示されるオプションは、タスクの送信元と送信先の場所によって異なります。これらのオプションの一部は、表示するために **[追加の設定]** を展開する必要がある場合があります。
   + **所有権のコピー**
   + **権限のコピー**
   + **タイムスタンプのコピー**
   + **オブジェクトタグのコピー**
   + **所有権、DACL、SACL のコピー**
   + **所有権と DACL のコピー**
   + **所有権や ACL をコピーしない**

### DataSync API の使用
<a name="configure-file-metadata-options-api"></a>

次のいずれかのオペレーションで `Options` パラメータを使用して、ファイル、オブジェクト、メタデータの処理オプションを設定できます。
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)