本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Options 指明您的传输任务是如何配置的。这些选项包括在传输过程中如何 DataSync 处理文件、对象及其关联的元数据。您还可以指定如何验证数据完整性、为任务设置带宽限制等其他选项。 每个选项都有一个默认值。除非需要，否则无需在拨打电话之前配置任何选项[StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)。 您还可以在每次执行任务时覆盖任务选项。例如，您可能希望为单次执行调整 `LogLevel`。 ## 内容 ** Atime ** 指定是否保留表示上次文件被读取或写入的时间的元数据。 的行为在各个平台上`Atime`并不完全标准，因此 DataSync 只能在尽力而为的基础上做到这一点。 + `BEST_EFFORT`（默认）- DataSync 尝试保留所有源文件的原始`Atime`属性（即任务执行`PREPARING`步骤之前的版本）。建议使用该选项。 + `NONE`：忽略 `Atime`。 如果 `Atime` 被设置为 `BEST_EFFORT`，则 `Mtime` 必须被设置为 `PRESERVE`。 如果 `Atime` 设置为 `NONE`，则 `Mtime` 也必须为 `NONE`。 类型：字符串 有效值：`NONE | BEST_EFFORT` 必需：否 ** BytesPerSecond ** 限制 DataSync 任务使用的带宽。例如，如果您 DataSync 想使用最大 1 MB 的空间，请将此值设置为 `1048576` (`=1024*1024`)。 类型：长整型 有效范围：最小值为 -1。 必需：否 ** Gid ** 指定文件拥有者的 POSIX 组 ID (GID)。 + `INT_VALUE`（默认）：保留用户 ID（UID）和 GID 的整数值，建议使用。 + `NONE`：忽略 UID 和 GID。 有关更多信息，请参阅[了解如何 DataSync 处理文件和对象元数据](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)。 类型：字符串 有效值：`NONE | INT_VALUE | NAME | BOTH` 必需：否 ** LogLevel ** 指定 DataSync 发布到 Amazon CloudWatch 日志组的日志类型。要指定日志组，请参阅[CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn)。 + `BASIC`：仅发布包含基本信息（如传输错误）的日志。 + `TRANSFER`-发布 DataSync 任务传输的所有文件或对象的日志，并对其执行数据完整性检查。 + `OFF`：未发布任何日志。 类型：字符串 有效值：`OFF | BASIC | TRANSFER` 必需：否 ** Mtime ** 指定是否保留表示上次文件在任务执行的 `PREPARING` 步骤之前被读取或写入时的元数据。当您需要多次运行任务时，必须使用此选项。 + `PRESERVE`（默认）：保留原始 `Mtime`，建议使用。 + `NONE`：忽略 `Mtime`。 如果 `Mtime` 被设置为 `PRESERVE`，则 `Atime` 必须被设置为 `BEST_EFFORT`。 如果 `Mtime` 被设置为 `NONE`，则 `Atime` 也必须被设置为 `NONE`。 类型：字符串 有效值：`NONE | PRESERVE` 必需：否 ** ObjectTags ** 指定在`PRESERVE`对象存储系统之间传输时是否 DataSync 要对标签进行对象化（默认行为）。如果您希望 DataSync 任务忽略对象标签，请指定该`NONE`值。 类型：字符串 有效值：`PRESERVE | NONE` 必需：否 ** OverwriteMode ** 指定是 DataSync 应该修改还是保留目标位置的数据。 + `ALWAYS`（默认）-当源数据（包括元数据）发生变化时， DataSync 修改目标位置的数据。 如果 DataSync 覆盖了对象，则某些 Amazon S3 存储类别（例如，检索或提前删除）可能会产生额外费用。有关更多信息，请参阅 [Amazon S3 传输的存储类别注意事项](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes)。 + `NEVER`-即使源数据已更改，也 DataSync 不会覆盖目标位置的数据。您可以使用此选项防止覆盖对目标位置中文件或对象所做的更改。 类型：字符串 有效值：`ALWAYS | NEVER` 必需：否 ** PosixPermissions ** 用于确定哪些用户或组可以出于特定目的（例如读取、写入或执行文件）访问文件。 有关更多信息，请参阅[了解如何 DataSync 处理文件和对象元数据](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)。 + `PRESERVE`（默认）：保留 POSIX 风格权限，建议使用。 + `NONE`：忽略 POSIX 风格权限。 DataSync 可以保留源位置的现有权限。 类型：字符串 有效值：`NONE | PRESERVE` 必需：否 ** PreserveDeletedFiles ** 指定是否应保留源中不存在的目标位置的文件。此选项可能会影响您的 Amazon S3 存储成本。如果您的任务删除对象，则您可能需要为某些存储类别支付最低存储期限费用。有关详细信息，请参阅中[使用 Amazon S3 存储类时的注意事项 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 ** 指定是否 DataSync 应在源位置保留块和字符设备的元数据，并在目标位置使用该设备名称和元数据重新创建文件。 DataSync 仅复制此类设备的名称和元数据。 DataSync 无法复制这些设备的实际内容，因为它们是非终端设备且不返回 end-of-file (EOF) 标记。 + `NONE`（默认）：忽略特殊设备（推荐）。 + `PRESERVE`：保留字符和块设备元数据。Amazon EFS 目前不支持此选项。 类型：字符串 有效值：`NONE | PRESERVE` 必需：否 ** SecurityDescriptorCopyFlags ** 确定将 SMB 安全描述符的哪些组件是从源复制到目标对象的。 此值仅用于 Windows 文件服务器位置的 SMB 和 Amazon FSx 之间的传输，或者 Windows 文件服务器位置 FSx 的两个位置之间的传输。有关更多信息，请参阅[了解如何 DataSync 处理文件和对象元数据](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)。 + `OWNER_DACL`（默认）-对于每个复制的对象， DataSync 复制以下元数据： + 对象所有者。 + NTFS 自由访问控制列表 (DACLs)，用于确定是否授予对对象的访问权限。 DataSync 不会使用此选项复制 NTFS 系统访问控制列表 (SACLs)。 + `OWNER_DACL_SACL`-对于每个复制的对象， DataSync 复制以下元数据： + 对象所有者。 + NTFS 自由访问控制列表 (DACLs)，用于确定是否授予对对象的访问权限。 + SACLs，管理员使用它们来记录访问安全对象的尝试。 复制 SACLs 需要向用于访问您的 SMB 位置的 DataSync Windows 用户授予其他权限。有关选择具有适当权限的用户的信息，请参阅 [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)、[FSx Windows 文件服务器](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions)或 [FSx 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 ** 指定在[运行多个任务](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks)的特定情形下，是否应该将传输任务放入一个队列。默认情况下，这是 `ENABLED`。 类型：字符串 有效值：`ENABLED | DISABLED` 必需：否 ** TransferMode ** 指定是仅 DataSync 传输初始副本后不同位置的数据（包括元数据），还是每次运行任务时传输所有数据。如果计划进行定期传输，则可能仅需要传输自上次执行任务以来发生更改的内容。 + `CHANGED`（默认）-初次完全传输后，仅 DataSync复制源位置和目标位置不同的数据和元数据。 + `ALL`- DataSync 将源中的所有内容复制到目的地，而不比较位置之间的差异。 类型：字符串 有效值：`CHANGED | ALL` 必需：否 ** Uid ** 指定文件拥有者的 POSIX 用户 ID (UID)。 + `INT_VALUE`（默认）：保留 UID 和组 ID（GID）的整数值，推荐使用。 + `NONE`：忽略 UID 和 GID。 有关更多信息，请参阅[复制的元数据 DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied)。 类型：字符串 有效值：`NONE | INT_VALUE | NAME | BOTH` 必需：否 ** VerifyMode ** 指定在传输结束时是否以及如何 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 存储类时，推荐使用此选项。有关更多信息，请参阅 [Amazon S3 位置的存储类考虑因素](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 存储类时，不支持此选项。有关更多信息，请参阅 [Amazon S3 位置的存储类考虑因素](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` 必需：否 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options)