本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateTask 設定*任務*，定義資料傳輸的位置和方式 AWS DataSync 。 任務包含來源位置、目的地位置和傳輸選項 （例如頻寬限制、排程等）。 **重要** 如果您打算在 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/)。 ## 請求語法 ``` { "CloudWatchLogGroupArn": "string", "DestinationLocationArn": "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" }, "SourceLocationArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TaskMode": "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_CreateTask_RequestSyntax) ** 指定 Amazon CloudWatch 日誌群組的 Amazon Resource Name (ARN)，以監控您的任務。 對於增強型模式任務，您不需要指定任何項目。DataSync 會自動將日誌傳送至名為 的 CloudWatch 日誌群組`/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:([^:\*]*)(:\*)?$` 必要：否 ** [DestinationLocationArn](#API_CreateTask_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}:location/loc-[0-9a-z]{17}$` 必要：是 ** [Excludes](#API_CreateTask_RequestSyntax) ** 指定排除篩選條件，以定義您不希望 DataSync 傳輸之來源位置中的檔案、物件和資料夾。如需詳細資訊和範例，請參閱[使用篩選條件指定 DataSync 傳輸的內容](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)。 類型：[FilterRule](API_FilterRule.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 1。 必要：否 ** [Includes](#API_CreateTask_RequestSyntax) ** 指定包含篩選條件，以定義您要 DataSync 傳輸之來源位置中的檔案、物件和資料夾。如需詳細資訊和範例，請參閱[使用篩選條件指定 DataSync 傳輸的內容](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)。 類型：[FilterRule](API_FilterRule.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 1。 必要：否 ** [ManifestConfig](#API_CreateTask_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) 物件 必要：否 ** [Name](#API_CreateTask_RequestSyntax) ** 指定任務的名稱。 類型：字串 長度限制：長度下限為 0。長度上限為 256。 模式：`^[a-zA-Z0-9\s+=._:@/-]+$` 必要：否 ** [Options](#API_CreateTask_RequestSyntax) ** 指定任務的設定，例如保留檔案中繼資料、驗證資料完整性，以及其他選項。 類型：[Options](API_Options.md) 物件 必要：否 ** [Schedule](#API_CreateTask_RequestSyntax) ** 指定您希望任務何時執行的排程。如需詳細資訊，請參閱[任務排程](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html)。 類型：[TaskSchedule](API_TaskSchedule.md) 物件 必要：否 ** [SourceLocationArn](#API_CreateTask_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}:location/loc-[0-9a-z]{17}$` 必要：是 ** [Tags](#API_CreateTask_RequestSyntax) ** 指定您要套用至任務的標籤。 *標籤*是有助於管理、篩選和搜尋 DataSync 資源的鍵值對。 類型：[TagListEntry](API_TagListEntry.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 50。 必要：否 ** [TaskMode](#API_CreateTask_RequestSyntax) ** 為您的資料傳輸指定下列其中一個任務模式： + `ENHANCED` - 傳輸幾乎無限制數量的物件，其效能高於基本模式。增強型模式任務透過平行列出、準備、傳輸和驗證資料來最佳化資料傳輸程序。增強型模式目前適用於 Amazon S3 位置之間的傳輸、Azure Blob 與 Amazon S3 之間不使用代理程式的傳輸，以及其他雲端與 Amazon S3 之間不使用代理程式的傳輸。 **注意** 若要建立增強型模式任務，您用來呼叫 `CreateTask`操作的 IAM 角色必須具有 `iam:CreateServiceLinkedRole`許可。 + `BASIC` （預設） - 在儲存體和所有其他支援的 DataSync 位置之間 AWS 傳輸檔案或物件。基本模式任務會受到資料集中檔案、物件和目錄數量[的配額](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html)限制。基本模式會循序準備、傳輸和驗證資料，使其比大多數工作負載的增強模式慢。 如需詳細資訊，請參閱[了解任務模式差異](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences)。 類型：字串 有效值:`BASIC | ENHANCED` 必要：否 ** [TaskReportConfig](#API_CreateTask_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) 物件 必要：否 ## 回應語法 ``` { "TaskArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [TaskArn](#API_CreateTask_ResponseSyntax) ** 任務的 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}$` ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalException ** 當服務發生錯誤時，就會擲出此 AWS DataSync 例外狀況。 HTTP 狀態碼：500 ** InvalidRequestException ** 當用戶端提交格式不正確的請求時，會擲回此例外狀況。 HTTP 狀態碼：400 ## 範例 ### 增強型模式任務的範例請求 下列範例會建立使用增強模式的 DataSync 任務。 與建立基本模式任務不同，您不需要指定 Amazon CloudWatch 日誌群組。使用增強型模式任務時，DataSync 會自動將任務日誌傳送至名為 的日誌群組`/aws/datasync`。如果您的 中不存在該日誌群組 AWS 區域，DataSync 會在您建立任務時代表您建立日誌群組。 ``` { "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2", "Name": "My Enhanced mode task", "TaskMode": "ENHANCED", "Options": { "TransferMode": "CHANGED", "VerifyMode": "ONLY_FILES_TRANSFERRED", "ObjectTags": "PRESERVE", "LogLevel": "TRANSFER" } } ``` ### 基本模式任務的範例請求 下列範例會建立使用基本模式的 DataSync 任務。 ``` { "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "Name": "My Basic mode task", "TaskMode": "BASIC", "Options": { "Atime": "BEST_EFFORT", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "ONLY_FILES_TRANSFERRED" }, "Schedule": { "ScheduleExpression": "0 12 ? * SUN,WED *" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*", "Tags": [ { "Key": "Name", "Value": "Migration-wave-1" } ] } ``` ### 回應範例 下列回應包含已建立任務的 ARN。 ``` { "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)