翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 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" } } ``` ## リクエストパラメーター すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下のデータを JSON 形式で受け入れます。 ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) ** タスクをモニタリングするための Amazon CloudWatch ロググループの Amazon リソースネーム (ARN) を指定します。 拡張モードタスクの場合、何も指定する必要はありません。DataSync は、`/aws/datasync` という名前の CloudWatch ロググループにログを自動的に送信します。 詳細については、「[Monitoring data transfers with Amazon 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 に転送してほしくないソースの場所内のファイル、オブジェクト、フォルダを定義する除外フィルターを指定します。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。 タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。 必須: いいえ ** [Includes](#API_CreateTask_RequestSyntax) ** 包含フィルターを指定して、DataSync が転送するソースの場所内のファイル、オブジェクト、フォルダを定義します。詳細と例については、「[Specifying what DataSync transfers by using filters](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)」を参照してください。 タイプ: [FilterRule](API_FilterRule.md) オブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 1 項目です。 必須: いいえ ** [ManifestConfig](#API_CreateTask_RequestSyntax) ** DataSync が転送するファイルまたはオブジェクトのリストであるマニフェストを設定します。詳細と設定例については、「[Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html)」を参照してください。 このパラメータを使用する場合、発信者 ID (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` (デフォルト) - AWS ストレージと他のサポートされているすべての DataSync ロケーション間でファイルまたはオブジェクトを転送します。基本モードタスクは、データセット内のファイル、オブジェクト、ディレクトリの数に対する[クォータ](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html)の対象となります。基本モードはデータの準備、転送、検証を順に実行するため、ほとんどのワークロードで拡張モードよりも速度は遅くなります。 詳細については、[「Understanding task mode differences](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences)」を参照してください。 型: 文字列 有効な値：`BASIC | ENHANCED` 必須：いいえ ** [TaskReportConfig](#API_CreateTask_RequestSyntax) ** DataSync 転送に関する詳細情報を提供するタスクレポートの設定方法を指定します。詳細については、「[Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。 このパラメータを使用する場合、発信者 ID (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 リソースネーム (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 SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)