기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # StartTaskExecution AWS DataSync 전송 작업을 시작합니다. 각 작업에 대해 한 번에 하나의 작업 실행만 수행할 수 있습니다. 작업 실행에는 여러 단계가 있습니다. 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses)를 참조하십시오. **중요** 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/)를 검토하십시오. ## 구문 요청 ``` { "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" } } }, "OverrideOptions": { "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" }, "Tags": [ { "Key": "string", "Value": "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 형식으로 다음 데이터를 받습니다. ** [Excludes](#API_StartTaskExecution_RequestSyntax) ** 작업에서 제외할 파일을 결정하는 필터 규칙 목록을 지정합니다. 목록에는 제외할 패턴으로 구성된 단일 필터 문자열이 포함됩니다. 패턴은 "\$1"(즉, 파이프)로 구분됩니다(예: `"/folder1|/folder2"`). 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [Includes](#API_StartTaskExecution_RequestSyntax) ** 작업 실행 중 포함시킬 파일을 결정하는 필터 규칙 목록을 지정합니다. 패턴에는 포함시킬 패턴으로 구성된 단일 필터 문자열을 포함해야 합니다. 패턴은 "\$1"(즉, 파이프)로 구분됩니다(예: `"/folder1|/folder2"`). 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. 필수 여부: 아니요 ** [ManifestConfig](#API_StartTaskExecution_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)객체 필수 여부: 아니요 ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) ** 전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다. 각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다. 각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 `LogLevel`을 조정할 수 있습니다. 유형: [Options](API_Options.md)객체 필수 여부: 아니요 ** [Tags](#API_StartTaskExecution_RequestSyntax) ** 작업 실행을 나타내는 Amazon 리소스 이름(ARN)에 적용할 태그를 지정합니다. 태그**는 DataSync 리소스를 관리, 필터링 및 검색하는 데 도움이 되는 키-값 페어입니다. 유형: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) ** 시작할 작업의 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}$` 필수 여부: 예 ** [TaskReportConfig](#API_StartTaskExecution_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)객체 필수 항목 여부: 아니요 ## 응답 구문 ``` { "TaskExecutionArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) ** 수행 중인 작업 실행의 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}/execution/exec-[0-9a-f]{17}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 다음 예제에서는 지정된 작업의 기본 옵션을 사용하여 작업 실행을 시작합니다. ``` { "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" } ``` ### 샘플 응답 이 예제에서는 StartTaskExecution의 한 가지 사용법을 보여줍니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/StartTaskExecution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution)