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. # Supervisión de las transferencias de datos con informes de tareas Los *informes de tareas* proporcionan información detallada sobre lo que AWS DataSync intenta transferir, omitir, verificar y eliminar durante la ejecución de una tarea. Para obtener más información, consulte [Cómo DataSync transfiere los archivos, objetos y directorios](how-datasync-transfer-works.md#transferring-files). Los informes de tareas se generan en formato JSON. Puede personalizar el nivel de detalle de los informes: + [Los informes de tareas de solo resumen](#task-report-types-summary) proporcionan los detalles necesarios sobre la ejecución de la tarea, como el número de archivos transferidos y si se DataSync puede verificar la integridad de los datos de esos archivos. + Los [informes de tareas estándar](#task-report-types-standard) incluyen un resumen e informes detallados que enumeran cada archivo, objeto o carpeta que se DataSync intenta transferir, omitir, verificar o eliminar. Con un informe de tareas estándar, también puede especificar el [nivel de informe](#task-report-level) para mostrar solo los errores de la ejecución de la tarea o tanto aciertos como errores. ## Casos de uso Estas son algunas situaciones en las que los informes de tareas pueden ayudarle a supervisar y auditar sus transferencias de datos: + Al migrar millones de archivos, identifique rápidamente los archivos que DataSync tienen problemas para transferirse. + Verifica chain-of-custody los procesos de tus archivos. ## Resumen de los informes de tareas Un informe que es solo un resumen de la ejecución de una tarea incluye los siguientes detalles: + El Cuenta de AWS que ejecutó la tarea + Ubicaciones de origen y destino + El número total de archivos, objetos y carpetas que se han omitido, transferido, verificado y eliminado + El total de bytes (lógicos y físicos) que se han transferido + Si la ejecución de la tarea se ha completado, se ha cancelado o si se producido un error + Las horas de inicio y finalización (incluido el tiempo total de la transferencia) + La configuración de la tarea (como los límites de ancho de banda, la verificación de la integridad de los datos y otras opciones para la DataSync transferencia) ## Informes de tareas estándar Un informe de tareas estándar incluye un [resumen](#task-report-types-summary) de la ejecución de la tarea, además de informes detallados de lo que se DataSync intenta transferir, omitir, verificar y eliminar. **Topics** + [Nivel del informe](#task-report-level) + [Informes transferidos](#task-report-types-transferred) + [Informes de omisión](#task-report-types-skipped) + [Informes de verificación](#task-report-types-verified) + [Informes de eliminación](#task-report-types-deleted) ### Nivel del informe Con los informes de tareas estándar, puede elegir uno de los siguientes niveles de informe: + Solo errores + Éxitos y errores (básicamente una lista de todo lo que ha ocurrido durante la ejecución de la tarea) Por ejemplo, es posible que desees ver qué archivos DataSync se omitieron correctamente durante la transferencia y cuáles no. Es posible que los archivos que se DataSync omitieron correctamente sean aquellos que desee excluir DataSync a propósito porque ya existen en la ubicación de destino. Sin embargo, si se omite un error, por ejemplo, podría indicar que DataSync no tiene los permisos adecuados para leer un archivo. ### Informes transferidos Una lista de archivos, objetos y directorios que se DataSync intentaron transferir durante la ejecución de la tarea. Un informe de transferencia incluye los siguientes detalles: + Las rutas de los datos transferidos + Qué se ha transferido (contenido, metadatos o ambos) + Los metadatos, que incluyen el tipo de datos, el tamaño del contenido (solo objetos y archivos) y más + La hora en que se ha transferido un elemento + La versión del objeto (si el destino es un bucket de Amazon S3 que tiene habilitado el control de versiones) + Si se ha sobrescrito algo en el destino + Si un artículo se ha transferido correctamente **nota** Al mover datos entre depósitos de S3, el prefijo que especifique en su [ubicación de origen](create-s3-location.md) puede aparecer en su informe (o en los CloudWatch registros de Amazon), incluso si ese prefijo no existe como objeto en su ubicación de destino. (En la DataSync consola, es posible que también veas que este prefijo aparece como datos omitidos o verificados). ### Informes de omisión Una lista de archivos, objetos y directorios que DataSync se encuentran en la ubicación de origen pero que no se han intentado transferir. Los motivos por los que DataSync se omiten los datos pueden depender de varios factores, como la forma en que se configuran las tareas y los permisos del sistema de almacenamiento. Estos son algunos ejemplos: + Uno de los archivos de la ubicación de origen existe en las ubicaciones de origen y de destino. El archivo del origen no se ha modificado desde la ejecución anterior de la tarea. Como [solo transfiere datos que han cambiado](configure-metadata.md#task-option-transfer-mode), DataSync no transferirá ese archivo la próxima vez que ejecute la tarea. + Un objeto que existe en ambas ubicaciones cambia en el origen. Al ejecutar la tarea, DataSync omite este objeto en el destino porque la tarea no [sobrescribe los datos del](configure-metadata.md#task-option-file-object-handling) destino. + DataSync omite un objeto del origen que utiliza una [clase de almacenamiento de archivos y no](create-s3-location.md#using-storage-classes) se restaura. Debes restaurar un objeto archivado para DataSync poder leerlo. + DataSync omite un archivo, objeto o directorio de la ubicación de origen porque no puede leerlo. Si esto ocurre y no es lo esperado, comprueba los permisos de acceso del almacenamiento y asegúrate de que DataSync puede leer lo que se omitió. Un informe de omisión incluye los siguientes detalles: + Las rutas de los datos omitidos + La hora en que se ha omitido un elemento + La razón por la que se ha omitido + Si un elemento se ha omitido correctamente **nota** Los informes de omisión pueden ser extensos si incluyen aciertos y errores, se configura la tarea para [transferir solo los datos que han cambiado](configure-metadata.md) y los datos de origen ya existen en el destino. ### Informes de verificación Una lista de archivos, objetos y directorios de los que se DataSync intentó comprobar la integridad durante la ejecución de la tarea. Un informe de verificación incluye los siguientes detalles: + Las rutas de los datos verificados + La hora en que se ha verificado un elemento + El motivo del error en la verificación (si lo hubiera) + Las SHA256 sumas de control de origen y destino (solo archivos) + Si un elemento se ha verificado correctamente Tenga en cuenta lo siguiente sobre los informes de verificación: + Cuando configura la tarea para [verificar solo los datos transferidos](configure-data-verification-options.md), DataSync no verifica los directorios en algunas situaciones ni los archivos u objetos que no se transfieren. En cualquier caso, DataSync no incluye datos no verificados en este informe. + Si utiliza el [modo mejorado](choosing-task-mode.md), la verificación puede tardar más de lo habitual cuando se transfieren objetos de gran tamaño. ### Informes de eliminación Una lista de archivos, directorios y objetos que se eliminaron durante la ejecución de la tarea. DataSync genera este informe solo si [configura la tarea](configure-metadata.md) para eliminar datos de la ubicación de destino que no estén en la fuente. Un informe de eliminación incluye los siguientes detalles: + Las rutas de los datos eliminados + Si un elemento se ha eliminado correctamente + La hora en que se ha eliminado un elemento ## Ejemplos de informes de tareas El nivel de detalle del informe de tareas depende de usted. Estos son algunos ejemplos de informes de datos transferidos con la siguiente configuración: + **Tipo de informe**: estándar + **Nivel de informe**: éxitos y errores **nota** Los informes utilizan la norma ISO-8601 para el formato de marca de tiempo. Las horas aparecen en UTC y se miden en nanosegundos. Este comportamiento difiere de la forma en que se miden otras métricas de los informes de tareas. Por ejemplo, [los detalles de la ejecución de las tareas](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html), tales como `TransferDuration` y `VerifyDuration`, se miden en milisegundos. Los informes de tareas en modo mejorado utilizan un esquema ligeramente distinto al de los informes de tareas en modo básico. Los siguientes ejemplos ayudan a entender qué puede esperar de los informes según el [modo de tarea](choosing-task-mode.md) que utilice. **Ejemplo de informes de datos transferidos con estado correcto** Los siguientes informes muestran transferencias correctas de un objeto denominado `object1.txt`. ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "object1.txt", "SourceMetadata": { "Type": "Object", "ContentSize": 6, "LastModified": "2024-10-04T14:40:55Z", "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"9b2d7e1f8054c3a2041905d0378e6f14\"", "ServerSideEncryption": "AES256" }, "UserMetadata": {}, "Tags": [] }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2024-10-04T14:48:39.748862183Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "SUCCESS" }] } ``` ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "/object1.txt", "SrcMetadata": { "Type": "Regular", "ContentSize": 6, "Mtime": "2022-01-07T16:59:26.136114671Z", "Atime": "2022-01-07T16:59:26.136114671Z", "Uid": 0, "Gid": 0, "Mode": "0644" }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2022-01-07T16:59:45.747270957Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "SUCCESS" }] } ``` **Ejemplo de informes de datos transferidos con estado de error** En los siguientes informes se proporcionan ejemplos de casos en los que no se DataSync puede transferir un objeto denominado`object1.txt`. Este informe muestra que no DataSync pueden acceder a un objeto nombrado `object1.txt` debido a un problema de AWS KMS permisos. (Si aparece un error como este, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption)). ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "object1.txt", "SourceMetadata": { "Type": "Object", "ContentSize": 6, "LastModified": "2022-10-07T20:48:32Z", "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"3a7c0b2f1d9e5c4a6f8b2e0d1c9f7a3b2\"", "ServerSideEncryption": "AES256" }, "UserMetadata": {}, "Tags": [] }, "Overwrite": "False", "TransferTimestamp": "2022-10-09T16:05:11.134040717Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "FAILED", "ErrorCode": "AccessDenied", "ErrorDetail": "User: arn:aws:sts::111222333444:assumed-role/AWSDataSyncS3Bucket/AwsSync-loc-0b3017fc4ba4a2d8d is not authorized to perform: kms:GenerateDataKey on resource: arn:aws:kms:us-east-1:111222333444:key/1111aaaa-22bb-33cc-44d-5555eeee6666 because no identity-based policy allows the kms:GenerateDataKey action" }] } ``` Este informe muestra que un objeto denominado `object1.txt` no se transfirió debido a un problema con los permisos del bucket de S3. (Si aparece un error como este, consulte [Proporcionar DataSync acceso a los depósitos de S3](create-s3-location.md#create-s3-location-access)). ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "/object1.txt", "SrcMetadata": { "Type": "Regular", "ContentSize": 6, "Mtime": "2022-01-07T16:59:26.136114671Z", "Atime": "2022-01-07T16:59:26.136114671Z", "Uid": 0, "Gid": 0, "Mode": "0644" }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2022-01-07T16:59:45.747270957Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "FAILED", "FailureReason": "S3 Get Object Failed", "FailureCode": 40974 }] } ``` ## Limitaciones + Los informes de tareas individuales no pueden superar los 5 MB. Si va a copiar una gran cantidad de archivos, es posible que el informe de tareas se divida en varios informes. + Hay situaciones en las que la creación de informes de tareas puede afectar al rendimiento de la transferencia de datos. Por ejemplo, puede que lo note cuando la conexión de red tiene una alta latencia y los archivos que está transfiriendo son pequeños o si solo está copiando los cambios en los metadatos. # Crear tus informes de DataSync tareas AWS DataSync los informes de tareas solo pueden ser un resumen de la ejecución de la tarea o un conjunto de informes detallados sobre lo que se DataSync intenta transferir, omitir, verificar y eliminar. ## Requisitos previos Antes de poder crear un informe de tarea, debe ejecutar las siguientes tareas. **Topics** + [Creación de un bucket de S3 para sus informes de tarea](#setting-up-task-report-create-bucket) + [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access) ### Creación de un bucket de S3 para sus informes de tarea Si aún no tiene uno, [cree un depósito de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) donde DataSync pueda cargar su informe de tareas. Los informes se almacenan en la clase de almacenamiento S3 Standard. Le recomendamos lo siguiente para este bucket: + Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. + Para evitar una configuración compleja de los permisos de acceso, asegúrate de que el grupo de informes de tareas esté en la misma región Cuenta de AWS y en la misma región que la tarea de DataSync transferencia. ### Permite DataSync cargar informes de tareas a tu bucket de S3 Debe configurar un rol AWS Identity and Access Management (de IAM) que le permita DataSync cargar un informe de tareas en su bucket de S3. En la DataSync consola, puede crear un rol de IAM que, en la mayoría de los casos, incluya automáticamente los permisos para cargar un informe de tareas en su bucket. Tenga en cuenta que es posible que este rol generado automáticamente no satisfaga sus necesidades desde el punto de vista de los privilegios mínimos. Esta función tampoco funcionará si el bucket está cifrado con una clave gestionada por el cliente AWS Key Management Service (AWS KMS) (SSE-KMS). En estos casos, puede crear el rol de forma manual siempre que dicho rol haga al menos lo siguiente: + [Evita el problema del suplente confuso entre servicios](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) en la entidad de confianza del rol. En el siguiente ejemplo completo se muestra cómo se pueden utilizar las claves de contexto de condición `aws:SourceAccount` global `aws:SourceArn` y las claves contextuales para evitar que se confunda con el problema de los adjuntos. DataSync ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:123456789012:*" } } } ] } ``` ------ + Permite DataSync cargar un informe de tareas a su bucket de S3. El siguiente ejemplo lo hace incluyendo la acción de `s3:PutObject` solo para un prefijo específico (`reports/`) en el bucket. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Action": [ "s3:PutObject" ], "Effect": "Allow", "Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*" }] } ``` ------ + Si el bucket de S3 está cifrado con una clave SSE-KMS gestionada por el cliente, la [política de la clave](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) debe incluir la función de IAM que se DataSync utiliza para acceder al bucket. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). ## Creación de un informe de tareas de tipo solo resumen Puede configurar un informe de tareas que incluya un [resumen solo](task-reports.md#task-report-types-summary) al crear la DataSync tarea, iniciarla o actualizarla. Los siguientes pasos muestran cómo configurar un informe de tareas de tipo solo resumen al crear una tarea. ### Uso de la DataSync consola 1. Abra la AWS DataSync consola en [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. En el panel de navegación situado a la izquierda, expanda **Transferencia de datos**; luego, seleccione **Tareas** y, a continuación, seleccione **Crear tarea**. 1. Configure las ubicaciones de origen y destino de la tarea. Para obtener más información, consulte [¿Dónde puedo transferir mis datos AWS DataSync?](working-with-locations.md) 1. Desplácese hacia abajo hasta la sección **Informe de tareas**. En **Tipo de informe**, seleccione **Solo resumen**. 1. Para el **depósito de informes de S3**, elija un depósito de S3 en el que DataSync desee cargar el informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. 1. En **Carpeta**, introduce un prefijo para usarlo en tu informe de tareas cuando lo DataSync cargues en tu bucket de S3 (por ejemplo,**reports/**). Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. 1. En **Rol de IAM**, realice una de las operaciones siguientes: + Elija **Generar automáticamente** para crear DataSync automáticamente un rol de IAM con los permisos necesarios para acceder al bucket de S3. Si DataSync anteriormente creó un rol de IAM para este bucket de S3, ese rol se elige de forma predeterminada. + Elija un rol de IAM personalizado que haya creado. En algunos casos, es posible que tenga que crear el rol por sí mismo. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si el bucket de S3 está cifrado con una clave SSE-KMS administrada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al bucket. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). 1. Termine de crear la tarea y, a continuación, [inicie la tarea](run-task.md) para empezar a transferir los datos. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). ### Uso del AWS CLI 1. Copie el siguiente comando `create-task` AWS Command Line Interface (AWS CLI): ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"SUMMARY_ONLY" }' ``` 1. Para el parámetro `--source-location-arn`, especifique el nombre de recurso de Amazon (ARN) de la ubicación de origen en la transferencia. `us-east-1`Sustitúyalo por el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `12345678abcdefgh` sustitúyalo por el identificador de ubicación de origen correspondiente. 1. Para el parámetro `--destination-location-arn`, especifique el ARN de la ubicación de destino en la transferencia. Sustituya por `us-east-1` el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `abcdefgh12345678` sustitúyalo por el identificador de ubicación de destino correspondiente. 1. Para el parámetro `--task-report-config`, haga lo siguiente: + `Subdirectory`— `reports/` Sustitúyalo por el prefijo del bucket de S3 en el que desee DataSync cargar los informes de tareas. Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. + `S3BucketArn`: especifique el ARN del bucket de S3 donde desea cargar su informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. + `BucketAccessRoleArn`— Especifique la función de IAM que permite DataSync cargar un informe de tareas en su bucket de S3. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si su depósito de S3 está cifrado con una clave SSE-KMS gestionada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al depósito. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique `SUMMARY_ONLY`. Para obtener más información, consulte [Resumen de los informes de tareas](task-reports.md#task-report-types-summary). 1. Ejecute el comando `create-task` para crear la tarea. Obtendrá una respuesta como la siguiente, en la que se muestra el ARN de la tarea que ha creado. Necesitará este ARN para ejecutar el comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie el siguiente comando `start-task-execution`. ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para el parámetro `--task-arn`, especifique el ARN de la tarea que está iniciando. Utilice el ARN que ha recibido al ejecutar el comando `create-task`. 1. Ejecute el comando `start-task-execution`. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). ## Creación de un informe de tareas estándar Puede configurar un [informe de tareas estándar](task-reports.md#task-report-types-standard) al crear su DataSync tarea, iniciarla o actualizarla. Los siguientes pasos muestran cómo configurar un informe de tareas de tipo estándar al crear una tarea. ### Uso de la DataSync consola 1. Abra la AWS DataSync consola en [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. En el panel de navegación situado a la izquierda, expanda **Transferencia de datos**; luego, seleccione **Tareas** y, a continuación, seleccione **Crear tarea**. 1. Configure las ubicaciones de origen y destino de la tarea. Para obtener más información, consulte [¿Dónde puedo transferir mis datos AWS DataSync?](working-with-locations.md) 1. Desplácese hacia abajo hasta la sección **Informe de tareas**. En **Tipo de informe**, seleccione **Informe estándar**. 1. En **Nivel de informe**, elija una de las siguientes opciones: + **Solo errores**: el informe de tareas incluye solo los problemas relacionados con lo que se DataSync intentó transferir, omitir, verificar y eliminar. + **Éxitos y errores**: el informe de tareas incluye lo que se DataSync ha transferido, omitido, verificado y eliminado correctamente y lo que no. + **Personalizado**: le permite elegir si desea ver solamente los errores o los éxitos y errores para aspectos específicos del informe de tareas. Por ejemplo, puede seleccionar **Éxitos y errores** para la lista de archivos transferidos, pero **Solo errores** para el resto del informe. 1. Si va a realizar la transferencia a un bucket de S3 que utiliza el control de versiones de objetos, deje la opción **Incluir versiones de objetos de Amazon S3** seleccionada si desea que su informe incluya la nueva versión de cada objeto transferido. 1. En el caso del **segmento de informes de S3**, elija un depósito de S3 en el que desee DataSync cargar el informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. 1. En **Carpeta**, introduce un prefijo para usarlo en tu informe de tareas cuando lo DataSync cargues en tu bucket de S3 (por ejemplo,**reports/**). Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. 1. En **Rol de IAM**, realice una de las operaciones siguientes: + Elija **Generar automáticamente** para crear DataSync automáticamente un rol de IAM con los permisos necesarios para acceder al bucket de S3. Si DataSync anteriormente creó un rol de IAM para este bucket de S3, ese rol se elige de forma predeterminada. + Elija un rol de IAM personalizado que haya creado. En algunos casos, es posible que tenga que crear el rol por sí mismo. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si el bucket de S3 está cifrado con una clave SSE-KMS administrada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al bucket. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). 1. Termine de crear la tarea e [inicie la tarea](run-task.md) para empezar a transferir los datos. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). ### Uso del AWS CLI 1. Copie el siguiente comando `create-task`: ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"STANDARD", "ReportLevel":"level-of-detail", "ObjectVersionIds":"include-or-not" }' ``` 1. Para el parámetro `--source-location-arn`, especifique el ARN de la ubicación de origen en la transferencia. Sustituya por `us-east-1` el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `12345678abcdefgh` sustitúyalo por el identificador de ubicación de origen correspondiente. 1. Para el parámetro `--destination-location-arn`, especifique el ARN de la ubicación de destino en la transferencia. Sustituya por `us-east-1` el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `abcdefgh12345678` sustitúyalo por el identificador de ubicación de destino correspondiente. 1. Para el parámetro `--task-report-config`, haga lo siguiente: + `Subdirectory`— `reports/` Sustitúyalo por el prefijo del bucket de S3 en el que desee DataSync cargar los informes de tareas. Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. + `S3BucketArn`: especifique el ARN del bucket de S3 donde desea cargar su informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. + `BucketAccessRoleArn`— Especifique la función de IAM que permite DataSync cargar un informe de tareas en su bucket de S3. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si su depósito de S3 está cifrado con una clave SSE-KMS gestionada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al depósito. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique el informe de `STANDARD`. Para obtener más información, consulte [Informes de tareas estándar](task-reports.md#task-report-types-standard)Tipos de informes de tareas. + (Opcional) `ReportLevel`: especifique si desea `ERRORS_ONLY` (opción predeterminada) o `SUCCESSES_AND_ERRORS` en su informe. + (Opcional) `ObjectVersionIds`: si va a realizar la transferencia a un bucket de S3 que utiliza el control de versiones de objetos, especifique `NONE` si no desea incluir la nueva versión para cada objeto transferido en el informe. Esta opción está configurada en `INCLUDE` de forma predeterminada. + (Opcional) `Overrides`: personalice el `ReportLevel` de un aspecto concreto del informe. Por ejemplo, es posible que desee consultar `SUCCESSES_AND_ERRORS` la lista de lo que se DataSync elimina en su ubicación de destino, pero `ERRORS_ONLY` prefiera ver todo lo demás. En este ejemplo, añadiría la siguiente opción `Overrides` al parámetro `--task-report-config`: ``` "Overrides":{ "Deleted":{ "ReportLevel":"SUCCESSES_AND_ERRORS" } } ``` Si no usa `Overrides`, todo el informe usará el `ReportLevel` que usted especifique. 1. Ejecute el comando `create-task` para crear la tarea. Obtendrá una respuesta como la siguiente, en la que se muestra el ARN de la tarea que ha creado. Necesitará este ARN para ejecutar el comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie el siguiente comando `start-task-execution`. ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para el parámetro `--task-arn`, especifique el ARN de la tarea que está ejecutando. Utilice el ARN que ha recibido al ejecutar el comando `create-task`. 1. Ejecute el comando `start-task-execution`. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). # Ver tus informes de DataSync tareas DataSync crea informes de tareas para cada ejecución de tareas. Cuando la ejecución se complete, encontrará el informe de la tarea pertinente en su bucket de S3. Los informes de tareas se organizan con prefijos que incluyen IDs las tareas y sus ejecuciones. Para ayudar a localizar los informes de tareas en el bucket de S3, utilice estos ejemplos: + **Informe de tareas de tipo solo resumen**: `reports-prefix/Summary-Reports/task-id-folder/task-execution-id-folder` + **Informe de tareas estándar**: `reports-prefix/Detailed-Reports/task-id-folder/task-execution-id-folder` Como los informes de tareas están en formato JSON, tiene varias opciones para verlos: + Visualizar un informe con [Amazon S3 Select](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html). + Visualice los informes mediante AWS servicios como AWS Glue Amazon Athena y Amazon Quick. Para obtener más información sobre la visualización de los informes de tareas, consulte el [blog sobre almacenamiento de AWS](https://aws.amazon.com/blogs/storage/derive-insights-from-aws-datasync-task-reports-using-aws-glue-amazon-athena-and-amazon-quicksight/).