本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 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)。
类型：长整型
** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
压缩前 DataSync 发送到网络的字节数（如果可以压缩）。有关通过网络传输的字节数，请参阅 [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed)。
类型：长整型
** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **
DataSync 实际写入目标位置的逻辑字节数。
类型：长整型
** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **
传输任务结束的时间。
类型：时间戳
** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **
DataSync 预期写入目标位置的逻辑字节数。
类型：长整型
** [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)。
类型：长整型
** [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)。
类型：长整型
** [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)。
类型：长整型
** [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)。
类型：长整型
** [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)。
类型：长整型
** [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 将所有内容从源复制到目的地，而不比较位置之间的差异。
类型：长整型
** [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)。
类型：长整型
** [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)。
类型：长整型
** [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)。
类型：长整型
** [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)。
类型：长整型
** [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 将所有内容从源复制到目的地，而不比较位置之间的差异。
类型：长整型
** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **
传输过程中 DataSync 跳过的目录数量。
仅适用于[增强模式任务](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)。
类型：长整型
** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
DataSync 实际通过网络传输的目录数量。在任务执行期间，当从源读取内容并通过网络发送内容时，该值会定期更新。
如果 DataSync 无法传输某些内容，则此值可以小于`EstimatedFoldersToTransfer`。在某些情况下，此值也可能大于 `EstimatedFoldersToTransfer`。
仅适用于[增强模式任务](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)。
类型：长整型
** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **
在传输过程中进行 DataSync 验证的目录数量。
仅适用于[增强模式任务](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html)。
类型：长整型
** [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) **
列出了要传输的文件或对象的清单配置。有关更多信息，请参阅[使用清单指定 DataSync 传输的内容](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"
}
}
```
## 另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
+ [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS 适用于 C\$1\$1 的 SDK](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 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution)