Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# DescribeTaskExecution
Proporciona información sobre la ejecución de la AWS DataSync tarea. Puede utilizar esta operación para ayudar a supervisar el progreso de una transferencia de datos en curso o para comprobar los resultados de la transferencia.
**nota**
Algunos elementos de respuesta `DescribeTaskExecution` solo son relevantes para un modo de tarea específico. Para obtener más información, consulte [Descripción de las diferencias entre los modos de tarea](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) y [Comprensión de los contadores de rendimiento de la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html).
## Sintaxis de la solicitud
```
{
"TaskExecutionArn": "string"
}
```
## Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).
La solicitud acepta los siguientes datos en formato JSON.
** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) **
Especifique el nombre de recurso de Amazon (ARN) de la tarea de ejecución sobre la que desea obtener información.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón: `^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}$`
Obligatorio: sí
## Sintaxis de la respuesta
```
{
"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"
}
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) **
El número de bytes físicos que se DataSync transfieren a través de la red después de la compresión (si la compresión es posible). Este valor suele ser inferior a [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred), salvo que los datos no sean comprimibles.
Tipo: largo
** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
El número de bytes que se DataSync envían a la red antes de la compresión (si la compresión es posible). Para conocer el número de bytes transferidos a través de la red, consulte [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed).
Tipo: largo
** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **
El número de bytes lógicos que DataSync realmente se escriben en la ubicación de destino.
Tipo: largo
** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **
La hora en la que finaliza la tarea de transferencia.
Tipo: marca temporal
** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **
El número de bytes lógicos que se DataSync espera escribir en la ubicación de destino.
Tipo: largo
** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos, objetos y directorios que se DataSync espera eliminar en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete).
Tipo: largo
** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **
La cantidad de archivos, objetos y directorios que se DataSync espera transferir a través de la red. Este valor se calcula mientras DataSync [se prepara](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) la transferencia.
La forma en que se calcula depende principalmente de la configuración del [modo de transferencia](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) de la tarea:
+ Si `TranserMode` está configurado como `CHANGED`: el cálculo se basa en comparar el contenido de las ubicaciones de origen y destino, y en determinar la diferencia que debe transferirse. La diferencia puede incluir:
+ Todo lo que se añada o modifique en la ubicación de origen.
+ Todo lo que se encuentre en ambas ubicaciones y que se modifique en el destino después de una transferencia inicial (a menos que [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)esté configurado en`NEVER`).
+ **(Solo en el modo de tarea básica)** El número de elementos que se DataSync espera eliminar (si [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)está configurado en`REMOVE`).
+ Si `TranserMode` está establecido en`ALL`: el cálculo se basa únicamente en los elementos que DataSync se encuentran en la ubicación de origen.
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer).
Tipo: largo
** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que se DataSync espera eliminar en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo
** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que se DataSync espera transferir a través de la red. Este valor se calcula a medida que DataSync [se preparan](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) los directorios para transferirlos.
La forma en que se calcula depende principalmente de la configuración del [modo de transferencia](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) de la tarea:
+ Si `TranserMode` está configurado como `CHANGED`: el cálculo se basa en comparar el contenido de las ubicaciones de origen y destino, y en determinar la diferencia que debe transferirse. La diferencia puede incluir:
+ Todo lo que se añada o modifique en la ubicación de origen.
+ Todo lo que se encuentre en ambas ubicaciones y que se haya modificado en el destino después de una transferencia inicial (a menos que [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)esté configurado en`NEVER`).
+ Si `TranserMode` está establecido en`ALL`: el cálculo se basa únicamente en los elementos que DataSync se encuentran en la ubicación de origen.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo
** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) **
Una lista de reglas de filtrado que excluyen datos específicos durante la transferencia. Para obtener más información y ejemplos, consulte [Filtrar los datos transferidos por DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.
** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos, objetos y directorios que DataSync realmente se eliminan en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted).
Tipo: largo
** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos u objetos que DataSync no se pueden preparar, transferir, verificar ni eliminar durante la ejecución de la tarea.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md)
** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos u objetos que DataSync se encuentran en sus ubicaciones.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md)
** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos u objetos que DataSync se intentarán transferir después de comparar las ubicaciones de origen y destino.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Este contador no es aplicable si la tarea se configura para [transferir todos los datos](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). En ese escenario, DataSync copia todo, desde el origen hasta el destino, sin comparar las diferencias entre las ubicaciones.
Tipo: largo
** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos, objetos y directorios que se DataSync omiten durante la transferencia.
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped).
Tipo: largo
** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos, objetos y directorios que DataSync realmente se transfieren a través de la red. Este valor se actualiza periódicamente durante la ejecución de la tarea cuando se lee contenido desde el origen y se envía a través de la red.
Si DataSync no se puede transferir algo, este valor puede ser inferior a`EstimatedFilesToTransfer`. Este valor también puede ser mayor que `EstimatedFilesToTransfer` en algunos casos. Este elemento es específico de la implementación para algunos tipos de ubicaciones, por lo que no lo utilice como un indicador exacto de lo que se transfiere ni para supervisar la ejecución de la tarea.
Para [las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred).
Tipo: largo
** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) **
El número de archivos, objetos y directorios que se DataSync verifica durante la transferencia.
Al configurar la tarea para [comprobar únicamente los datos que se transfieren](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html), DataSync no comprueba los directorios en algunas situaciones ni los archivos que no se transfieren.
En el [caso de las tareas del modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), este contador solo incluye archivos u objetos. Los directorios se cuentan en ellos [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified).
Tipo: largo
** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que DataSync realmente se eliminan en la ubicación de destino. Si no [configura la tarea](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo
** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que DataSync no se pueden enumerar, preparar, transferir, verificar ni eliminar durante la ejecución de la tarea.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md)
** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que DataSync se encuentran en sus ubicaciones.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: objeto [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md)
** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que DataSync se intentarán transferir después de comparar las ubicaciones de origen y destino.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Este contador no es aplicable si la tarea se configura para [transferir todos los datos](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). En ese escenario, DataSync copia todo, desde el origen hasta el destino, sin comparar las diferencias entre las ubicaciones.
Tipo: largo
** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que se DataSync omiten durante la transferencia.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo
** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que DataSync realmente se transfieren a través de la red. Este valor se actualiza periódicamente durante la ejecución de la tarea cuando se lee contenido desde el origen y se envía a través de la red.
Si DataSync no se puede transferir algo, este valor puede ser inferior a`EstimatedFoldersToTransfer`. Este valor también puede ser mayor que `EstimatedFoldersToTransfer` en algunos casos.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo
** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **
El número de directorios que se DataSync verifica durante la transferencia.
Se aplica únicamente a las [tareas en modo mejorado](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: largo
** [Includes](#API_DescribeTaskExecution_ResponseSyntax) **
Una lista de reglas de filtrado que incluyen datos específicos durante la transferencia. Para obtener más información y ejemplos, consulte [Filtrar los datos transferidos por DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).
Tipo: matriz de objetos [FilterRule](API_FilterRule.md)
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 1 elemento.
** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) **
La hora en la que realmente comienza la ejecución de la tarea. Para las tareas que no están en cola, `LaunchTime` y `StartTime` suelen ser iguales. En el caso de las tareas en cola, `LaunchTime` suele ser posterior a `StartTime`, ya que las tareas previamente en cola deben terminar de ejecutarse antes de que puedan comenzar las tareas más recientes.
Tipo: marca temporal
** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) **
La configuración del manifiesto que enumere los archivos y los objetos a transferir. Para obtener más información, consulta [Especificar qué se DataSync transfiere mediante un manifiesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).
Tipo: objeto [ManifestConfig](API_ManifestConfig.md)
** [Options](#API_DescribeTaskExecution_ResponseSyntax) **
Indica cómo está configurada la tarea de transferencia. Estas opciones incluyen la forma en que DataSync gestiona los archivos, los objetos y sus metadatos asociados durante la transferencia. También puede especificar cómo verificar la integridad de los datos y establecer límites de ancho de banda para su tarea, entre otras opciones.
Cada opción tiene un valor predeterminado. A menos que lo necesites, no tienes que configurar ninguna opción antes de llamar [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).
También puede anular sus opciones de tarea para cada ejecución de tareas. Por ejemplo, es posible que desee ajustar el `LogLevel` para una ejecución individual.
Tipo: objeto [Options](API_Options.md)
** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) **
Indica si DataSync se ha generado un [informe de tareas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) completo para tu transferencia.
Tipo: objeto [ReportResult](API_ReportResult.md)
** [Result](#API_DescribeTaskExecution_ResponseSyntax) **
El resultado de la ejecución de la tarea.
Tipo: objeto [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md)
** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) **
La hora a la que se DataSync envía la solicitud para iniciar la ejecución de la tarea. Para las tareas que no están en cola, `LaunchTime` y `StartTime` suelen ser iguales. En el caso de las tareas en cola, `LaunchTime` suele ser posterior a `StartTime`, ya que las tareas previamente en cola deben terminar de ejecutarse antes de que puedan comenzar las tareas más recientes.
Tipo: marca temporal
** [Status](#API_DescribeTaskExecution_ResponseSyntax) **
El estado de la ejecución de la tarea.
Para obtener información detallada sobre los estados de ejecución de las tareas, consulte [Task execution statuses](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).
Tipo: cadena
Valores válidos: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`
** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) **
El ARN de ejecución de la tarea sobre la que quería información. `TaskExecutionArn` es jerárquico e incluye `TaskArn` para la tarea que se ejecutó.
Por ejemplo, un valor de `TaskExecution` con el ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` ejecutó la tarea con el ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón: `^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) **
El modo de tarea que utiliza. Para obtener más información, consulte [Selección del modo de tarea para la transferencia de datos](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipo: cadena
Valores válidos: `BASIC | ENHANCED`
** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) **
La configuración del informe de tareas, que proporciona información detallada sobre la DataSync transferencia. Para obtener más información, consulte [Creating a task report](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).
Tipo: objeto [TaskReportConfig](API_TaskReportConfig.md)
## Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).
** InternalException **
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .
Código de estado HTTP: 500
** InvalidRequestException **
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
Código de estado HTTP: 400
## Ejemplos
### Solicitud de ejemplo
En este ejemplo se ilustra una solicitud de `DescribeTaskExecution`.
```
{
"TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1"
}
```
### Respuesta de ejemplo 1 para la ejecución de una tarea en modo mejorado
El siguiente ejemplo describe la ejecución de una DataSync tarea que utiliza el modo mejorado. La ejecución también transfiere datos específicos mediante el uso de filtros de exclusión e inclusión.
```
{
"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
}
}
```
### Respuesta de ejemplo 2 para la ejecución de una tarea en modo mejorado
El siguiente ejemplo describe la ejecución de otra DataSync tarea que utiliza el modo mejorado. En esta situación, la ejecución transfiere datos específicos mediante el uso de un manifiesto en lugar de filtros.
```
{
"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
}
}
```
### Respuesta de ejemplo para la ejecución de una tarea en modo básico
El siguiente ejemplo describe la ejecución de una DataSync tarea que utiliza el modo Básico.
```
{
"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"
}
}
```
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution)