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. # 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).