기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # DescribeTaskExecution AWS DataSync 작업 실행에 대한 정보를 제공합니다. 이 작업을 사용하면 진행 중인 데이터 전송 상황을 모니터링하거나 전송 결과를 확인할 수 있습니다. **참고** 일부 `DescribeTaskExecution` 응답 요소는 특정 작업 모드에만 적용됩니다. 자세한 내용은 [작업 모드 차이 이해](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) 및 [데이터 전송 성능 카운터 이해](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html)를 참조하세요. ## 구문 요청 ``` { "TaskExecutionArn": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [TaskExecutionArn](#API_DescribeTaskExecution_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}/execution/exec-[0-9a-f]{17}$` 필수 여부: 예 ## 응답 구문 ``` { "BytesCompressed": number, "BytesTransferred": number, "BytesWritten": number, "EndTime": number, "EstimatedBytesToTransfer": number, "EstimatedFilesToDelete": number, "EstimatedFilesToTransfer": number, "EstimatedFoldersToDelete": number, "EstimatedFoldersToTransfer": number, "Excludes": [ { "FilterType": "string", "Value": "string" } ], "FilesDeleted": number, "FilesFailed": { "Delete": number, "Prepare": number, "Transfer": number, "Verify": number }, "FilesListed": { "AtDestinationForDelete": number, "AtSource": number }, "FilesPrepared": number, "FilesSkipped": number, "FilesTransferred": number, "FilesVerified": number, "FoldersDeleted": number, "FoldersFailed": { "Delete": number, "List": number, "Prepare": number, "Transfer": number, "Verify": number }, "FoldersListed": { "AtDestinationForDelete": number, "AtSource": number }, "FoldersPrepared": number, "FoldersSkipped": number, "FoldersTransferred": number, "FoldersVerified": number, "Includes": [ { "FilterType": "string", "Value": "string" } ], "LaunchTime": number, "ManifestConfig": { "Action": "string", "Format": "string", "Source": { "S3": { "BucketAccessRoleArn": "string", "ManifestObjectPath": "string", "ManifestObjectVersionId": "string", "S3BucketArn": "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" }, "ReportResult": { "ErrorCode": "string", "ErrorDetail": "string", "Status": "string" }, "Result": { "ErrorCode": "string", "ErrorDetail": "string", "PrepareDuration": number, "PrepareStatus": "string", "TotalDuration": number, "TransferDuration": number, "TransferStatus": "string", "VerifyDuration": number, "VerifyStatus": "string" }, "StartTime": number, "Status": "string", "TaskExecutionArn": "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" } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 압축(가능한 경우) 후 네트워크를 통해 전송하는 물리적 바이트 수입니다. 일반적으로 이 수치는 데이터를 압축할 수 없는 경우를 제외하고 [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)보다 작습니다. 타입: Long ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 압축(가능한 경우) 전에 네트워크에 전송하는 바이트 수입니다. 네트워크를 통해 전송된 바이트 수는 [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed) 섹션을 참조하세요. 타입: Long ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 실제로 대상 위치에 기록한 논리적 바이트 수입니다. 타입: Long ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 작업이 종료되는 시간입니다. 유형: 타임스탬프 ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에 기록할 것으로 예상되는 논리적 바이트 수입니다. 타입: Long ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에서 삭제할 것으로 예상되는 파일, 객체, 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete)에 포함됩니다. 타입: Long ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** 네트워크를 통해 DataSync가 전송할 것으로 예상되는 파일, 객체, 디렉터리 수입니다. 이 값은 DataSync가 전송을 [준비](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)하는 동안 계산됩니다. 계산 방법은 주로 작업의 [전송 모드](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) 구성에 따라 달라집니다. + `TranserMode`이 `CHANGED`로 설정된 경우 - 계산은 소스와 대상의 위치 콘텐츠를 비교하고 이를 바탕으로 전송해야 하는 차이를 결정합니다. 차이점은 다음과 같습니다. + 소스 위치에 추가되거나 수정된 모든 항목입니다. + 두 위치 모두에 있고 초기 전송 후 대상에서 수정된 모든 항목([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)가 `NEVER`로 설정된 경우 제외)입니다. + **(기본 작업 모드 전용)** DataSync가 삭제할 것으로 예상되는 항목의 수입니다([PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)이 `REMOVE`로 설정된 경우). + `TranserMode`가 `ALL`로 설정된 경우 - 계산은 DataSync가 소스 위치에서 찾는 항목만 기반으로 합니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer)에 포함됩니다. 타입: Long ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에서 삭제할 것으로 예상되는 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 네트워크를 통해 전송할 것으로 예상되는 디렉터리 수입니다. 이 값은 DataSync가 전송할 디렉터리를 [준비](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)할 때 계산됩니다. 계산 방법은 주로 작업의 [전송 모드](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) 구성에 따라 달라집니다. + `TranserMode`이 `CHANGED`로 설정된 경우 - 계산은 소스와 대상의 위치 콘텐츠를 비교하고 이를 바탕으로 전송해야 하는 차이를 결정합니다. 차이점은 다음과 같습니다. + 소스 위치에 추가되거나 수정된 모든 항목입니다. + 두 위치 모두에 있고 초기 전송 후 대상에서 수정된 모든 항목([OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)가 `NEVER`로 설정된 경우 제외)입니다. + `TranserMode`가 `ALL`로 설정된 경우 - 계산은 DataSync가 소스 위치에서 찾는 항목만 기반으로 합니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 중 특정 데이터를 제외하는 필터 규칙의 목록입니다. 자세한 내용과 예제는 [DataSync에서 전송된 데이터 필터링](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)을 참조하십시오. 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 실제로 대상 위치에서 삭제한 파일, 객체, 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [향상된 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted)에 포함됩니다. 타입: Long ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 작업 실행 중에 준비, 전송, 확인 및 삭제하지 못하는 파일 또는 객체의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md)객체 ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 사용자 위치에서 찾는 파일 또는 객체의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md)객체 ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** 소스 위치와 대상 위치를 비교한 후 DataSync가 전송을 시도할 파일 또는 객체의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. [모든 데이터를 전송](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)하도록 작업을 구성하는 경우 이 카운터를 사용할 수 없습니다. 이 시나리오에서 DataSync는 위치 간의 차이를 비교하지 않고 소스의 모든 데이터를 대상으로 복사합니다. 타입: Long ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송 중에 건너뛴 파일, 객체, 디렉터리의 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped)에 포함됩니다. 타입: Long ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 네트워크를 통해 실제로 전송한 파일, 객체, 디렉터리 수입니다. 이 값은 작업 실행 중 소스에서 무언가를 읽어 네트워크를 통해 전송할 때 주기적으로 업데이트됩니다. DataSync가 무언가를 전송하지 못하면 이 값은 `EstimatedFilesToTransfer`보다 작을 수 있습니다. 경우에 따라 이 값은 `EstimatedFilesToTransfer`보다 클 수도 있습니다. 이 요소는 일부 위치 유형에서 구현 방식에 따라 달라지므로 이를 정확한 지표로서 사용하거나 작업 실행을 모니터링하는 데 사용하지 마세요. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred)에 포함됩니다. 타입: Long ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송 중에 확인한 파일, 객체, 디렉터리의 수입니다. [전송된 데이터만 확인하도록](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html) 작업을 구성하면 DataSync는 전송에 실패한 일부 상황이나 파일에서 디렉터리를 확인하지 않습니다. [향상된 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)의 경우이 카운터에는 파일 또는 객체만 포함됩니다. 디렉터리는 [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified)에 포함됩니다. 타입: Long ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 대상 위치에서 실제로 삭제하는 디렉터리 수입니다. 소스에 없는 대상의 데이터를 삭제하도록 [작업을 구성](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html)하지 않는 경우 값은 항상 `0`입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 작업 실행 중에 나열, 준비, 전송, 확인 및 삭제하지 못하는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md)객체 ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 사용자 위치에서 찾는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 유형: [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md)객체 ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) ** 소스 위치와 대상 위치를 비교한 후 DataSync가 전송을 시도할 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. [모든 데이터를 전송](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode)하도록 작업을 구성하는 경우 이 카운터를 사용할 수 없습니다. 이 시나리오에서 DataSync는 위치 간의 차이를 비교하지 않고 소스의 모든 데이터를 대상으로 복사합니다. 타입: Long ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 중에 DataSync가 건너뛰는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 네트워크를 통해 실제로 전송하는 디렉터리 수입니다. 이 값은 작업 실행 중 소스에서 무언가를 읽어 네트워크를 통해 전송할 때 주기적으로 업데이트됩니다. DataSync가 무언가를 전송하지 못하면 이 값은 `EstimatedFoldersToTransfer`보다 작을 수 있습니다. 경우에 따라 이 값은 `EstimatedFoldersToTransfer`보다 클 수도 있습니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송 중에 확인하는 디렉터리 수입니다. [확장 모드 작업](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)에만 적용됩니다. 타입: Long ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 중 특정 데이터를 포함하는 필터 규칙의 목록입니다. 자세한 내용과 예제는 [DataSync에서 전송된 데이터 필터링](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html)을 참조하십시오. 유형: [FilterRule](API_FilterRule.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대 항목 수는 1개입니다. ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) ** 작업 실행이 실제로 시작되는 시간입니다. 대기열에 추가되지 않은 작업의 경우 `LaunchTime` 및 `StartTime`은 일반적으로 같습니다. 대기 중인 작업의 경우, 일반적으로 먼저 대기 중인 작업의 실행이 완료된 후에 새 작업이 시작되므로 `LaunchTime`이 `StartTime`보다 늦습니다. 유형: 타임스탬프 ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) ** 전송할 파일 또는 객체를 나열하는 매니페스트의 구성입니다. 자세한 내용은 [Specifying what DataSync transfers by using a manifest](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html) 섹션을 참조하세요. 유형: [ManifestConfig](API_ManifestConfig.md)객체 ** [Options](#API_DescribeTaskExecution_ResponseSyntax) ** 전송 작업이 구성된 방식을 나타냅니다. 이러한 옵션에는 DataSync가 전송 중에 파일, 객체 및 관련 메타데이터 처리 방법이 포함됩니다. 또한 다른 옵션 중에서 데이터 무결성을 확인하고, 작업에 대한 대역폭 제한 설정 방법을 지정할 수 있습니다. 각 옵션에는 기본값이 있습니다. 필요한 경우가 아니라면 [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)을 호출하기 전에 이러한 옵션을 구성하지 않아도 됩니다. 각 작업 실행에 대해 작업 옵션을 재정의할 수도 있습니다. 예를 들어 개별 실행에 대해 `LogLevel`을 조정할 수 있습니다. 유형: [Options](API_Options.md)객체 ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 전송에 대한 전체 [작업 보고서](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)를 생성했는지 여부를 나타냅니다. 유형: [ReportResult](API_ReportResult.md)객체 ** [Result](#API_DescribeTaskExecution_ResponseSyntax) ** 작업 실행 결과입니다. 유형: [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md)객체 ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync가 작업 실행을 시작하기 위해 요청을 전송하는 시간입니다. 대기열에 추가되지 않은 작업의 경우 `LaunchTime` 및 `StartTime`은 일반적으로 같습니다. 대기 중인 작업의 경우, 일반적으로 먼저 대기 중인 작업의 실행이 완료된 후에 새 작업이 시작되므로 `LaunchTime`이 `StartTime`보다 늦습니다. 유형: 타임스탬프 ** [Status](#API_DescribeTaskExecution_ResponseSyntax) ** 작업 실행 상태입니다. 작업 실행 상태에 대한 자세한 내용은 [작업 실행 상태](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses)를 참조하세요. 타입: 문자열 유효 값: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) ** 정보를 원했던 작업 실행의 ARN입니다. `TaskExecutionArn`은 계층적이며 실행된 작업의 `TaskArn`를 포함합니다. 예를 들어, ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b`이 있는 `TaskExecution`값은 ARN으로 작업 `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`을 실행했습니다. 유형: 문자열 길이 제약: 최대 길이는 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}$` ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) ** 사용 중인 작업 모드입니다. 자세한 내용은 [데이터 전송을 위한 작업 모드 선택](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)을 참조하세요. 타입: 문자열 유효 값: `BASIC | ENHANCED` ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) ** DataSync 전송에 대한 세부 정보를 제공하는 작업 보고서 구성입니다. 자세한 내용은 [작업 보고서 생성](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)을 참조하십시오. 타입: [TaskReportConfig](API_TaskReportConfig.md) 객체 ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 이 예제는 `DescribeTaskExecution`요청을 보여줍니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1" } ``` ### 확장 모드 작업 실행에 대한 샘플 응답 1 다음 예시에서는 확장 모드를 사용하는 DataSync 작업 실행을 설명합니다. 해당 실행은 또한 제외 및 포함 필터를 사용하여 특정 데이터를 전송합니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "BASIC", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/archive-files" }], "Includes": [{ "FilterType": "SIMPLE_PATTERN", "Value": "/files" }], "StartTime": "2024-10-16T11:19:56.844000-04:00", "EstimatedFilesToTransfer": 7, "EstimatedFoldersToTransfer": 2, "EstimatedBytesToTransfer": 30, "FilesTransferred": 7, "FoldersTransferred": 2, "BytesWritten": 30, "BytesTransferred": 30, "BytesCompressed": 30, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3310, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 7, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 7, "FilesListed": { "AtSource": 7, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 2, "FoldersPrepared": 2, "FoldersListed": { "AtSource": 2, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### 확장 모드 작업 실행에 대한 샘플 응답 2 다음 예시에서는 확장 모드를 사용하는 또 다른 DataSync 작업 실행을 설명합니다. 이 경우 해당 실행은 필터 대신 매니페스트를 사용하여 특정 데이터를 전송합니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "Status": "SUCCESS", "Options": { "VerifyMode": "ONLY_FILES_TRANSFERRED", "OverwriteMode": "ALWAYS", "Atime": "BEST_EFFORT", "Mtime": "PRESERVE", "Uid": "NONE", "Gid": "NONE", "PreserveDeletedFiles": "PRESERVE", "PreserveDevices": "NONE", "PosixPermissions": "NONE", "BytesPerSecond": -1, "TaskQueueing": "ENABLED", "LogLevel": "TRANSFER", "TransferMode": "CHANGED", "SecurityDescriptorCopyFlags": "NONE", "ObjectTags": "PRESERVE" }, "Excludes": [], "Includes": [], "ManifestConfig": { "Action": "TRANSFER", "Format": "CSV", "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess", "S3Bucket": "arn:aws:s3:::manifests-datasync", "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG", "Source": { "S3": { "ManifestObjectPath": "manifest-folder/manifest-versioned-files", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess", "S3BucketArn": "arn:aws:s3:::manifests-datasync", "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG" } } }, "StartTime": "2024-10-16T09:29:56.757000-04:00", "EstimatedFilesToTransfer": 1, "EstimatedFoldersToTransfer": 0, "EstimatedBytesToTransfer": 6, "FilesTransferred": 1, "FoldersTransferred": 1, "BytesWritten": 6, "BytesTransferred": 6, "BytesCompressed": 6, "Result": { "PrepareDuration": 0, "PrepareStatus": "SUCCESS", "TotalDuration": 3089, "TransferDuration": 0, "TransferStatus": "SUCCESS", "VerifyDuration": 0, "VerifyStatus": "SUCCESS" }, "TaskReportConfig": { "Destination": { "S3": { "Subdirectory": "reports/", "S3BucketArn": "arn:aws:s3:::my-task-report", "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess" } }, "OutputType": "STANDARD", "ReportLevel": "SUCCESSES_AND_ERRORS", "ObjectVersionIds": "INCLUDE" }, "FilesDeleted": 0, "FilesSkipped": 0, "FilesVerified": 1, "ReportResult": { "Status": "SUCCESS" }, "EstimatedFilesToDelete": 0, "TaskMode": "ENHANCED", "FilesPrepared": 1, "FilesListed": { "AtSource": 1, "AtDestinationForDelete": 0 }, "FilesFailed": { "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 }, "FoldersDeleted": 0, "FoldersSkipped": 0, "FoldersVerified": 0, "FoldersPrepared": 0, "FoldersListed": { "AtSource": 0, "AtDestinationForDelete": 0 }, "FoldersFailed": { "List": 0, "Prepare": 0, "Transfer": 0, "Verify": 0, "Delete": 0 } } ``` ### 기본 모드 작업 실행에 대한 샘플 응답 다음 예시에서는 기본 모드를 사용하는 DataSync 작업 실행을 설명합니다. ``` { "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "BytesCompressed": 3500, "BytesTransferred": 5000, "BytesWritten": 5000, "EstimatedBytesToTransfer": 5000, "EstimatedFilesToDelete": 10, "EstimatedFilesToTransfer": 100, "FilesDeleted": 10, "FilesSkipped": 0, "FilesTransferred": 100, "FilesVerified": 100, "Result": { "PrepareDuration": 100, "PrepareStatus": "SUCCESS", "TransferDuration": 60, "TransferStatus": "SUCCESS", "VerifyDuration": 30, "VerifyStatus": "SUCCESS" }, "StartTime": "2024-10-16T11:19:56.844000-04:00", "Status": "SUCCESS", "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": "1000", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role", "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*", "Subdirectory": "reports" } }, "ObjectVersionIds": "INCLUDE", "OutputType": "STANDARD", "Overrides": { "Deleted": { "ReportLevel": "ERRORS_ONLY" }, "Skipped": { "ReportLevel": "SUCCESSES_AND_ERRORS" }, "Transferred": { "ReportLevel": "ERRORS_ONLY" }, "Verified": { "ReportLevel": "ERRORS_ONLY" } }, "ReportLevel": "ERRORS_ONLY" } } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution)