기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 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:*` 자세한 내용은 [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) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(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) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(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 + [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 SDK for C\$1\$1](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 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 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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask)