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

# Options
<a name="API_Options"></a>

転送タスクがどのように構成されているかを示します。これらのオプションには、転送中に DataSync がファイル、オブジェクト、および関連するメタデータを処理する方法が含まれます。また、データの整合性の検証方法や、タスクの帯域幅制限の設定方法なども指定できます。

各オプションにはデフォルト値があります。必要な場合を除き、[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) を呼び出す前にこれらのオプションを設定する必要はありません。

これらのタスクオプションは各タスクを実行するたびにオーバーライドできます。例えば、個々の実行に合わせて `LogLevel` を調整することができます。

## 内容
<a name="API_Options_Contents"></a>

 ** Atime **   <a name="DataSync-Type-Options-Atime"></a>
ファイルに読み取りまたは書き込みが行われた最終日時を示すメタデータを保存するかどうかを指定します。  
ただし、`Atime` の動作はプラットフォーム間の完全な標準ではないため、DataSync はあくまでベストエフォートベースでこれを行います。
+  `BEST_EFFORT` (デフォルト) - DataSync はすべてのソースファイルで元の `Atime` 属性を保持しようとします (つまり、タスク実行の `PREPARING` ステップより前のバージョン)。このオプションは推奨されています。
+  `NONE` - `Atime` を無視します。
`Atime` が `BEST_EFFORT` に設定されている場合は `Mtime` は `PRESERVE` に設定する必要があります。  
`Atime` が `NONE` に設定されている場合は `Mtime` も `NONE` に設定する必要があります。
型: 文字列  
有効な値：`NONE | BEST_EFFORT`  
必須: いいえ

 ** BytesPerSecond **   <a name="DataSync-Type-Options-BytesPerSecond"></a>
DataSync タスクで使用される帯域幅を制限します。例えば、DataSync で最大 1 MB を使用する場合は、この値を `1048576` (`=1024*1024`) に設定します。  
型: 長整数  
有効な範囲: 最小値は -1 です。  
必須: いいえ

 ** Gid **   <a name="DataSync-Type-Options-Gid"></a>
ファイル所有者の POSIX グループ ID (GID) を指定します。  
+  `INT_VALUE` (デフォルト) - ユーザー ID (UID) と GID の整数値を保持します (推奨)。
+  `NONE` - UID と GID を無視します。
詳細については、「[Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)」を参照してください。  
型: 文字列  
有効な値：`NONE | INT_VALUE | NAME | BOTH`  
必須: いいえ

 ** LogLevel **   <a name="DataSync-Type-Options-LogLevel"></a>
DataSync が Amazon CloudWatch Logs ロググループに公開する、ログのタイプを指定します。ロググループを指定するには、「[CloudWatchLogGroupAn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn)」を参照してください。  
+  `BASIC` - 基本情報 (転送エラーなど) のみを含むログを発行します。
+  `TRANSFER` - DataSync タスクが転送するすべてのファイルまたはオブジェクトのログを発行し、データ整合性チェックを実行します。
+  `OFF` - ログは公開されません。
型: 文字列  
有効な値：`OFF | BASIC | TRANSFER`  
必須：いいえ

 ** Mtime **   <a name="DataSync-Type-Options-Mtime"></a>
タスク実行の `PREPARING` ステップより前にファイルに書き込みが行われた日時を示すメタデータを保存するかどうかを指定します。このオプションは、タスクを複数回実行する必要がある場合に必要です。  
+  `PRESERVE` (デフォルト) - 元の `Mtime` を保持します (推奨)。
+  `NONE` - `Mtime` を無視。
`Mtime` が `PRESERVE` に設定されている場合は `Atime` は `BEST_EFFORT` に設定する必要があります。  
`Mtime` が `NONE` に設定されている場合は `Atime` も `NONE` に設定する必要があります。
型: 文字列  
有効な値：`NONE | PRESERVE`  
必須: いいえ

 ** ObjectTags **   <a name="DataSync-Type-Options-ObjectTags"></a>
オブジェクトストレージシステム間でデータを転送するときに DataSync を `PRESERVE` オブジェクトタグ (デフォルトの動作) にするかどうかを指定します。DataSync タスクでオブジェクトタグを無視する場合は、`NONE` 値を指定します。  
型: 文字列  
有効な値：`PRESERVE | NONE`  
必須: いいえ

 ** OverwriteMode **   <a name="DataSync-Type-Options-OverwriteMode"></a>
DataSync が送信先のデータを上書きするか保存するかを指定します。  
+  `ALWAYS` (デフォルト) - ソースデータ (メタデータを含む) が変更されると、DataSync が送信先の場所のデータを変更します。

  DataSync がオブジェクトを上書きする場合、特定の Amazon S3 ストレージクラスに対して追加料金が発生する可能性があります (例えば、取得や早期削除など)。詳細については、「[Storage class considerations with Amazon S3 transfers](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。
+  `NEVER` - DataSync は、ソースデータが変更された場合でも、送信先の場所のデータを上書きしません。このオプションを使用して、送信先のファイルまたはオブジェクトに加えらえた変更の上書きがされないように保護できます。
型: 文字列  
有効な値：`ALWAYS | NEVER`  
必須: いいえ

 ** PosixPermissions **   <a name="DataSync-Type-Options-PosixPermissions"></a>
ファイルの読み取り、書き込み、実行などの特定の目的でファイルにアクセスできるユーザーまたはグループを指定します。  
詳細については、「[Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)」を参照してください。  
+  `PRESERVE` (デフォルト) - POSIX スタイルのアクセス許可を保持します (推奨)。
+  `NONE` - POSIX スタイルのアクセス許可を無視します。
DataSync は、ソースの場所の現存のアクセス許可を保持できます。
型: 文字列  
有効な値：`NONE | PRESERVE`  
必須: いいえ

 ** PreserveDeletedFiles **   <a name="DataSync-Type-Options-PreserveDeletedFiles"></a>
ソースに存在しない宛先の場所にあるファイルを保存するかどうかを指定します。このオプションは、Amazon S3 ストレージのコストに影響します。タスクでオブジェクトを削除すると、特定のストレージクラスに対して最小ストレージ期間料金が発生する可能性があります。詳細については、「[Considerations when working with Amazon S3 storage classes in DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。  
+  `PRESERVE` (デフォルト) - このような送信先ファイルを無視します (推奨)。
+  `REMOVE` - ソース内に存在しない送信先ファイルを削除します。
このパラメータを `REMOVE` に設定した場合、`TransferMode` を `ALL` に設定することはできません。すべてのデータを転送すると、DataSync は送信先の場所をスキャンしないため、何を削除すればよいかわかりません。
型: 文字列  
有効な値：`PRESERVE | REMOVE`  
必須: いいえ

 ** PreserveDevices **   <a name="DataSync-Type-Options-PreserveDevices"></a>
DataSync がソースの場所にブロックデバイスとキャラクターデバイスのメタデータを保存し、そのデバイス名とメタデータを使用して宛先にファイルを再作成するかどうかを指定します。DataSync は、そのようなデバイスの名前とメタデータのみをコピーします。  
DataSync は、こうしたデバイスの実際のコンテンツをコピーすることはできません。これらは非終端であり、ファイルの終わり (EOF) マーカーを返さないためです。
+  `NONE` (デフォルト) - 特殊デバイスを無視します (推奨)。
+  `PRESERVE` - キャラクターとブロックデバイスのメタデータを保持します。このオプションは、Amazon EFS では現在サポートされていません。
型: 文字列  
有効な値：`NONE | PRESERVE`  
必須: いいえ

 ** SecurityDescriptorCopyFlags **   <a name="DataSync-Type-Options-SecurityDescriptorCopyFlags"></a>
SMB セキュリティ記述子のどのコンポーネントをソースオブジェクトから送信先オブジェクトにコピーするかを決定する値。  
この値は、SMB と Amazon FSx for Windows File Server の場所との間、または 2 つの FSx for Windows File Server の場所との間の転送にのみ使用されます。詳細については、「[Understanding how DataSync handles file and object metadata](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)」を参照してください。  
+  `OWNER_DACL` (デフォルト) - DataSync は、コピーされたオブジェクトごとに、次のメタデータをコピーします。
  + オブジェクトの所有者
  + NTFS 任意アクセスコントロールリスト (DACLs) は、オブジェクトへのアクセスを許可するかどうかを決定します。

    このオプションでは DataSync は NTFS システムアクセス制御リスト (SACL) をコピーしません。
+  `OWNER_DACL_SACL` - DataSync は、コピーされたオブジェクトごとに、次のメタデータをコピーします。
  + オブジェクトの所有者
  + NTFS 任意アクセスコントロールリスト (DACLs) は、オブジェクトへのアクセスを許可するかどうかを決定します。
  + SACL は管理者が保護されたオブジェクトへのアクセス試行を記録するために使用します。

    SACL をコピーするには、DataSync が SMB ロケーションにアクセスするために使用する Windows ユーザーに追加のアクセス許可を付与する必要があります。適切なアクセス許可を持つユーザーを選択する方法については、[SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)、[FSx for Windows File Server ](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions)、または [FSx for ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) に必要なアクセス許可を参照してください (転送の場所のタイプによって異なります)。
+  `NONE` - SMB セキュリティ記述子コンポーネントはコピーされません。デスティネーションオブジェクトは、送信先の場所にアクセスするために提供されたユーザーが所有します。DACLs と SACLs は、送信先サーバーの設定に基づいて設定されます。
型: 文字列  
有効な値：`NONE | OWNER_DACL | OWNER_DACL_SACL`  
必須: いいえ

 ** TaskQueueing **   <a name="DataSync-Type-Options-TaskQueueing"></a>
[複数のタスクを実行する](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks)特定のシナリオで、転送タスクをキューに入れるかどうかを指定します。デフォルトでは、`ENABLED` です。  
型: 文字列  
有効な値：`ENABLED | DISABLED`  
必須：いいえ

 ** TransferMode **   <a name="DataSync-Type-Options-TransferMode"></a>
DataSync が、タスクを実行するたびに、最初のコピー後に場所間で異なるデータ (メタデータを含む) のみを転送するか、すべてのデータを転送するかを指定します。定期的に転送を行う予定の場合は、前回のタスク実行以降に変更されたもののみを転送することをお勧めします。  
+  `CHANGED` (デフォルト) - 最初の完全転送後、DataSync は送信元と送信先の場所で異なるデータとメタデータのみをコピーします。
+  `ALL` - DataSync は、場所間の違いを比較せずに、ソースのすべてを送信先にコピーします。
型: 文字列  
有効な値：`CHANGED | ALL`  
必須: いいえ

 ** Uid **   <a name="DataSync-Type-Options-Uid"></a>
ファイル所有者の POSIX ユーザー ID (UID) を指定します。  
+  `INT_VALUE` (デフォルト) - UID とグループ ID (GID) の整数値を保持します (推奨)。
+  `NONE` - UID と GID を無視します。
詳細については、「[Metadata copied by DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied)」を参照してください。  
型: 文字列  
有効な値：`NONE | INT_VALUE | NAME | BOTH`  
必須：いいえ

 ** VerifyMode **   <a name="DataSync-Type-Options-VerifyMode"></a>
DataSync が転送終了時にデータの整合性をチェックするかどうかと、その方法を指定します。  
+  `ONLY_FILES_TRANSFERRED` (推奨) – DataSync は、送信元の場所で転送されたデータ (メタデータを含む) のチェックサムを計算します。転送終了時に、DataSync はこのチェックサムを送信先のデータで計算されたチェックサムと比較します。
**注記**  
これは[拡張モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)のデフォルトのオプションです。

  S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive ストレージクラスに転送する場合は、このオプションをお勧めします。詳細については、「[Storage class considerations with Amazon S3 locations](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。
+  `POINT_IN_TIME_CONSISTENT` - 転送の終了時に、DataSync は送信元全体と送信先全体をチェックし、両方の場所が完全に同期されていることを確認します。
**注記**  
これは[基本モードタスク](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)のデフォルトオプションであり、現在拡張モードタスクではサポートされていません。

  [マニフェスト](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)を使用する場合、DataSync はマニフェストにリストされているもののみをスキャンおよび検証します。

  S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive ストレージクラスに転送する場合は、このオプションは使用できません。詳細については、「[Storage class considerations with Amazon S3 locations](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)」を参照してください。
+  `NONE` - DataSync は転送中にのみデータ整合性チェックを実行します。他のオプションとは異なり、転送の終了時に追加の検証はありません。
型: 文字列  
有効な値：`POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE`  
必須: いいえ

## 以下の資料も参照してください。
<a name="API_Options_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options)