UpdateTask - AWS DataSync

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

UpdateTask

更新與任務相關聯的中繼資料。

請求語法

{ "CloudWatchLogGroupArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "Name": "string", "Options": { "Atime": "string", "BytesPerSecond": number, "Gid": "string", "LogLevel": "string", "Mtime": "string", "OverwriteMode": "string", "PosixPermissions": "string", "PreserveDeletedFiles": "string", "PreserveDevices": "string", "SecurityDescriptorCopyFlags": "string", "TaskQueueing": "string", "TransferMode": "string", "Uid": "string", "VerifyMode": "string" }, "Schedule": { "ScheduleExpression": "string" }, "TaskArn": "string" }

請求參數

如需所有動作常見的參數相關資訊,請參閱一般參數

請求接受採用 JSON 格式的下列資料。

CloudWatchLogGroupArn

Amazon Resource Name (ARN) 的資源名稱。

類型:字串

長度限制:長度上限為 562。

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]*:[0-9]{12}:log-group:([^:\*]*)(:\*)?$

必要:否

Excludes

篩選規則清單,可決定要從任務中排除的檔案。清單應該包含單一篩選字串,其中包含要排除的模式。模式以 "|" (也就是管道) 分隔,例如 "/folder1|/folder2"

類型:陣列FilterRule對象

陣列成員:項目數下限為 0。項目數上限為 1。

必要:否

Includes

篩選規則清單,可決定執行任務時要包含的檔案。此模式包含單一篩選字串,其中包含要包含的模式。模式以 "|" (也就是管道) 分隔,例如 "/folder1|/folder2"

類型:陣列FilterRule對象

陣列成員:項目數下限為 0。項目數上限為 1。

必要:否

Name

要更新的任務名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 256。

模式:^[a-zA-Z0-9\s+=._:@/-]+$

必要:否

Options

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

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

類型:Options 物件

必要:否

Schedule

指定用於定期將檔案從來源傳輸到目的地位置的排程。您可以將工作設定為每小時、每日、每週或每週的特定日期執行。您可以控制要執行工作的日期或小時的時間。您指定的時間是 UTC 時間。如需詳細資訊,請參閱「」排程您的任務

類型:TaskSchedule 物件

必要:否

TaskArn

要更新的任務資源名稱 Amazon Resource Name (ARN)。

類型:字串

長度限制:長度上限為 128。

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}$

必要:是

回應元素

如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。

Errors

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

InternalException

當錯誤發生時,就會擲出此例外狀況AWS DataSync服務。

HTTP 狀態碼:500

InvalidRequestException

當客戶提交格式錯誤的請求時,就會擲出此例外狀況。

HTTP 狀態碼:400

另請參閱

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