本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # UpdateTask 更新*任務*的組態，這會定義 AWS DataSync 資料傳輸的位置和方式。 ## 請求語法 ``` { "CloudWatchLogGroupArn": "string", "Excludes": [ { "FilterType": "string", "Value": "string" } ], "Includes": [ { "FilterType": "string", "Value": "string" } ], "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "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", "Status": "string" }, "TaskArn": "string", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "string", "S3BucketArn": "string", "Subdirectory": "string" } }, "ObjectVersionIds": "string", "OutputType": "string", "Overrides": { "Deleted": { "ReportLevel": "string" }, "Skipped": { "ReportLevel": "string" }, "Transferred": { "ReportLevel": "string" }, "Verified": { "ReportLevel": "string" } }, "ReportLevel": "string" } } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** 指定 Amazon CloudWatch 日誌群組的 Amazon Resource Name (ARN)，以監控您的任務。 對於增強型模式任務，您必須使用 `/aws/datasync`做為日誌群組名稱。例如： `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` 如需詳細資訊，請參閱[使用 CloudWatch Logs 監控資料傳輸](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html)。 類型：字串 長度限制：長度上限為 562。 模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` 必要：否 ** [Excludes](#API_UpdateTask_RequestSyntax) ** 指定排除篩選條件，以定義您不希望 DataSync 傳輸之來源位置中的檔案、物件和資料夾。如需詳細資訊和範例，請參閱[使用篩選條件指定 DataSync 傳輸的內容](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)。 類型：[FilterRule](API_FilterRule.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 1。 必要：否 ** [Includes](#API_UpdateTask_RequestSyntax) ** 指定包含篩選條件，以定義您要 DataSync 傳輸之來源位置中的檔案、物件和資料夾。如需詳細資訊和範例，請參閱[使用篩選條件指定 DataSync 傳輸的內容](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)。 類型：[FilterRule](API_FilterRule.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 1。 必要：否 ** [ManifestConfig](#API_UpdateTask_RequestSyntax) ** 設定資訊清單，這是您希望 DataSync 傳輸的檔案或物件清單。如需詳細資訊和組態範例，請參閱[使用資訊清單指定 DataSync 傳輸的內容](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)。 使用此參數時，您的呼叫者身分 （與 DataSync 搭配使用的 IAM 角色） 必須具有 `iam:PassRole`許可。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 政策包含此許可。 若要移除資訊清單組態，請將此參數指定為空白。 類型：[ManifestConfig](API_ManifestConfig.md) 物件 必要：否 ** [Name](#API_UpdateTask_RequestSyntax) ** 指定任務的名稱。 類型：字串 長度限制：長度下限為 0。長度上限為 256。 模式：`^[a-zA-Z0-9\s+=._:@/-]+$` 必要：否 ** [Options](#API_UpdateTask_RequestSyntax) ** 指出傳輸任務的設定方式。這些選項包括 DataSync 如何在傳輸期間處理檔案、物件及其相關聯的中繼資料。您也可以指定如何驗證資料完整性、設定任務的頻寬限制，以及其他選項。 每個選項都有預設值。除非需要，否則您不需要在呼叫 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) 之前設定任何選項。 您也可以覆寫每個任務執行的任務選項。例如，您可能想要調整個別執行`LogLevel`的 。 類型：[Options](API_Options.md) 物件 必要：否 ** [Schedule](#API_UpdateTask_RequestSyntax) ** 指定您希望任務何時執行的排程。如需詳細資訊，請參閱[任務排程](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)。 類型：[TaskSchedule](API_TaskSchedule.md) 物件 必要：否 ** [TaskArn](#API_UpdateTask_RequestSyntax) ** 指定您要更新之任務的 ARN。 類型：字串 長度限制：長度上限為 128。 模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 必要：是 ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) ** 指定您要如何設定任務報告，以提供 DataSync 傳輸的詳細資訊。如需詳細資訊，請參閱[使用任務報告監控 DataSync 傳輸](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)。 使用此參數時，您的呼叫者身分 （與 DataSync 搭配使用的 IAM 角色） 必須具有 `iam:PassRole`許可。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 政策包含此許可。 若要移除任務報告組態，請將此參數指定為空白。 類型：[TaskReportConfig](API_TaskReportConfig.md) 物件 必要：否 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalException ** 當服務發生錯誤時，就會擲出此 AWS DataSync 例外狀況。 HTTP 狀態碼：500 ** InvalidRequestException ** 當用戶端提交格式不正確的請求時，會擲回此例外狀況。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask)