翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 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" } } ``` ## リクエストパラメーター すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下のデータを JSON 形式で受け入れます。 ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) ** タスクをモニタリングするための Amazon CloudWatch ロググループの Amazon リソースネーム (ARN) を指定します。 拡張モードタスクでは、ロググループ名として `/aws/datasync` を使用する必要があります。例えば、次のようになります。 `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*` 詳細については、「[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:([^:\*]*)(:\*)?$` 必須: いいえ ** [Excludes](#API_UpdateTask_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_UpdateTask_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_UpdateTask_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 ロール) には `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 転送に関する詳細情報を提供するタスクレポートの構成方法を指定します。詳細については、「[Monitoring your DataSync transfers with task reports](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)」を参照してください。 このパラメータを使用する場合、発信者 ID (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 SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask)