DescribeTaskExecution
Provides information about an execution of your AWS DataSync task. You can use this operation to help monitor the progress of an ongoing data transfer or check the results of the transfer.
Note
Some DescribeTaskExecution response elements are only relevant to a
specific task mode. For information, see Understanding task mode differences and Understanding data
transfer performance counters.
Request Syntax
{
"TaskExecutionArn": "string"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- TaskExecutionArn
-
Specifies the Amazon Resource Name (ARN) of the task execution that you want information about.
Type: String
Length Constraints: Maximum length of 128.
Pattern:
^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}$Required: Yes
Response Syntax
{
"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"
}
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- BytesCompressed
-
The number of physical bytes that DataSync transfers over the network after compression (if compression is possible). This number is typically less than BytesTransferred unless the data isn't compressible.
Type: Long
- BytesTransferred
-
The number of bytes that DataSync sends to the network before compression (if compression is possible). For the number of bytes transferred over the network, see BytesCompressed.
Type: Long
- BytesWritten
-
The number of logical bytes that DataSync actually writes to the destination location.
Type: Long
- EndTime
-
The time that the transfer task ends.
Type: Timestamp
- EstimatedBytesToTransfer
-
The number of logical bytes that DataSync expects to write to the destination location.
Type: Long
- EstimatedFilesToDelete
-
The number of files, objects, and directories that DataSync expects to delete in your destination location. If you don't configure your task to delete data in the destination that isn't in the source, the value is always
0.Note
For Enhanced mode tasks, this counter only includes files or objects. Directories are counted in EstimatedFoldersToDelete.
Type: Long
- EstimatedFilesToTransfer
-
The number of files, objects, and directories that DataSync expects to transfer over the network. This value is calculated while DataSync prepares the transfer.
How this gets calculated depends primarily on your task’s transfer mode configuration:
-
If
TranserModeis set toCHANGED- The calculation is based on comparing the content of the source and destination locations and determining the difference that needs to be transferred. The difference can include:-
Anything that's added or modified at the source location.
-
Anything that's in both locations and modified at the destination after an initial transfer (unless OverwriteMode is set to
NEVER). -
(Basic task mode only) The number of items that DataSync expects to delete (if PreserveDeletedFiles is set to
REMOVE).
-
-
If
TranserModeis set toALL- The calculation is based only on the items that DataSync finds at the source location.
Note
For Enhanced mode tasks, this counter only includes files or objects. Directories are counted in EstimatedFoldersToTransfer.
Type: Long
-
- EstimatedFoldersToDelete
-
The number of directories that DataSync expects to delete in your destination location. If you don't configure your task to delete data in the destination that isn't in the source, the value is always
0.Note
Applies only to Enhanced mode tasks.
Type: Long
- EstimatedFoldersToTransfer
-
The number of directories that DataSync expects to transfer over the network. This value is calculated as DataSync prepares directories to transfer.
How this gets calculated depends primarily on your task’s transfer mode configuration:
-
If
TranserModeis set toCHANGED- The calculation is based on comparing the content of the source and destination locations and determining the difference that needs to be transferred. The difference can include:-
Anything that's added or modified at the source location.
-
-