本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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",
"ObjectTags": "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) Amazon Resource Name (ARN) Amazon Resource Name (ARN) Amazon Resource NameCloudWatch (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
-
指定在傳輸期間排除特定資料的篩選規則清單。如需詳細資訊和範例，請參閱篩選傳輸的資料DataSync。
類型：FilterRule 物件陣列
陣列成員：項目數下限為 0。項目數上限為 1。
必要：否
- Includes
-
指定在傳輸期間包含特定資料的篩選規則清單。如需詳細資訊和範例，請參閱篩選傳輸的資料DataSync。
類型：FilterRule 物件陣列
陣列成員：項目數下限為 0。項目數上限為 1。
必要：否
- Name
-
要更新任務的名稱。
類型：字串
長度限制：長度下限為 1。長度上限為 256。
模式：
^[a-zA-Z0-9\s+=._:@/-]+$必要：否
- Options
-
設定您的AWS DataSync工作設定。這些選項包括如何DataSync處理檔案、物件及其關聯的中繼資料。您也可以指定如何DataSync驗證資料完整性、設定工作的頻寬限制以及其他選項。
每個任務設定都有預設值。除非您需要，否則
Options在開始任務之前不必配置任何這些設置。類型：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 回應。
錯誤
如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。
- InternalException
-
當在AWS DataSync服務中發生錯誤時，拋出此異常。
HTTP 狀態碼：500
- InvalidRequestException
-
當客戶端提交格式錯誤的請求時，拋出此異常。
HTTP 狀態碼：400
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
