本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # StartTaskExecution 啟動 AWS DataSync 傳輸任務。對於每個任務，您一次只能執行一個任務執行。 任務執行有幾個步驟。如需詳細資訊，請參閱[任務執行狀態](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses)。 **重要** 如果您打算在 Amazon S3 位置之間傳輸資料，請在開始之前檢閱 [ DataSync 如何影響您的 S3 請求費用](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests)和 [DataSync 定價頁面](https://aws.amazon.com/datasync/pricing/)。 ## 請求語法 ``` { "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" } } }, "OverrideOptions": { "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" }, "Tags": [ { "Key": "string", "Value": "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 格式的下列資料。 ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** 指定篩選條件規則清單，以決定要從任務中排除哪些檔案。清單包含單一篩選字串，其中包含要排除的模式。模式以 "\$1" (也就是管道) 分隔，例如 `"/folder1|/folder2"`。 類型：[FilterRule](API_FilterRule.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 1。 必要：否 ** [Includes](#API_StartTaskExecution_RequestSyntax) ** 指定篩選條件規則清單，以決定執行任務時要包含哪些檔案。模式應包含單一篩選條件字串，其中包含要包含的模式。模式以 "\$1" (也就是管道) 分隔，例如 `"/folder1|/folder2"`。 類型：[FilterRule](API_FilterRule.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 1。 必要：否 ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) ** 設定資訊清單，這是您希望 DataSync 傳輸的檔案或物件清單。如需詳細資訊和組態範例，請參閱[使用資訊清單指定 DataSync 傳輸的內容](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)。 使用此參數時，您的呼叫者身分 （與 DataSync 搭配使用的角色） 必須具有 `iam:PassRole`許可。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 政策包含此許可。 若要移除資訊清單組態，請以空值指定此參數。 類型：[ManifestConfig](API_ManifestConfig.md) 物件 必要：否 ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) ** 指出傳輸任務的設定方式。這些選項包括 DataSync 如何在傳輸期間處理檔案、物件及其相關聯的中繼資料。您也可以指定如何驗證資料完整性、設定任務的頻寬限制，以及其他選項。 每個選項都有預設值。除非您需要，否則在呼叫 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html) 之前，您不需要設定任何選項。 您也可以覆寫每個任務執行的任務選項。例如，您可能想要調整個別執行`LogLevel`的 。 類型：[Options](API_Options.md) 物件 必要：否 ** [Tags](#API_StartTaskExecution_RequestSyntax) ** 指定您要套用至代表任務執行之 Amazon Resource Name (ARN) 的標籤。 *標籤*是有助於管理、篩選和搜尋 DataSync 資源的鍵值對。 類型：[TagListEntry](API_TagListEntry.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 50。 必要：否 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** 指定您要啟動之任務的 Amazon Resource Name (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_StartTaskExecution_RequestSyntax) ** 指定您要如何設定任務報告，以提供 DataSync 傳輸的詳細資訊。如需詳細資訊，請參閱[使用任務報告監控 DataSync 傳輸](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)。 使用此參數時，您的呼叫者身分 （與 DataSync 搭配使用的角色） 必須具有 `iam:PassRole`許可。[AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess) 政策包含此許可。 若要移除任務報告組態，請將此參數指定為空白。 類型：[TaskReportConfig](API_TaskReportConfig.md) 物件 必要：否 ## 回應語法 ``` { "TaskExecutionArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** 執行中任務執行的 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}/execution/exec-[0-9a-f]{17}$` ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalException ** 當服務發生錯誤時，就會擲出此 AWS DataSync 例外狀況。 HTTP 狀態碼：500 ** InvalidRequestException ** 當用戶端提交格式不正確的請求時，會擲回此例外狀況。 HTTP 狀態碼：400 ## 範例 ### 請求範例 下列範例使用指定任務的預設選項啟動任務執行。 ``` { "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### 回應範例 此範例說明 StartTaskExecution 的一個用途。 ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution)