DescribeTaskExecution - AWS DataSync
요청 구문요청 파라미터응답 구문응답 요소오류예시참고 항목

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DescribeTaskExecution

실행되지 않는 태스크에 대한 세부 메타데이터를 반환합니다.

요청 구문

{
   "TaskExecutionArn": "string"
}

요청 파라미터

모든 작업에 공통된 파라미터에 대한 자세한 내용은 일반 파라미터를 참조하세요.

요청은 JSON 형식의 다음 데이터를 받습니다.

TaskExecutionArn

실행되지 않는 태스크의 Amazon 리소스 이름 (ARN) 입니다.

유형: String

길이 제약: 최대 길이는 128입니다.

패턴: ^arn:(aws|aws-cn|aws-us-gov|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}$

Required: Yes

응답 구문

{
   "BytesCompressed": number,
   "BytesTransferred": number,
   "BytesWritten": number,
   "EstimatedBytesToTransfer": number,
   "EstimatedFilesToTransfer": number,
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "FilesTransferred": number,
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "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"
   },
   "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"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

BytesCompressed

압축이 적용된 후 네트워크를 통해 전송된 물리적 바이트 수입니다. 대부분의 경우 이 숫자는 데이터를 압축할 수 BytesTransferred 없는 경우보다 작습니다.

유형: Long

BytesTransferred

전송에 관련된 바이트의 총수 네트워크를 통해 전송된 바이트 수는 을 참조하세요BytesCompressed.

유형: Long

BytesWritten

대상 AWS 스토리지 리소스에 기록된 논리적 바이트 수입니다.

유형: Long

EstimatedBytesToTransfer

네트워크를 통해 전송될 예상 물리적 바이트 수입니다.

유형: Long

EstimatedFilesToTransfer

네트워크를 통해 전송될 예상 파일 수입니다. 이 값은 작업 실행 PREPARING 단계 이전 단계에서 계산됩니다. TRANSFERRING 이 값은 전송될 예상 파일 수입니다. 소스 및 목적지 위치의 콘텐츠를 비교하고 전송해야 하는 델타를 찾는 것을 기반으로 계산됩니다.

유형: Long

Excludes

전송 중 특정 데이터를 제외하는 필터 규칙의 목록입니다. 자세한 내용과 예제는 전송된 데이터 필터링 을 참조하세요DataSync.

유형: FilterRule 객체 배열

배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수는 1개입니다.

FilesTransferred

네트워크를 통해 전송된 실제 파일 수입니다. 이 값은 작업 실행 TRANSFERRING 단계에서 지속적으로 계산되고 업데이트됩니다. 소스에서 각 파일을 읽고 네트워크를 통해 전송할 때 주기적으로 업데이트됩니다.

전송 중에 오류가 발생할 경우, 이 값은 EstimatedFilesToTransfer보다 작을 수 있습니다. 경우에 따라 이 값이 다음보다 클 수도 EstimatedFilesToTransfer 있습니다. 이 요소는 일부 위치 유형에서 구현과 관련이 있으므로 이를 올바른 파일 번호를 나타내는 지표로서 사용하거나 혹은 작업 실행을 모니터링하는 데 사용하지 마십시오.

유형: Long

Includes

전송 중 특정 데이터를 포함하는 필터 규칙의 목록입니다. 자세한 내용과 예제는 전송된 데이터 필터링 을 참조하세요DataSync.

유형: FilterRule 객체 배열

배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수는 1개입니다.

Options

AWS DataSync작업 설정을 구성합니다. 이러한 옵션에는 파일, 객체 및 관련 메타데이터를 DataSync 처리하는 방법이 포함됩니다. 또한 데이터 무결성을 DataSync 검증하는 방법을 지정하고 작업에 대한 대역폭 제한을 설정하는 등의 옵션을 지정할 수 있습니다.

태스크 설정에는 기본값이 있습니다. 꼭 필요한 경우가 아니면 작업을 시작하기 Options 전에 이러한 설정을 구성하지 않아도 됩니다.

유형: Options 객체

Result

태스크 실행의 상태입니다.

유형: TaskExecutionResultDetail 객체

StartTime

작업 실행이 시작된 시간입니다.

유형: Timestamp

Status

태스크 실행의 상태입니다.

작업 실행 상태에 대한 자세한 내용은 작업 상태 이해를 참조하십시오.

유형: String

유효한 값: QUEUED | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR

TaskExecutionArn

설명된 태스크 실행의 Amazon 리소스 이름 (ARN) 입니다. TaskExecutionArn계층적이며 실행된 TaskArn 작업에 포함됩니다.

예를 들어, ARN이 있는 TaskExecution 값은 ARN을 사용하여 작업을 arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b 실행했습니다. arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2

유형: String

길이 제약: 최대 길이는 128입니다.

패턴: ^arn:(aws|aws-cn|aws-us-gov|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}$

오류

모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.

InternalException

이 예외는 AWS DataSync 서비스에 오류가 발생할 때 발생합니다.

HTTP 상태 코드: 500

InvalidRequestException

클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.

HTTP 상태 코드: 400

예시

예제 요청

이 예는 DescribeTaskExecution 요청을 보여줍니다.

{
  "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}

샘플 응답

이 예는 DescribeTaskExecution 응답을 보여줍니다.

{
   "BytesCompressed": "3500",
   "BytesTransferred": "5000",
   "BytesWritten": "5000",
   "EstimatedBytesToTransfer": "5000",
   "EstimatedFilesToTransfer": "100",
   "FilesTransferred": "100",
   "Result": { 
      "ErrorCode": "??????",
      "ErrorDetail": "??????",
      "PrepareDuration": "100",
      "PrepareStatus": "SUCCESS",
      "TransferDuration": "60",
      "TransferStatus": "AVAILABLE",
      "VerifyDuration": "30",
      "VerifyStatus": "SUCCESS"
   },
   "StartTime": "1532660733.39",
   "Status": "SUCCESS",
   "OverrideOptions": { 
      "Atime": "BEST_EFFORT",
      "BytesPerSecond": "1000",
      "Gid": "NONE",
      "Mtime": "PRESERVE",
      "PosixPermissions": "PRESERVE",
      "PreserveDevices": "NONE",
      "PreserveDeletedFiles": "PRESERVE",
      "Uid": "NONE",
      "VerifyMode": "POINT_IN_TIME_CONSISTENT"
   },
   "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.