Options - AWS DataSync

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

Options

表示可用於控制行為的選項StartTaskExecutionoperation. 行為包括保留使用者 ID (UID)、群組 ID (GID) 和檔案許可等中繼資料,以及覆寫目的地中的檔案、資料完整性驗證等。

任務具有一組與其關聯的預設選項。如果您沒有在StartTaskExecution,則會使用預設值。您可以藉由在每項任務執行中指定覆寫Options值為StartTaskExecution

Contents

Atime

顯示上次存取檔案 (即讀取或寫入檔案時) 的檔案中繼資料值。如果您將 Atime 設定為 BEST_EFFORT,DataSync 會嘗試保留所有來源檔案 (即 PREPARING 階段之前的版本) 上的原始 Atime 屬性。然而,Atime的行為並非是跨平台的完全標準的,因此AWS DataSync只能在最佳努力的基礎上做到這一點。

預設值:最好的努力。

最好的努力 (_I):嘗試保留每個檔案的每個檔案Atime值 (建議使用)。

NONE:IgnoreAtime

注意

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

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

類型:字串

有效值: NONE | BEST_EFFORT

必要:否

BytesPerSecond

限制所用頻寬的值AWS DataSync。例如,如果您需要AWS DataSync若要使用最多 1 MB,則將該值設定為1048576(=1024*1024

類型:Long

有效範圍:最小值為-1。

必要:否

Gid

檔案擁有者的 POSIX 群組 ID (GID)。只能針對 NFS、EFS 和 S3 位置設定此選項。如需 DataSync 會複製哪些中繼資料的詳細資訊,請參閱DataSync 複製的中繼資料

預設值:INT_值。這會保留 ID 的整數值。

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

NONE:忽略 UID 和 GID。

類型:字串

有效值: NONE | INT_VALUE | NAME | BOTH

必要:否

LogLevel

該值確定 DataSync 發佈至您提供的 Amazon CloudWatch 日誌群組中日誌串流的日誌類型。如需有關提供 DataSync 日誌群組的詳細資訊,請參閱 CloudWatchLogGroupArn。如果設定為 OFF,則不會發佈任何日誌。BASIC 會針對傳輸的個別檔案發佈錯誤日誌,而 TRANSFER 會針對傳輸的每個檔案或物件發佈日誌,並檢查完整性。

類型:字串

有效值: OFF | BASIC | TRANSFER

必要:否

Mtime

指示 PREPARING 階段之前上次修改檔案 (即寫入檔案) 的值。當您需要多次執行相同工作時,需要此選項。

預設值:PRESERVE。

PRESERVE:保留原始Mtime(建議)

NONE:IgnoreMtime

注意

如果將 Mtime 設定為 PRESERVE,則 Atime 必須設定為 BEST_EFFORT。

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

類型:字串

有效值: NONE | PRESERVE

必要:否

OverwriteMode

該值確定複製檔案時應覆寫或保留的目的地檔案。如果設定為 NEVER,則目的地檔案不會遭來源檔案取代,即使目的地檔案與來源檔案不同。如果您修改目的地中的檔案並同步檔案,則可以使用該值來防止覆寫這些變更。

有些儲存方案的特定行為可能會影響 S3 儲存成本。如需詳細資訊,請參閱在 DataSync 中使用 Amazon S3 儲存體方案中的 AWS DataSync使用者指南

類型:字串

有效值: ALWAYS | NEVER

必要:否

PosixPermissions

該值確定哪些使用者或群組可以針對特定用途 (例如讀取、寫入或檔案執行) 來存取檔案。只能針對 NFS、EFS 和 S3 位置設定此選項。如需 DataSync 會複製哪些中繼資料的詳細資訊,請參閱DataSync 複製的中繼資料

預設值:PRESERVE。

PRESERVE:PRESERVE (建議)。

NONE:忽略許可。

注意

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

類型:字串

有效值: NONE | PRESERVE

必要:否

PreserveDeletedFiles

指定是否應保留目的地中不存在於來源檔案系統中的檔案。此選項可能會影響您的儲存成本。如果您的任務會刪除物件,您可能需要支付特定儲存方案的最低儲存持續期間費用。如需詳細資訊,請參閱在 DataSync 中使用 Amazon S3 儲存體方案中的 AWS DataSync使用者指南

預設值:PRESERVE。

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

移除:刪除來源中不存在的目的地檔案。

類型:字串

有效值: PRESERVE | REMOVE

必要:否

PreserveDevices

用來決定是否AWS DataSync應在來源檔案系統中保留區塊和字元裝置的中繼資料,並在目的地上重新建立使用該裝置名稱和中繼資料的檔案。DataSync 不會複製這類裝置的內容,只會複製名稱和中繼資料。

注意

AWS DataSync無法同步此類裝置的實際內容,因為其為非終端,並且不會傳回檔案結束 (EOF) 標記。

預設值:無.

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

PRESERVE:保留字元和封鎖裝置中繼資料。此選項目前不支援 Amazon EFS。

類型:字串

有效值: NONE | PRESERVE

必要:否

SecurityDescriptorCopyFlags

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

此值僅用於在 Windows 檔案伺服器位置的 SMB 和 Amazon FSX 之間傳輸,或在兩個適用於 Windows 檔案伺服器位置的 Amazon FSX 之間傳輸。如需 DataSync 如何處理中繼資料的詳細資訊,請參閱DataSync 如何處理中繼資料和特殊檔案

預設值:擁有者達克爾。

擁有者名稱 (_DACL):針對每個複製的物件,DataSync 會複製下列中繼資料:

  • 物件擁有者。

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

選擇此選項時,DataSync 不會複製 NTFS 系統存取控制清單 (SACL),系統管理員用來記錄存取受保護物件的嘗試。

擁有者名稱:針對每個複製的物件,DataSync 會複製下列中繼資料:

  • 物件擁有者。

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

  • NTFS 系統存取控制清單 (SACL),系統管理員用來記錄存取受保護物件的嘗試。

複製 SACL 需要授與其他權限給 Windows 使用者,讓 DataSync 用來存取您的 SMB 位置。如需選擇確保檔案、資料夾和中繼資料有足夠權限的使用者的詳細資訊,請參閱用戶

沒有:不會複製任何 SMB 安全性描述元元件。目標物件是由提供存取目標位置的使用者所擁有。DACL 和 SACL 是根據目的地伺服器的組態來設定。

類型:字串

有效值: NONE | OWNER_DACL | OWNER_DACL_SACL

必要:否

TaskQueueing

該值確定在執行任務之前任務是否應排入佇列。如果設定為 ENABLED,則任務將會排入佇列。預設為 ENABLED

如果使用相同的代理程式來執行多項任務,則可以啟用要以系列執行的任務。如需詳細資訊,請參閱「」佇列任務執行項目

類型:字串

有效值: ENABLED | DISABLED

必要:否

TransferMode

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

已變更:DataSync 只會將新內容或不同內容的資料或中繼資料從來源位置複製到目的地位置。

全部:DataSync 會將所有來源位置內容複製到目的地,而不與目的地上的現有內容進行比較。

類型:字串

有效值: CHANGED | ALL

必要:否

Uid

檔案擁有者的 POSIX 使用者 ID (UID)。只能針對 NFS、EFS 和 S3 位置設定此選項。若要深入了解 DataSync 會複製哪些中繼資料,請參閱DataSync 複製的中繼資料

預設值:INT_值。這會保留 ID 的整數值。

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

NONE:忽略 UID 和 GID。

類型:字串

有效值: NONE | INT_VALUE | NAME | BOTH

必要:否

VerifyMode

該值確定是否應在傳輸所有資料和中繼資料之後,在任務執行結束時執行資料完整性驗證。如需詳細資訊,請參閱「」設定任務設定

預設值:時間點一致。

ONLFERRED (建議):僅對傳輸的檔案執行驗證。

一致點 (__): 在傳輸結束時掃描整個來源和整個目的地,以驗證來源和目的地是否完全同步化。傳輸至 S3 Glacier 或 S3 Glacier Deep Archive 儲存類別時,不支援此選項。

NONE:在傳輸結束時不會進行額外的驗證,但在傳輸期間,所有資料傳輸均會透過檢查總和驗證來檢查完整性。

類型:字串

有效值: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

必要:否

另請參閱

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