本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 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`)。 類型：Long 有效範圍：最小值為 -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 Logs 日誌群組的日誌類型。若要指定日誌群組，請參閱 [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 ** 指定您是否希望 DataSync 在`PRESERVE`物件儲存系統之間傳輸時物件標籤 （預設行為）。如果您希望 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 儲存成本。如果您的任務會刪除物件，您可能需要支付特定儲存方案的最低儲存持續期間費用。如需詳細資訊，請參閱[在 DataSync 中使用 Amazon S3 儲存類別時的考量事項](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 安全描述項元件。 此值僅用於 SMB 與 Amazon FSx for Windows File Server 位置之間或兩個 FSx for Windows File Server 位置之間的傳輸。如需詳細資訊，請參閱[了解 DataSync 如何處理檔案和物件中繼資料](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html)。 + `OWNER_DACL` （預設） - 對於每個複製的物件，DataSync 會複製下列中繼資料： + 物件擁有者。 + NTFS 判別存取控制清單 (DACL)，可決定是否要授與物件存取權。 DataSync 不會使用此選項複製 NTFS 系統存取控制清單 SACLs)。 + `OWNER_DACL_SACL` - 對於每個複製的物件，DataSync 會複製下列中繼資料： + 物件擁有者。 + NTFS 判別存取控制清單 (DACL)，可決定是否要授與物件存取權。 + SACLs，管理員用來記錄存取安全物件的嘗試。 複製 SACL 需要向 DataSync 用來存取 SMB 位置的 Windows 使用者授與額外許可。如需有關選擇具有適當許可的使用者的資訊，請參閱 [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions)、適用於 [Windows File Server 的 FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions)或[適用於 ONTAP 的 FSx ](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) 的必要許可 （取決於您傳輸中的位置類型）。 + `NONE` - 不會複製任何 SMB 安全描述項元件。目標物件由提供用於存取目的地位置的使用者所擁有。DACL 和 SACL 根據目的地伺服器的組態而設定。 類型：字串 有效值:`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` 必要：否 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) + [AWS 適用於 Java V2 的 SDK](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)