기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 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 로그 그룹에 로그를 자동으로 전송합니다. 자세한 내용은 [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) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(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)이 적용됩니다. 기본 모드는 데이터를 순차적으로 준비, 전송, 확인하므로 대부분의 워크로드에서 확장 모드보다 느립니다. 자세한 내용은 [작업 모드 차이점 이해](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) 섹션을 참조하세요. 이 파라미터를 사용할 때는 발신자 자격 증명(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 + [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 SDK for C\$1\$1](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 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 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 SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask)