Options - AWS DataSync

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

Options

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

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

內容

Atime

顯示上次存取檔案 (即讀取或寫入檔案時) 的檔案中繼資料值。如果您設置AtimeBEST_EFFORT、 DataSync 嘗試保留原始Atime所有來源檔案 (即之前的版本)PREPARING階段)。但是,Atime的行為並非是完全標準的,因此AWS DataSync只能在盡可能執行此操作。

預設值:BEST_EFFORT

BEST_EFFORT:保留每個檔案Atime值 (建議使用)。

NONE:忽略Atime

注意

如果Atime已設定為BEST_EFFORTMtime必須設定為PRESERVE

如果Atime已設定為NONEMtime也必須是NONE

類型:字串

有效值: NONE | BEST_EFFORT

必要:否

BytesPerSecond

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

類型:Long

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

必要:否

Gid

檔案擁有者的 POSIX 群組 ID (GID)。

如需詳細資訊,請參閱「」複製的中繼資料 DataSync

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

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

NONE:忽略 UID 和 GID。

類型:字串

有效值: NONE | INT_VALUE | NAME | BOTH

必要:否

LogLevel

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

類型:字串

有效值: OFF | BASIC | TRANSFER

必要:否

Mtime

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

預設值: PRESERVE

PRESERVE:原始Mtime(建議)

NONE:忽略Mtime

注意

如果Mtime已設定為PRESERVEAtime必須設定為BEST_EFFORT

如果Mtime已設定為NONEAtime也必須設定為NONE

類型:字串

有效值: NONE | PRESERVE

必要:否

ObjectTags

指定在物件儲存系統之間傳輸時,是否要保留物件標籤。如果你想要你的 DataSync 要忽略物件標籤的工作,請指定NONE值。

預設值: PRESERVE

類型:字串

有效值: PRESERVE | NONE

必要:否

OverwriteMode

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

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

類型:字串

有效值: ALWAYS | NEVER

必要:否

PosixPermissions

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

如需詳細資訊,請參閱「」複製的中繼資料 DataSync

預設值:PRESERVE

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

NONE:忽略許可。

注意

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

類型:字串

有效值: NONE | PRESERVE

必要:否

PreserveDeletedFiles

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

預設值:PRESERVE

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

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

類型:字串

有效值: PRESERVE | REMOVE

必要:否

PreserveDevices

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

注意

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

預設值:NONE

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

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

類型:字串

有效值: NONE | PRESERVE

必要:否

SecurityDescriptorCopyFlags

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

此值僅適用於 SMB 和亞馬遜 FSx (適用於 Windows 檔案伺服器位置) 之間的傳輸,或在兩個適用於 Windows 檔案伺服器位置的 Amazon FSx 之間進行傳輸。如需操作說明的詳細資訊 DataSync 處理中繼資料,請參閱操作說明 DataSync 處理中繼資料和特殊檔案

預設值:OWNER_DACL

OWNER_DACL:對於每個複製的物件, DataSync 複製下列中繼資料:

  • 物件擁有者。

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

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

OWNER_DACL_SACL:對於每個複製的物件, DataSync 複製下列中繼資料:

  • 物件擁有者。

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

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

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

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

類型:字串

有效值: NONE | OWNER_DACL | OWNER_DACL_SACL

必要:否

TaskQueueing

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

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

類型:字串

有效值: ENABLED | DISABLED

必要:否

TransferMode

用來決定是否必要的值 DataSync 只會傳輸來源和目的地位置之間不同的資料和中繼資料,或者是否傳輸來源和目的地位置之間 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

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

預設值:POINT_IN_TIME_CONSISTENT

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

POINT_IN_TIME_CONSISTENT:在傳輸結束時掃描整個來源和整個目的地,以驗證來源和目的地是否完全同步。傳輸至 S3 Glacier Deep Archive 儲存體方案或 S3 Glacier Deep Archive 儲存體方案或 S3 Glacier Deep Archive

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

類型:字串

有效值: POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE

必要:否

另請參閱

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