Options - AWS DataSync
目錄另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Options

設定您的AWS DataSync工作設定。這些選項包括如何DataSync處理檔案、物件及其關聯的中繼資料。您也可以指定如何DataSync驗證資料完整性、設定工作的頻寬限制以及其他選項。

每個任務設定都有預設值。除非您需要，否則Options在開始任務之前不必配置任何這些設置。

目錄

Atime

指定是否保留指示上次讀取或寫入檔案時的中繼資料。如果您Atime將設定為BEST_EFFORT，則會DataSync嘗試保留所有來源檔案 (即任務執行PREPARING階段之前的版本) 上的原始Atime屬性。

注意

跨平台的行為Atime並非完全標準，因此只DataSync能盡可能執行此操作。

預設值：BEST_EFFORT

BEST_EFFORT：嘗試保留每個檔案的 Atime 值 (建議)。

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)。

如需詳細資訊，請參閱複製的中繼資料DataSync。

預設值：INT_VALUE。這會保留 ID 的整數值。

INT_VALUE：保留使用者 ID (UID) 和 GID 的整數值值 (建議)。

NONE：忽略 UID 和 GID。

類型：字串

有效值: NONE | INT_VALUE | NAME | BOTH

必要：否

LogLevel

指定DataSync發佈至 Amazon 日誌群組的CloudWatch日誌類型。若要指定記錄群組，請參閱CloudWatchLogGroupArn。

如果將 LogLevel 設定為 OFF，則不會發佈任何日誌。BASIC 會針對傳輸的個別檔案發佈錯誤日誌，而 TRANSFER 會針對傳輸並檢查完整性的每個檔案或物件發佈日誌。

類型：字串

有效值: OFF | BASIC | TRANSFER

必要：否

Mtime

指定是否保留指示任務執行PREPARING階段之前上次寫入檔案的中繼資料。當您需要多次執行任務時，需要使用此選項。

預設值：PRESERVE

PRESERVE：保留原始 Mtime (建議)

NONE：忽略 Mtime。

注意

如果 Mtime 設定為 PRESERVE，Atime 必須設定為 BEST_EFFORT。

如果將 Mtime 設定為 NONE，則 Atime 也必須設定為 NONE。

類型：字串

有效值: NONE | PRESERVE

必要：否

ObjectTags

指定在物件儲存系統之間傳輸時，是否保留物件標籤。如果您希望DataSync任務忽略物件標籤標籤，請指定NONE值。

預設值：PRESERVE

類型：字串

有效值: PRESERVE | NONE

必要：否

OverwriteMode

指定是否應覆寫或保留目的地位置的資料。舉例來說，如果設定為 NEVER，則目的地檔案不會遭來源檔案取代 (即使目的地檔案與來源檔案不同)。如果您修改目的地中的檔案並同步檔案，則可以使用該值來防止覆寫這些變更。

有些儲存類別的特定行為可能會影響 Amazon S3 儲存成本。如需詳細資訊，請參閱在中使用 Amazon S3 儲存類別時的考量事項DataSync。

類型：字串

有效值: ALWAYS | NEVER

必要：否

PosixPermissions

指定哪些使用者或群組可以針對特定用途 (例如讀取、寫入或執行檔案) 存取檔案。

如需詳細資訊，請參閱複製的中繼資料DataSync。

預設值：PRESERVE

PRESERVE：保留 POSIX 樣式許可 (建議)。

NONE︰忽略許可。

注意

AWS DataSync 可以保留來源位置的現存許可。

類型：字串

有效值: NONE | PRESERVE

必要：否

PreserveDeletedFiles

指定是否應保留目的地位置不存在的檔案。此選項可能會影響 Amazon S3 儲存成本。如果您的任務會刪除物件，您可能需要支付特定儲存方案的最低儲存持續期間費用。如需詳細資訊，請參閱在中使用 Amazon S3 儲存類別時的考量事項DataSync。

預設值：PRESERVE

PRESERVE：忽略此類目的地檔案 (建議)。

REMOVE：刪除來源中不存在的目的地檔案。

注意

如果將此參數設定為REMOVE，則無法TransferMode將設定為ALL。傳輸所有數據時，DataSync不會掃描目標位置，也不知道要刪除的內容。

類型：字串

有效值: PRESERVE | REMOVE

必要：否

PreserveDevices

指定是否DataSync應在來源位置保留區塊和字元裝置的中繼資料，並在目的地上重新建立使用該裝置名稱和中繼資料的檔案。DataSync只會複製此類裝置的名稱和中繼資料。

注意

DataSync無法複製這些裝置的實際內容，因為非終端，並且不會傳回 e nd-of-file (EOF) 標記。

預設值：NONE

NONE：忽略特殊裝置 (建議)。

PRESERVE：保留字元和區塊型儲存裝置中繼資料。此選項目前不支援 Amazon EFS。

類型：字串

有效值: NONE | PRESERVE

必要：否

SecurityDescriptorCopyFlags

指定 SMB 安全性描述項的哪些元件會從來源物件複製到目的地物件。

此值僅用於 SMB 和 Amazon FSx for Windows File Server 位置之間或是兩個 FSx for Windows File Server 位置之間的傳輸。如需詳細資訊，請參閱如何DataSync處理中繼資料。

預設值：OWNER_DACL

OWNER_DACL：針對複製的每個物件複製下列中繼資料：DataSync

  • 物件擁有者。

  • NTFS 判別存取控制清單 (DACL)，可決定是否要授與物件存取權。

    DataSync使用此選項不會複製 NTFS 系統存取控制清單 (SACL)。

OWNER_DACL_SACL：針對複製的每個物件複製下列中繼資料：DataSync

  • 物件擁有者。

  • NTFS 判別存取控制清單 (DACL)，可決定是否要授與物件存取權。

  • SACL，系統管理員用來記錄存取受保護物件的嘗試。

    複製 SACL 需要向用來存取 SMB 位置的 Windows DataSync 使用者授與額外許可。如需有關選擇使用者以確保對檔案、資料夾和中繼資料之足夠許可的資訊，請參閱使用者。

NONE：未複製任何 SMB 安全性描述項元件。目標物件由提供用於存取目的地位置的使用者所擁有。DACL 和 SACL 根據目的地伺服器的組態而設定。

類型：字串

有效值: NONE | OWNER_DACL | OWNER_DACL_SACL

必要：否

TaskQueueing

指定在執行多項工作時，在某些情況下，是否應將傳送任務放入佇列中。這是ENABLED默認情況下。

類型：字串

有效值: ENABLED | DISABLED

必要：否

TransferMode

確定是否僅DataSync傳輸來源和目的地位置之間不同的資料和中繼資料，或者來源的所有內容 (而不與目的地內容進行比較)。

CHANGED：僅會DataSync將新內容或不同內容的資料或不同內容的資料或中繼資料從來源位置複製到目的地位置。

ALL：DataSync將所有來源位置內容複製到目的地內容 (不與目的地中的內容)。

類型：字串

有效值: CHANGED | ALL

必要：否

Uid

指定檔案擁有者的 POSIX 使用者 ID (UID)。

如需詳細資訊，請參閱複製的中繼資料DataSync。

預設值：INT_VALUE。這會保留 ID 的整數值。

INT_VALUE：保留 UID 和群組 ID (GID) 的整數值值值 (建議)。

NONE：忽略 UID 和 GID。

類型：字串

有效值: NONE | INT_VALUE | NAME | BOTH

必要：否

VerifyMode

指定在傳輸期間DataSync檢查資料完整性的方式和時機。

預設值：POINT_IN_TIME_CONSISTENT

ONLY_FILES_TRANSFERRED(建議)：在來源位置DataSync計算已傳輸檔案和中繼資料的總和檢查碼。在傳輸結束時，DataSync將此總和檢查碼與目的地檔案上計算的總和檢查碼進行比較。

在傳輸至 S3 Glacier Deep Archive 儲存類別時，我們建議使用此選項。如需詳細資訊，請參閱 Amazon S3 位置的儲存類別考量事項。

POINT_IN_TIME_CONSISTENT：在傳輸結束時，DataSync掃描整個來源和目的地，以驗證兩個位置是否完全同步。

傳輸至 S3 Glacier Deep Archive 儲存類別時，無法使用此選項。如需詳細資訊，請參閱 Amazon S3 位置的儲存類別考量事項。

NONE：在傳輸結束時DataSync不運行其他驗證。在傳輸期間，所有資料傳輸仍會透過檢查總和驗證進行完整性檢查。

類型：字串

有效值: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

必要：否

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：