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.
# Creación de una tarea para transferir los datos
Una *tarea* describe dónde y cómo se AWS DataSync transfieren los datos. Una tarea consta de lo siguiente:
+ [**Ubicación de origen**](working-with-locations.md): el sistema o servicio de almacenamiento desde el que se DataSync transfieren los datos.
+ [**Ubicación de destino**](working-with-locations.md): el sistema o servicio de almacenamiento al que se DataSync transfieren los datos.
+ [**Opciones de la tarea**](task-options.md): ajustes como qué archivos transferir, cómo se verifican los datos, cuándo se ejecuta la tarea y más.
+ [**Ejecuciones de tareas**](run-task.md): cuando ejecuta una tarea, esto se llama *ejecución de tareas*.
## Creación de su tarea de
Al crear una DataSync tarea, se especifican las ubicaciones de origen y destino. También puede personalizar la tarea eligiendo qué archivos desea transferir, cómo se gestionan los metadatos, estableciendo un cronograma y mucho más.
Antes de crear la tarea, asegúrate de entender [cómo funcionan DataSync las transferencias](how-datasync-transfer-works.md#transferring-files) y revisa las [cuotas de tareas](datasync-limits.md#task-hard-limits).
**importante**
Si planea transferir datos a o desde una ubicación de Amazon S3, consulte [cómo DataSync pueden afectar los cargos por solicitud de S3](create-s3-location.md#create-s3-location-s3-requests) y la [página de DataSync precios](https://aws.amazon.com/datasync/pricing/) antes de empezar.
### 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. Asegúrese de estar en uno de los Regiones de AWS lugares donde planea transferir datos.
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. En la página **Configure source location (Configurar ubicación de origen)** elija [crear](transferring-data-datasync.md) o elija una ubicación de origen y después elija **Next (Siguiente)**.
1. En la página **Configurar ubicación de destino**, [crea](transferring-data-datasync.md) o elige una ubicación de destino y, a continuación, selecciona **Siguiente**.
1. (Recomendado) En la página de **configuración**, asigne a la tarea un nombre que pueda recordar.
1. Mientras se encuentre en la página de **configuración**, elija las opciones de la tarea o utilice la configuración predeterminada.
Puede que te interesen algunas de las siguientes opciones:
+ Especifique el [modo de tarea](choosing-task-mode.md) que desea usar.
+ Especifique qué datos desea transferir mediante un [manifiesto](transferring-with-manifest.md) o [filtros](filtering.md).
+ Configure cómo [gestionar los metadatos de los archivos](configure-metadata.md) y [verificar la integridad de los datos](configure-data-verification-options.md).
+ Supervisa tu transferencia con [informes de tareas](task-reports.md) o [Amazon CloudWatch](monitor-datasync.md). Le recomendamos configurar algún tipo de supervisión para su tarea.
Cuando haya terminado, elija **Siguiente**.
1. Revise la configuración de la tarea y después elija **Crear tarea**.
Ya está listo para [comenzar su tarea](run-task.md).
### Usando el AWS CLI
Una vez que [haya creado las ubicaciones de DataSync origen y destino](transferring-data-datasync.md), podrá crear su tarea.
1. En AWS CLI la configuración, asegúrate de usar una de las ubicaciones en las Regiones de AWS que planeas transferir los datos.
1. Copie el siguiente comando `create-task`:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name"
```
1. Para `--source-location-arn`, especifique el nombre de recurso de Amazon (ARN) de la ubicación de origen.
1. Para `--destination-location-arn`, especifique el ARN de la ubicación de destino.
Si realizas una transferencia entre Regiones de AWS nuestras cuentas, asegúrate de que el ARN incluya la otra región o ID de cuenta.
1. (Recomendado) Para`--name`, especifique un nombre para la tarea que pueda recordar.
1. Especifique otras opciones de tareas según sea necesario. Puede que te interesen algunas de las siguientes opciones:
+ Especifique qué datos desea transferir mediante un [manifiesto](transferring-with-manifest.md) o [filtros](filtering.md).
+ Configure cómo [gestionar los metadatos de los archivos](configure-metadata.md) y [verificar la integridad de los datos](configure-data-verification-options.md).
+ Supervisa tu transferencia con [informes de tareas](task-reports.md) o [Amazon CloudWatch](monitor-datasync.md). Le recomendamos configurar algún tipo de supervisión para su tarea.
Para ver más opciones, consulta [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). A continuación, se muestra un `create-task` comando de ejemplo que especifica varias opciones:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--cloud-watch-log-group-arn "arn:aws:logs:region:account-id" \
--name "task-name" \
--options VerifyMode=NONE,OverwriteMode=NEVER,Atime=BEST_EFFORT,Mtime=PRESERVE,Uid=INT_VALUE,Gid=INT_VALUE,PreserveDevices=PRESERVE,PosixPermissions=PRESERVE,PreserveDeletedFiles=PRESERVE,TaskQueueing=ENABLED,LogLevel=TRANSFER
```
1. Ejecute el comando `create-task`.
Si el comando se ejecuta correctamente, recibirá una respuesta que le mostrará el ARN de la tarea que creó. Por ejemplo:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
Ya está listo para [comenzar su tarea](run-task.md).
## Estados de las tareas
Cuando creas una DataSync tarea, puedes comprobar su estado para ver si está lista para ejecutarse.
| Estado de la consola | Estado de la API | Description (Descripción) |
| --- | --- | --- |
| Disponible | `AVAILABLE` | La tarea está lista para empezar a transferir datos. |
| Ejecutar | `RUNNING` | La ejecución de una tarea está en curso. Para obtener más información, consulte [Estados de ejecución de las tareas](run-task.md#understand-task-execution-statuses). |
| No disponible | `UNAVAILABLE` | Un DataSync agente utilizado por la tarea está desconectado. Para obtener más información, consulte [¿Qué hago si mi agente está desconectado?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline) |
| En cola | `QUEUED` | Se está ejecutando otra tarea en la que se utiliza el mismo DataSync agente. Para obtener más información, consulte [Saber cuándo la tarea está en cola](run-task.md#queue-task-execution). |
## Partición de conjuntos de datos grandes con varias tareas
Si va a transferir un conjunto de datos grande, como [migrar](datasync-large-migration.md) millones de archivos u objetos, le recomendamos que utilice el modo DataSync mejorado para la transferencia, que permite transferir conjuntos de datos con un número prácticamente ilimitado de archivos. En el caso de conjuntos de datos muy grandes, con miles de millones de archivos, deberías considerar la posibilidad de particionar el conjunto de datos con varias tareas. DataSync Dividir los datos en varias tareas (y, posiblemente, en [agentes](do-i-need-datasync-agent.md#multiple-agents), según las ubicaciones) ayuda a reducir el tiempo que se tarda en preparar y transferir DataSync los datos.
Considere algunas de las formas en que puede particionar un conjunto de datos grande en varias DataSync tareas:
+ Cree tareas que transfieran carpetas independientes. Por ejemplo, puede crear dos tareas que tengan como destino `/FolderA` y `/FolderB`, respectivamente, en el almacenamiento de origen.
+ Cree tareas que transfieran subconjuntos de archivos, objetos y carpetas mediante un [manifiesto](transferring-with-manifest.md) o [filtros](filtering.md).
Tenga en cuenta que este enfoque puede aumentar las I/O operaciones de almacenamiento y afectar al ancho de banda de la red. Para obtener más información, consulte el blog sobre [Cómo acelerar las transferencias de datos con arquitecturas DataSync escalables](https://aws.amazon.com/blogs/storage/how-to-accelerate-your-data-transfers-with-aws-datasync-scale-out-architectures/).
## Segmentación de los datos transferidos con varias tareas
Si va a transferir diferentes conjuntos de datos al mismo destino, puede crear varias tareas para ayudar a segmentar los datos que transfiere.
Por ejemplo, si va a realizar la transferencia al mismo bucket de S3 denominado `MyBucket`, puede crear distintos prefijos en el bucket que correspondan a cada tarea. Este enfoque evita que el nombre del archivo entre en conflicto con los conjuntos de datos y te permite establecer diferentes permisos para cada prefijo. A continuación le explicamos cómo puede configurar esto:
1. Cree tres prefijos en el destino `MyBucket` denominado `task1`, `task2` y`task3`:
+ `s3://MyBucket/task1`
+ `s3://MyBucket/task2`
+ `s3://MyBucket/task3`
1. Cree tres DataSync tareas denominadas `task1``task2`, y `task3` que se transfieran al prefijo correspondiente en. `MyBucket`
# Selección del modo de tarea para la transferencia de datos
AWS DataSync La tarea se puede ejecutar en uno de los siguientes modos:
+ **Modo mejorado**: transfiere un número prácticamente ilimitado de archivos u objetos con un rendimiento superior al del modo básico. Las tareas en modo mejorado optimizan el proceso de transferencia de datos mediante la enumeración, la preparación, la transferencia y la verificación de los datos en paralelo. El modo mejorado está disponible actualmente para transferencias entre ubicaciones de Amazon S3, transferencias entre Amazon S3 Azure Blob y Amazon S3 sin agente, transferencias entre otras nubes y Amazon S3 sin agente y transferencias entre servidores de archivos NFS o SMB y Amazon S3 mediante un agente de modo mejorado.
+ **Modo básico**: transfiere archivos u objetos entre el AWS almacenamiento y todas las demás ubicaciones compatibles DataSync . Las tareas en modo básico están sujetas a [cuotas](datasync-limits.md) sobre el número de archivos, objetos y directorios en un conjunto de datos. El modo básico prepara, transfiere y verifica los datos de forma secuencial, lo que lo hace más lento que el modo mejorado para la mayoría de las cargas de trabajo.
## Descripción de las diferencias entre los modos de tarea
La siguiente información puede resultar útil a la hora de determinar qué modo de tarea usar.
| Funcionalidad | Comportamiento del modo mejorado | Comportamiento del modo básico |
| --- | --- | --- |
| [Rendimiento](how-datasync-transfer-works.md#transferring-files) | DataSync enumera, prepara, transfiere y verifica sus datos en paralelo. Ofrece un rendimiento superior al del modo básico para la mayoría de las cargas de trabajo (como la transferencia de objetos de gran tamaño). | DataSync prepara, transfiere y verifica los datos de forma secuencial. El rendimiento es inferior al del modo mejorado para la mayoría de las cargas de trabajo. |
| Número de elementos de un conjunto de datos con los que se DataSync puede trabajar por ejecución de una tarea | Cantidades prácticamente ilimitadas de objetos | Se aplican [cuotas](datasync-limits.md#task-hard-limits) |
| [Contadores](transfer-performance-counters.md) de transferencia de datos y [métricas](monitor-datasync.md) | Más contadores y métricas que en el modo Básico, como el número de objetos que DataSync se encuentran en la ubicación de origen, el número de objetos que se preparan durante la ejecución de cada tarea y contadores de carpetas similares a los contadores de archivos y objetos | Menos contadores y métricas que en el modo mejorado |
| [Registro](configure-logging.md) | Registros estructurados (formato JSON) | Registros no estructurados |
| [Ubicaciones compatibles](working-with-locations.md) | Actualmente, para transferencias entre ubicaciones de Amazon S3, transferencias entre Amazon S3 Azure Blob y Amazon S3 sin un agente, transferencias entre otras nubes y Amazon S3 sin un agente y transferencias entre servidores de archivos NFS o SMB y Amazon S3 mediante un agente en modo mejorado. | Para transferencias entre todas las ubicaciones que admite DataSync |
| [Opciones de verificación de datos](configure-data-verification-options.md) | DataSync verifica solo los datos transferidos | DataSync verifica todos los datos de forma predeterminada |
| Costo | Para obtener más información, consulta la página de [DataSync precios](https://aws.amazon.com/datasync/pricing) | Para obtener más información, consulta la página [DataSync de precios](https://aws.amazon.com/datasync/pricing) |
| Gestión de errores para etiquetas de objetos no compatibles | En las transferencias de almacenamiento en la nube hacia o desde ubicaciones que no admiten el etiquetado de objetos, la ejecución de la tarea falla de inmediato si la opción ObjectTags no se especifica o se establece en PRESERVE. | En las transferencias de almacenamiento en la nube hacia o desde ubicaciones que no admiten el etiquetado de objetos, la ejecución de la tarea se realiza con normalidad, pero informa errores por objeto para los objetos etiquetados si la opción ObjectTags no se especifica o se establece en PRESERVE. |
## Selección del modo de tarea
Puede elegir el modo mejorado solo para las transferencias entre ubicaciones de Amazon S3, las transferencias entre Amazon S3 Azure Blob y Amazon S3 sin un agente, las transferencias entre otras nubes y Amazon S3 sin un agente y las transferencias entre servidores de archivos NFS o SMB y Amazon S3 mediante un agente de modo mejorado. En caso contrario, debe usar el modo básico Por ejemplo, una transferencia desde una ubicación [HDFS local a una ubicación](create-hdfs-location.md) S3 requiere el modo básico.
Las opciones y el rendimiento de la tarea pueden variar en función del modo de tarea que se seleccione. Una vez creada la tarea, no es posible cambiar el modo de tarea.
**Permisos necesarios**
Para crear una tarea en modo mejorado, el rol de IAM que utilices DataSync debe tener el permiso. `iam:CreateServiceLinkedRole`
Para tus permisos DataSync de usuario, considera la posibilidad de [AWSDataSyncFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-awsdatasyncfullaccess)utilizarlos. Se trata de una política AWS gestionada que proporciona al usuario un acceso total DataSync y mínimo a sus dependencias.
### Uso de la consola DataSync
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. En **Modo de tarea**, seleccione una de las siguientes opciones:
+ **Mejorado**
+ **Básica**
Para obtener más información, consulte [Descripción de las diferencias entre los modos de tarea](#task-mode-differences).
1. Mientras aún se encuentre en la página **Configurar ajustes**, seleccione otras opciones de la tarea o use la configuración predeterminada.
Puede que te interesen algunas de las siguientes opciones:
+ Especifique qué datos desea transferir mediante un [manifiesto](transferring-with-manifest.md) o [filtros](filtering.md).
+ Configure cómo [gestionar los metadatos de los archivos](configure-metadata.md) y [verificar la integridad de los datos](configure-data-verification-options.md).
+ Supervisa tu transferencia con [informes de tareas](task-reports.md) o [Amazon CloudWatch Logs](monitor-datasync.md).
Cuando haya terminado, elija **Siguiente**.
1. Revise la configuración de la tarea y después elija **Crear tarea**.
### Usando el AWS CLI
1. En tu AWS CLI configuración, asegúrate de usar uno de los Regiones de AWS lugares donde planeas transferir datos.
1. Copie el siguiente comando `create-task`:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--task-mode "ENHANCED-or-BASIC"
```
1. Para `--source-location-arn`, especifique el nombre de recurso de Amazon (ARN) de la ubicación de origen.
1. Para `--destination-location-arn`, especifique el ARN de la ubicación de destino.
Si realizas una transferencia entre Regiones de AWS nuestras cuentas, asegúrate de que el ARN incluya la otra región o ID de cuenta.
1. En `--task-mode`, especifique `ENHANCED` o `BASIC`.
Para obtener más información, consulte [Descripción de las diferencias entre los modos de tarea](#task-mode-differences).
1. Especifique otras opciones de tareas según sea necesario. Puede que te interesen algunas de las siguientes opciones:
+ Especifique qué datos desea transferir mediante un [manifiesto](transferring-with-manifest.md) o [filtros](filtering.md).
+ Configure cómo [gestionar los metadatos de los archivos](configure-metadata.md) y [verificar la integridad de los datos](configure-data-verification-options.md).
+ Supervisa tu transferencia con [informes de tareas](task-reports.md) o [Amazon CloudWatch Logs](monitor-datasync.md).
Para ver más opciones, consulta [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html). A continuación se muestra un ejemplo de un comando `create-task` que especifica el modo mejorado y varias opciones adicionales:
```
aws datasync create-task \
--source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \
--name "task-name" \
--task-mode "ENHANCED" \
--options TransferMode=CHANGED,VerifyMode=ONLY_FILES_TRANSFERRED,ObjectTags=PRESERVE,LogLevel=TRANSFER
```
1. Ejecute el comando `create-task`.
Si el comando se ejecuta correctamente, recibirá una respuesta que le mostrará el ARN de la tarea que creó. Por ejemplo:
```
{
"TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026"
}
```
### Uso de la DataSync API
Puede especificar el modo de DataSync tarea configurando el `TaskMode` parámetro en la [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)operación.
# Elegir qué AWS DataSync se transfiere
AWS DataSync le permite elegir qué desea transferir y cómo quiere que se traten sus datos. Algunas opciones son:
+ Transferir una lista exacta de archivos u objetos mediante un manifiesto.
+ Incluir o excluir ciertos tipos de datos en su transferencia mediante un filtro.
+ En el caso de las transferencias periódicas, se mueven solo los datos que han cambiado desde la última transferencia
+ Sobrescribir los datos de la ubicación de destino para que coincidan con los de la ubicación de origen.
+ Elegir qué metadatos de archivo u objeto se van a conservar en las distintas ubicaciones de almacenamiento.
**Topics**
+ [Transferir archivos u objetos específicos mediante un manifiesto](transferring-with-manifest.md)
+ [Transferencia de archivos, objetos y carpetas específicos mediante filtros](filtering.md)
+ [Comprender cómo se DataSync gestionan los metadatos de archivos y objetos](metadata-copied.md)
+ [Enlaces y directorios copiados por AWS DataSync](special-files-copied.md)
+ [Configuración de la forma en que gestionan los archivos, los objetos y los metadatos](configure-metadata.md)
# Transferir archivos u objetos específicos mediante un manifiesto
Un *manifiesto* es una lista de archivos u objetos que AWS DataSync deseas transferir. Por ejemplo, en lugar de tener que transferir todo lo que hay en un bucket de S3 con potencialmente millones de objetos, DataSync transfiere solo los objetos que incluyes en tu manifiesto.
Los manifiestos son similares a los [filtros](filtering.md), pero permiten identificar exactamente qué archivos u objetos se van a transferir en lugar de datos que coincidan con un patrón de filtro.
**nota**
El tamaño máximo permitido para un archivo de manifiesto con tareas en modo mejorado es de 20 GB.
## Creación de un manifiesto
Un manifiesto es un archivo con formato de valores separados por comas (CSV) en el que se enumeran los archivos u objetos de la ubicación de origen que deseas transferir. DataSync Si el origen es un bucket de S3, también puede incluir la versión de un objeto que desea transferir.
**Topics**
+ [Directrices](#transferring-with-manifest-guidelines)
+ [Ejemplos de manifiestos](#manifest-examples)
### Directrices
Usa estas pautas para ayudarte a crear un manifiesto que funcione con. DataSync
------
#### [ Do ]
+ Especifique la ruta completa de cada archivo u objeto que desea transferir.
No puede especificar solo un directorio o una carpeta con la intención de transferir todo su contenido. En estas situaciones, considere usar un [filtro de inclusión](filtering.md) en lugar de un manifiesto.
+ Asegúrese de que la ruta de cada archivo u objeto es relativa a la ruta de montaje, carpeta, directorio o prefijo que especificó al configurar la ubicación de DataSync origen.
Por ejemplo, supongamos que [configura una ubicación de S3 ](create-s3-location.md#create-s3-location-how-to) con unprefijo denominado `photos`. Ese prefijo incluye un objeto `my-picture.png` que desea transferir. En el manifiesto, solo necesita especificar el objeto (`my-picture.png`) en lugar del prefijo y el objeto (`photos/my-picture.png`).
+ Para especificar la versión del objeto de Amazon S3 IDs, separe la ruta del objeto y el ID de versión mediante una coma.
En el siguiente ejemplo, se muestra una entrada de manifiesto con dos campos. El primer campo incluye un objeto denominado `picture1.png`. El segundo campo está separado por una coma e incluye un identificador de versión de `111111`:
```
picture1.png,111111
```
+ Utilice comillas en las siguientes situaciones:
+ Cuando una ruta contiene caracteres especiales (comas, comillas y finales de línea):
`"filename,with,commas.txt"`
+ Cuando una ruta abarca varias líneas:
```
"this
is
a
filename.txt"
```
+ Cuando una ruta incluye comillas:
`filename""with""quotes.txt`
Esto representa una ruta denominada `filename"with"quotes.txt`.
Estas reglas de citación también se aplican a los campos de ID de versión. En general, si el campo de un manifiesto tiene una comilla, debes incluir otra comilla de cierre.
+ Separe cada entrada de archivo u objeto con una línea nueva.
Puede separar las líneas mediante saltos de línea al estilo Linux (avance de línea o corte de línea) o Windows (corte de línea seguido de un corte de línea).
+ Guarda el manifiesto (por ejemplo, `my-manifest.csv` o `my-manifest.txt`).
+ Cargue el manifiesto en un bucket de S3 al que [DataSync pueda acceder](#transferring-with-manifest-access).
Este depósito no tiene que estar en la misma cuenta Región de AWS o en la misma cuenta en la que lo estás usando DataSync.
------
#### [ Don't ]
+ Especifique solo un directorio o una carpeta con la intención de transferir todo su contenido.
Un manifiesto solo puede incluir las rutas completas de los archivos y los objetos que desea transferir. Si configura la ubicación de origen para usar una ruta de montaje, carpeta, directorio o prefijo específicos, no tiene que incluirlos en el manifiesto.
+ Especifique una ruta de archivo u objeto que supere los 4096 caracteres.
+ Especifique una ruta de archivo, una ruta de objeto o un ID de versión del objeto de Amazon S3 que supere los 1024 bytes.
+ Especifique rutas de archivos u objetos duplicadas.
+ Incluye un identificador de versión del objeto si la ubicación de origen no es un bucket de S3.
+ Incluye más de dos campos en una entrada de manifiesto.
Una entrada solo puede incluir una ruta de archivo u objeto y (si corresponde) un ID de versión del objeto de Amazon S3.
+ Incluya caracteres que no se ajusten a la codificación UTF-8.
+ Incluya espacios no intencionados en sus campos de entrada fuera de las comillas.
------
### Ejemplos de manifiestos
Usa estos ejemplos para ayudarte a crear un manifiesto que funcione con DataSync.
**Manifiesto con rutas completas de archivos u objetos**
En el siguiente ejemplo se muestra un manifiesto con las rutas completas de los archivos u objetos que desea transferir.
```
photos/picture1.png
photos/picture2.png
photos/picture3.png
```
**Manifiesto solo con claves de objetos**
El siguiente ejemplo muestra un manifiesto con objetos para transferir desde una ubicación de origen de Amazon S3. Como la [ubicación está configurada](create-s3-location.md#create-s3-location-how-to) con el prefijo `photos`, solo se especifican las claves de los objetos.
```
picture1.png
picture2.png
picture3.png
```
**Manifiesto con las rutas y la versión de los objetos IDs**
Las dos primeras entradas del siguiente ejemplo de manifiesto incluyen versiones específicas de objetos de Amazon S3 que se van a transferir.
```
photos/picture1.png,111111
photos/picture2.png,121212
photos/picture3.png
```
**Manifiesto con caracteres UTF-8**
En el siguiente ejemplo se muestra un manifiesto con archivos que incluyen caracteres UTF-8.
```
documents/résumé1.pdf
documents/résumé2.pdf
documents/résumé3.pdf
```
## Proporcionar DataSync acceso a tu manifiesto
Necesitas un rol AWS Identity and Access Management (IAM) que dé DataSync acceso a tu manifiesto en su bucket de S3. Este rol debe incluir los permisos siguientes:
+ `s3:GetObject`
+ `s3:GetObjectVersion`
Puede generar este rol automáticamente en la DataSync consola o crearlo usted mismo.
**nota**
Si tu manifiesto está en otro lugar Cuenta de AWS, debes crear este rol manualmente.
### Creación automática del rol de IAM
Al crear o iniciar una tarea de transferencia en la consola, DataSync puedes crearte un rol de IAM con los `s3:GetObjectVersion` permisos `s3:GetObject` y los que necesitas para acceder a tu manifiesto.
**Permisos necesarios para crear el rol automáticamente**
Para crear el rol automáticamente, asegúrate de que el rol que estás usando para acceder a la DataSync consola tenga los siguientes permisos:
+ `iam:CreateRole`
+ `iam:CreatePolicy`
+ `iam:AttachRolePolicy`
### Crear el rol de IAM (misma cuenta)
Puedes crear manualmente el rol de IAM que DataSync necesita acceder a tu manifiesto. En las siguientes instrucciones se da por sentado que estás en el mismo Cuenta de AWS lugar en el que lo usas DataSync y que se encuentra el bucket de S3 del manifiesto.
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación situado a la izquierda, en **Administración de acceso**, elija **Roles** y luego **Crear rol**.
1. En la página **Seleccionar entidad de confianza**, en **Tipo de entidad de confianza**, elija **Servicio de AWS**.
1. **En Caso de uso**, elige una opción **DataSync**en la lista desplegable y selecciona **DataSync**. Elija **Siguiente**.
1. En la página **Agregar permisos**, elija **Siguiente**. Introduzca un nombre de rol y elija **Crear rol**.
1. En la página **Roles**, busque el rol que acaba de crear y seleccione el nombre.
1. En la página de detalles del rol, elija la pestaña **Permisos**. Elija **Agregar permisos** y luego **Crear política insertada**.
1. Elija la pestaña **JSON** y pegue la siguiente política de ejemplo en el editor de políticas:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. En la política de ejemplo que acaba de pegar, sustituya los siguientes valores por los suyos:
1. Reemplace `amzn-s3-demo-bucket` por el nombre del bucket de S3 que aloja el manifiesto.
1. Reemplace `my-manifest.csv` por el nombre del archivo de su manifiesto.
1. Elija **Siguiente**. Escriba un nombre para la política y elija **Crear política**.
1. (Recomendado) Para evitar el [problema del suplente confuso entre servicios](cross-service-confused-deputy-prevention.md), haga lo siguiente:
1. En la página de detalles del rol, elija la pestaña **Relaciones de confianza**. Elija **Editar la política de confianza**.
1. Actualice la política de confianza mediante el siguiente ejemplo, que incluye las claves de contexto de condición global de `aws:SourceArn` y `aws:SourceAccount`:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "555555555555"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:555555555555:*"
}
}
}
]
}
```
------
+ Sustituya cada instancia por `account-id` el Cuenta de AWS ID que esté utilizando DataSync.
+ `region`Sustitúyala por la ubicación Región de AWS que estás utilizando DataSync.
1. Elija **Actualizar política**.
Has creado un rol de IAM que te permite acceder DataSync a tu manifiesto. Especifique este rol al [crear](#manifest-creating-task) o [iniciar](#manifest-starting-task) la tarea.
### Crear el rol de IAM (cuenta diferente)
Si tu manifiesto está en un bucket de S3 que pertenece a otro Cuenta de AWS, debes crear manualmente el rol de IAM que se DataSync utiliza para acceder al manifiesto. Luego, Cuenta de AWS en la ubicación del manifiesto, debes incluir el rol en la política del bucket de S3.
#### Creación del rol
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación situado a la izquierda, en **Administración de acceso**, elija **Roles** y luego **Crear rol**.
1. En la página **Seleccionar entidad de confianza**, en **Tipo de entidad de confianza**, elija **Servicio de AWS**.
1. **En Caso de uso**, elige una opción **DataSync**en la lista desplegable y selecciona **DataSync**. Elija **Siguiente**.
1. En la página **Agregar permisos**, elija **Siguiente**. Introduzca un nombre de rol y elija **Crear rol**.
1. En la página **Roles**, busque el rol que acaba de crear y seleccione el nombre.
1. En la página de detalles del rol, elija la pestaña **Permisos**. Elija **Agregar permisos** y luego **Crear política insertada**.
1. Elija la pestaña **JSON** y pegue la siguiente política de ejemplo en el editor de políticas:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [{
"Sid": "DataSyncAccessManifest",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/my-manifest.csv"
}]
}
```
------
1. En la política de ejemplo que acaba de pegar, sustituya los siguientes valores por los suyos:
1. Reemplace `amzn-s3-demo-bucket` por el nombre del bucket de S3 que aloja el manifiesto.
1. Reemplace `my-manifest.csv` por el nombre del archivo de su manifiesto.
1. Elija **Siguiente**. Escriba un nombre para la política y elija **Crear política**.
1. (Recomendado) Para evitar el [problema del suplente confuso entre servicios](cross-service-confused-deputy-prevention.md), haga lo siguiente:
1. En la página de detalles del rol, elija la pestaña **Relaciones de confianza**. Elija **Editar la política de confianza**.
1. Actualice la política de confianza mediante el siguiente ejemplo, que incluye las claves de contexto de condición global de `aws:SourceArn` y `aws:SourceAccount`:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "datasync.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "000000000000"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:datasync:us-east-1:000000000000:*"
}
}
}
]
}
```
------
+ Sustituya cada instancia `account-id` de por el Cuenta de AWS ID que esté utilizando DataSync.
+ `region`Reemplázala por la Región de AWS que estás usando DataSync.
1. Elija **Actualizar política**.
Ha creado el rol de IAM que puede incluir en su política de bucket de S3.
#### Actualización de la política del bucket de S3 con el rol
Una vez que hayas creado el rol de IAM, debes añadirlo a la política de bucket de S3 en el otro Cuenta de AWS lugar en el que se encuentra tu manifiesto.
1. En el Consola de administración de AWS, cambia a la cuenta con el bucket de S3 de tu manifiesto.
1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En la página de detalles del bucket, elija la pestaña **Permisos**.
1. En **Política de buckets**, seleccione **Editar** y haga lo siguiente para modificar su política de bucket de S3:
1. Actualice lo que hay en el editor para incluir las siguientes declaraciones de política:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DataSyncAccessManifestBucket",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:GetObjectVersion"
],
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket"
}
]
}
```
------
1. `account-id`Sustitúyelo por el Cuenta de AWS ID de la cuenta con la que estás utilizando DataSync .
1. `datasync-role`Sustitúyalo por el rol de IAM que acabas de crear y que permite acceder DataSync a tu manifiesto.
1. Reemplace `amzn-s3-demo-bucket` por el nombre del bucket de S3 que aloja el manifiesto en el otro Cuenta de AWS.
1. Seleccione **Save changes (Guardar cambios)**.
Has creado un rol de IAM que te permite acceder DataSync a tu manifiesto en la otra cuenta. Especifique este rol al [crear](#manifest-creating-task) o [iniciar](#manifest-starting-task) la tarea.
## Especificar el manifiesto al crear una tarea
Puedes especificar el manifiesto que quieres usar DataSync 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 de la izquierda, seleccione **Tasks (Tareas)** y, a continuación, seleccione **Create task (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. Para **Contenido a digitalizar**, seleccione **Archivos, objetos y carpetas específicos** y, a continuación, seleccione **Uso de un manifiesto**.
1. Para el **URI de S3**, elija el manifiesto que esté alojado en un bucket de S3.
De forma alternativa, puede introducir el URI (por ejemplo, `s3://bucket/prefix/my-manifest.csv`).
1. En la **versión Object**, elige la versión del manifiesto que DataSync quieres usar.
De forma predeterminada, DataSync usa la última versión del objeto.
1. Para **rol de acceso al manifiesto**, realice una de las operaciones siguientes:
+ Seleccione **Generar automáticamente** DataSync para crear automáticamente un rol de IAM con los permisos necesarios para acceder al manifiesto en su bucket de S3.
+ Elija un rol de IAM existente que pueda acceder a su manifiesto.
Para obtener más información, consulte [Proporcionar DataSync acceso a tu manifiesto](#transferring-with-manifest-access).
1. Configure cualquier otro ajuste que desee para las tareas y, a continuación, seleccione **Siguiente**.
1. Seleccione **Crear tarea**.
### Usando el 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 \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. Para el parámetro `--source-location-arn`, especifique el nombre de recurso de Amazon (ARN) de la ubicación desde la que transfiere los datos.
1. Para el parámetro `--destination-location-arn`, especifique el ARN de la ubicación a la que transfiere los datos.
1. Para el parámetro `--manifest-config`, haga lo siguiente:
+ `ManifestObjectPath`: especifique la clave de objeto S3 de su manifiesto.
+ `BucketAccessRoleArn`— Especifique la función de IAM que permite acceder DataSync al manifiesto en su bucket de S3.
Para obtener más información, consulte [Proporcionar DataSync acceso a tu manifiesto](#transferring-with-manifest-access).
+ `S3BucketArn`: especifique el ARN del bucket de S3 que aloja el manifiesto.
+ `ManifestObjectVersionId`— Especifica la versión del manifiesto que quieres DataSync usar.
De forma predeterminada, DataSync utiliza la última versión del objeto.
1. Ejecute el comando `create-task` para crear la tarea.
Cuando lo tenga todo listo, puede [iniciar la tarea de transferencia](run-task.md).
## Especificar el manifiesto al iniciar una tarea
Puede especificar el manifiesto que desea usar DataSync al ejecutar 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 de la izquierda, elija **Tasks (Tareas)** y, a continuación, elija la tarea que desea iniciar.
1. En la página de descripción general de la tarea, elija **Iniciar** y, a continuación, elija **Comenzar con las opciones de anulación**.
1. Para **Contenido a digitalizar**, seleccione **Archivos, objetos y carpetas específicos** y, a continuación, seleccione **Uso de un manifiesto**.
1. Para el **URI de S3**, elija el manifiesto que esté alojado en un bucket de S3.
De forma alternativa, puede introducir el URI (por ejemplo, `s3://bucket/prefix/my-manifest.csv`).
1. En la **versión Object**, elige la versión del manifiesto que DataSync quieres usar.
De forma predeterminada, DataSync usa la última versión del objeto.
1. Para **rol de acceso al manifiesto**, realice una de las operaciones siguientes:
+ Seleccione **Generar automáticamente** DataSync para crear automáticamente un rol de IAM para acceder al manifiesto en su bucket de S3.
+ Elija un rol de IAM existente que pueda acceder a su manifiesto.
Para obtener más información, consulte [Proporcionar DataSync acceso a tu manifiesto](#transferring-with-manifest-access).
1. Elija **Iniciar** para comenzar la transferencia.
### Usando el AWS CLI
1. Copie el siguiente comando `start-task-execution`:
```
aws datasync start-task-execution \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--manifest-config {
"Source": {
"S3": {
"ManifestObjectPath": "s3-object-key-of-manifest",
"BucketAccessRoleArn": "bucket-iam-role",
"S3BucketArn": "amzn-s3-demo-bucket-arn",
"ManifestObjectVersionId": "manifest-version-to-use"
}
}
}
```
1. Para el parámetro `--task-arn`, especifique el nombre de recurso de Amazon (ARN) de la tarea que está iniciando.
1. Para el parámetro `--manifest-config`, haga lo siguiente:
+ `ManifestObjectPath`: especifique la clave de objeto S3 de su manifiesto.
+ `BucketAccessRoleArn`— Especifique la función de IAM que permite acceder DataSync al manifiesto en su bucket de S3.
Para obtener más información, consulte [Proporcionar DataSync acceso a tu manifiesto](#transferring-with-manifest-access).
+ `S3BucketArn`: especifique el ARN del bucket de S3 que aloja el manifiesto.
+ `ManifestObjectVersionId`— Especifica la versión del manifiesto que quieres DataSync usar.
De forma predeterminada, DataSync utiliza la última versión del objeto.
1. Ejecute el comando `start-task-execution` para iniciar la transferencia.
## Limitaciones
+ No puede usar un manifiesto junto con [filtros](filtering.md).
+ No puede especificar solo un directorio o una carpeta con la intención de transferir todo su contenido. En estas situaciones, considere usar un [filtro de inclusión](filtering.md) en lugar de un manifiesto.
+ No puedes usar la opción de tarea **Conservar los archivos eliminados** (`PreserveDeletedFiles`de la [API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)) para [mantener archivos u objetos en el destino que no estén en el origen](configure-metadata.md). DataSync solo transfiere lo que aparece en tu manifiesto y no borra nada del destino.
## Resolución de problemas
**Errores relacionados con `HeadObject` o `GetObjectTagging`**
Si estás transfiriendo objetos con una versión específica IDs desde un bucket de S3, es posible que veas un error relacionado con `HeadObject` o`GetObjectTagging`. Por ejemplo, aquí hay un error relacionado con `GetObjectTagging`:
```
[WARN] Failed to read metadata for file /picture1.png (versionId: 111111): S3 Get Object Tagging Failed
[ERROR] S3 Exception: op=GetObjectTagging photos/picture1.png, code=403, type=15, exception=AccessDenied,
msg=Access Denied req-hdrs: content-type=application/xml, x-amz-api-version=2006-03-01 rsp-hdrs: content-type=application/xml,
date=Wed, 07 Feb 2024 20:16:14 GMT, server=AmazonS3, transfer-encoding=chunked,
x-amz-id-2=IOWQ4fDEXAMPLEQM+ey7N9WgVhSnQ6JEXAMPLEZb7hSQDASK+Jd1vEXAMPLEa3Km, x-amz-request-id=79104EXAMPLEB723
```
Si ve alguno de estos errores, compruebe que la función de IAM que se DataSync utiliza para acceder a la ubicación de origen de S3 tenga los siguientes permisos:
+ `s3:GetObjectVersion`
+ `s3:GetObjectVersionTagging`
Si necesita actualizar su rol con estos permisos, consulte [Crear un rol de IAM para acceder DataSync a su ubicación de Amazon S3](create-s3-location.md#create-role-manually).
**Error: `ManifestFileDoesNotExist`**
Este error indica que no se encontró en el origen un archivo incluido en el manifiesto. Revise las [directrices](#transferring-with-manifest-guidelines) para la creación de un manifiesto.
## Siguientes pasos
Si aún no lo ha hecho, [inicie la tarea](run-task.md). De lo contrario, [supervise la actividad de la tarea](monitoring-overview.md).
# Transferencia de archivos, objetos y carpetas específicos mediante filtros
AWS DataSync permite aplicar filtros para incluir o excluir datos de la ubicación de origen en una transferencia. Por ejemplo, si no quiere transferir archivos temporales con la extensión `.tmp`, puede crear un filtro de exclusión para impedir que estos archivos se transfieran a la ubicación de destino.
Puede utilizar una combinación de filtros de exclusión e inclusión en la misma tarea de transferencia. Si modifica los filtros de una tarea, esos cambios se aplicarán la próxima vez que ejecute la tarea.
## Definiciones, sintaxis y términos relacionados con los filtros
Familiarícese con los conceptos relacionados con el DataSync filtrado:
**Filtro **
La cadena completa que constituye un filtro determinado (por ejemplo, `*.tmp``|``*.temp` o `/folderA|/folderB`).
Los filtros se componen de patrones que están delimitados por caracteres de barra vertical (\$1). No necesita un delimitador cuando agrega patrones en la DataSync consola porque agrega cada patrón por separado.
Los filtros distinguen entre mayúsculas y minúsculas. Por ejemplo, el filtro `/folderA` no coincide con `/FolderA`.
**Patrón**
Un patrón de un filtro. Por ejemplo, `*.tmp` es un patrón que forma parte del filtro `*.tmp``|``*.temp`. Si el filtro tiene varios patrones, debe delimitar cada patrón mediante una barra vertical (\$1).
**Carpetas**
+ Todos los filtros se expresan con relación a la ruta de la ubicación de origen. Por ejemplo, supongamos que especifica `/my_source/` como la ruta de origen cuando crea su ubicación de origen y tarea y que especifica el filtro de inclusión `/transfer_this/`. En este caso, DataSync transfiere solo el directorio `/my_source/transfer_this/` y su contenido.
+ Para especificar una carpeta situada directamente en la ubicación de origen, incluya una barra inclinada (/) delante de del nombre de la carpeta. En el ejemplo anterior, el patrón utiliza `/transfer_this`, no `transfer_this`.
+ DataSync interpreta los siguientes patrones de la misma manera y hace coincidir tanto la carpeta como su contenido.
`/dir`
`/dir/`
+ Cuando transfiera datos desde o hacia un depósito de Amazon S3, DataSync trata el `/` carácter de la clave del objeto como el equivalente a una carpeta de un sistema de archivos.
**Caracteres especiales**
A continuación, se muestran los caracteres especiales que se utilizan en los filtros.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/filtering.html)
## Ejemplos de filtros
En los siguientes ejemplos se muestran los filtros habituales con los que puede utilizar DataSync.
**nota**
Existen límites en cuanto al número de caracteres que puede utilizar en un filtro. Para obtener más información, consulte [Cuotas de DataSync](datasync-limits.md#task-hard-limits).
**Excluir algunas carpetas de la ubicación de origen**
En algunos casos, es posible que tenga que excluir carpetas de la ubicación de origen para que no se copien en la de destino. Por ejemplo, si tienes work-in-progress carpetas temporales, puedes usar algo como el siguiente filtro:
`*/.temp`
Para excluir carpetas con contenido similar (como `/reports2021` y`/reports2022)`), puede usar un filtro de exclusión como el siguiente:
`/reports*`
Para excluir carpetas de cualquier nivel de la jerarquía de archivos, puede usar un filtro de exclusión similar al siguiente.
`*/folder-to-exclude-1`\$1`*/folder-to-exclude-2`
Para excluir carpetas en el nivel superior de la ubicación de origen, puede usar un filtro de exclusión similar al siguiente.
`/top-level-folder-to-exclude-1`\$1`/top-level-folder-to-exclude-2`
**Inclusión de un subconjunto de las carpetas de la ubicación de origen**
En algunos casos, la ubicación de origen podría ser un recurso compartido de archivos de gran tamaño y podría ser necesario transferir parte de las carpetas situadas bajo la carpeta raíz. Para incluir carpetas específicas, comience una ejecución de tarea con un filtro de inclusión similar al siguiente.
`/folder-to-transfer/*`
**Excluir tipos de archivos específicos**
Para excluir determinados tipos de archivos de la transferencia, puede crear una ejecución de tarea con un filtro de exclusión como por ejemplo `*.temp`.
**Transferencia de determinados archivos que especifique**
Para transferir una lista de archivos individuales, inicie una ejecución de tarea con un filtro de inclusión como el siguiente: “`/folder/subfolder/file1.txt`\$1`/folder/subfolder/file2.txt`\$1`/folder/subfolder/file2.txt`”
## Creación de filtros de inclusión
Los filtros de inclusión definen los archivos, objetos y carpetas que DataSync desea transferir. Puede configurar estos filtros al crear, editar o comenzar una tarea.
DataSync escanea y transfiere solo los archivos y carpetas que coinciden con los filtros de inclusión. Por ejemplo, para incluir un subconjunto de las carpetas de origen, puede especificar `/important_folder_1`\$1`/important_folder_2`.
**nota**
Los filtros de inclusión únicamente admiten el carácter (\$1) como último carácter de un patrón. Por ejemplo, se admite `/documents*`\$1`/code*` pero no `*.txt`.
### 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 de la izquierda, seleccione **Tasks (Tareas)** y, a continuación, seleccione **Create task (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. Para **Contenido a digitalizar**, seleccione **Archivos, objetos y carpetas específicos** y, a continuación, seleccione **Uso de filtros**.
1. En **Incluye**, introduzca su filtro (por ejemplo, `/important_folders` para incluir un directorio importante) y, a continuación, seleccione **Añadir patrón**.
1. Agregue otros filtros de inclusión según sea necesario.
### Usando el AWS CLI
Al usar el AWS CLI, debe usar comillas simples (`'`) alrededor del filtro y un \$1 (barra vertical) como delimitador si tiene más de un filtro.
En el siguiente ejemplo se especifican dos filtros de inclusión, `/important_folder1` y `/important_folder2`, cuándo se ejecuta el comando `create-task`.
```
aws datasync create-task
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--includes FilterType=SIMPLE_PATTERN,Value='/important_folder1|/important_folder2'
```
## Creación de filtros de exclusión
Los filtros de exclusión definen los archivos, objetos y carpetas de la ubicación de origen que no desea DataSync transferir. Puede configurar estos filtros al crear, editar o empezar una tarea.
**Topics**
+ [Datos excluidos de forma predeterminada](#directories-ignored-during-transfers)
### Datos excluidos de forma predeterminada
DataSync excluye automáticamente algunos datos de la transferencia:
+ `.snapshot`— DataSync ignora cualquier ruta que termine en`.snapshot`, lo que normalmente se utiliza para obtener point-in-time instantáneas de los archivos o directorios de un sistema de almacenamiento.
+ `/.aws-datasync`y `/.awssync` — DataSync crea estas carpetas en su ubicación para facilitar la transferencia.
+ `/.zfs`— Es posible que veas esta carpeta en Amazon FSx para ubicaciones de OpenZFS.
### Uso de la consola DataSync
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 de la izquierda, seleccione **Tasks (Tareas)** y, a continuación, seleccione **Create task (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. En **Excluye**, introduzca el filtro (por ejemplo, `*/temp` para excluir las carpetas temporales) y, a continuación, seleccione **Añadir patrón**.
1. Agregue otros filtros de exclusión según sea necesario.
1. Si es necesario, añada [filtros de inclusión](#include-filters).
### Usando el AWS CLI
Al usar el AWS CLI, debe usar comillas simples (`'`) alrededor del filtro y un \$1 (barra vertical) como delimitador si tiene más de un filtro.
En el siguiente ejemplo se especifican dos filtros de exclusión, `*/temp` y `*/tmp`, cuándo se ejecuta el comando `create-task`.
```
aws datasync create-task \
--source-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/location-id' \
--excludes FilterType=SIMPLE_PATTERN,Value='*/temp|*/tmp'
```
# Comprender cómo se DataSync gestionan los metadatos de archivos y objetos
AWS DataSync puede conservar los metadatos del archivo o del objeto durante una transferencia de datos. La forma en que se copian los metadatos depende de las ubicaciones de transferencia y de si esas ubicaciones utilizan tipos de metadatos similares.
## Metadatos a nivel del sistema
En general, DataSync no copia los metadatos a nivel del sistema. Por ejemplo, al transferir desde un servidor de archivos SMB, los permisos que configuró a nivel del sistema de archivos no se copian en el sistema de almacenamiento de destino.
Hay algunas excepciones. Al realizar transferencias entre Amazon S3 y otro almacenamiento de objetos, copia DataSync algunos metadatos de [objetos definidos por el sistema](#metadata-copied-between-object-s3).
## Metadatos copiados en las transferencias de Amazon S3
En las siguientes tablas se describen los metadatos que se DataSync pueden copiar cuando una transferencia implica una ubicación de Amazon S3.
**Topics**
+ [A Amazon S3](#metadata-copied-to-s3)
+ [Entre Amazon S3 y otro almacenamiento de objetos](#metadata-copied-between-object-s3)
+ [Entre Amazon S3 y HDFS](#metadata-copied-between-hdfs-s3)
### A Amazon S3
| Al copiar desde una de estas ubicaciones | A esta ubicación | DataSync puede copiar |
| --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | Lo siguiente como metadatos de usuario de Amazon S3: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) Los metadatos de archivo almacenados en metadatos del usuario de Amazon S3 son interoperables con los recursos compartidos en puertas de enlace de archivos utilizando AWS Storage Gateway. Una puerta de enlace de archivos permite el acceso de baja latencia desde las redes locales a los datos que ha copiado en Amazon S3. DataSync Estos metadatos también son interoperables con FSx Lustre. Al DataSync copiar los objetos que contienen estos metadatos a un servidor NFS, se restauran los metadatos del archivo. La restauración de los metadatos requiere conceder permisos elevados al servidor NFS. Para obtener más información, consulte [Configuración de AWS DataSync transferencias con un servidor de archivos NFS](create-nfs-location.md). |
### Entre Amazon S3 y otro almacenamiento de objetos
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html)
### Entre Amazon S3 y HDFS
| Al copiar entre estas ubicaciones | DataSync puede copiar |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | Lo siguiente como metadatos de usuario de Amazon S3:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html)HDFS utiliza cadenas para almacenar la propiedad de los usuarios y grupos de archivos y carpetas, en lugar de identificadores numéricos, como y. UIDs GIDs |
## Los metadatos se copian en las transferencias NFS
En la siguiente tabla se describe qué metadatos DataSync se pueden copiar entre ubicaciones que utilizan el Sistema de archivos de red (NFS).
| Al copiar entre estas ubicaciones | DataSync puede copiar |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) |
## Metadatos copiados en transferencias SMB
En la siguiente tabla se describe qué metadatos DataSync se pueden copiar entre las ubicaciones que utilizan el bloque de mensajes del servidor (SMB).
| Al copiar entre estas ubicaciones | DataSync puede copiar |
| --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) |
## Metadatos copiados en otros escenarios de transferencia
DataSync gestiona los metadatos de las siguientes maneras al copiarlos entre estos sistemas de almacenamiento (la mayoría de los cuales tienen estructuras de metadatos diferentes).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html)
## Comprenda cuándo y cómo se DataSync aplican los metadatos POSIX predeterminados
DataSync aplica los metadatos POSIX predeterminados en las siguientes situaciones:
+ Cuando las ubicaciones de origen y destino de la transferencia no tienen estructuras de metadatos similares
+ Cuando faltan metadatos en la ubicación de origen
En la siguiente tabla se describe cómo DataSync se aplican los metadatos POSIX predeterminados durante estos tipos de transferencias:
| Origen | Destino | Permisos de archivo | Permiso de carpetas | UID | GID |
| --- | --- | --- | --- | --- | --- |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | 0755 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/metadata-copied.html) | 0644 | 0755 | 65534 | 65534 |
1 En los casos en que los objetos no tengan metadatos que hayan sido aplicados previamente por. DataSync
# Enlaces y directorios copiados por AWS DataSync
AWS DataSync gestiona los enlaces físicos, los enlaces simbólicos y los directorios de forma diferente en función de las ubicaciones de almacenamiento implicadas en la transferencia.
## Enlaces duros
A continuación, te DataSync explicamos cómo gestiona los enlaces físicos en algunos escenarios de transferencia comunes:
+ **Al realizar transferencias entre un servidor de archivos NFS, FSx para Lustre, FSx para OpenZFS, FSx para ONTAP (mediante NFS) y Amazon EFS,** se conservan los enlaces físicos.
+ **Al transferir a Amazon S3**, cada archivo subyacente al que hace referencia un enlace duro se transfiere solo una vez. Durante las transferencias incrementales, se crean objetos separados en el bucket de S3. Si un enlace duro no ha cambiado en Amazon S3, se restaura correctamente cuando se transfiere a un servidor de archivos NFS, FSx para Lustre, para OpenZFS, FSx FSx para ONTAP (mediante NFS) o al sistema de archivos Amazon EFS.
+ **Al transferir a Microsoft Azure Blob Storage**, cada archivo subyacente al que hace referencia un enlace duro se transfiere solo una vez. Durante las transferencias incrementales, se crean objetos independientes en el almacenamiento de blob si hay nuevas referencias en el origen. Al realizar la transferencia desdeAzure Blob Storage, DataSync transfiere los enlaces físicos como si fueran archivos individuales.
+ **Al realizar transferencias entre un servidor de archivos SMB, FSx para Windows File Server y FSx ONTAP (mediante SMB)**, no se admiten los enlaces físicos. Si DataSync encuentra vínculos físicos en estas situaciones, la tarea de transferencia finaliza con un error. Para obtener más información, consulta tus CloudWatch registros.
+ **Al transferir a HDFS**, no se admiten los enlaces físicos. CloudWatch los registros muestran estos enlaces como omitidos.
## Enlaces simbólicos
Así es como DataSync maneja los enlaces simbólicos en algunos escenarios de transferencia comunes:
+ **Al realizar transferencias entre un servidor de archivos NFS, FSx para Lustre, para OpenZFS, FSx FSx para ONTAP (mediante NFS) y Amazon EFS,** se conservan los enlaces simbólicos.
+ **Al transferir datos a Amazon S3**, la ruta de destino del enlace se almacena en el objeto de Amazon S3. El enlace se restaura correctamente cuando se transfiere a un servidor de archivos NFS, FSx para el sistema de archivos Lustre, FSx OpenZFS, FSx ONTAP o Amazon EFS.
+ **Al realizar la transferencia aAzure Blob Storage, no se admiten** enlaces simbólicos. CloudWatch los registros muestran estos enlaces como omitidos.
+ **Al realizar transferencias entre un servidor de archivos SMB, FSx para Windows File Server y FSx ONTAP (mediante SMB)**, no se admiten los enlaces simbólicos. DataSync no transfiere un enlace simbólico en sí mismo, sino un archivo al que hace referencia el enlace simbólico. Para reconocer los archivos duplicados y deduplicarlos con enlaces simbólicos, debe configurar la deduplicación en el sistema de archivos de destino.
+ **Al transferir a HDFS**, no se admiten los enlaces simbólicos. CloudWatch los registros muestran estos enlaces como omitidos.
## Directorios
En general, DataSync conserva los directorios cuando se transfieren entre sistemas de almacenamiento. Este no es el caso en las siguientes situaciones:
+ **Al transferir a Amazon S3**, los directorios se representan como objetos vacíos que tienen prefijos y terminan con una barra inclinada (`/`).
+ **Al transferir en Azure Blob Storage sin un espacio de nombres jerárquico**, los directorios no existen. Lo que parece un directorio es solo una parte del nombre de un objeto.
# Configuración de la forma en que gestionan los archivos, los objetos y los metadatos
Puede configurar la forma en que AWS DataSync gestiona sus archivos, objetos y sus metadatos asociados al transferirlos de una ubicación a otra.
Por ejemplo, en el caso de las transferencias periódicas, es posible que desee sobrescribir los archivos del destino que hayan cambiado en la ubicación de origen a fin de mantener la sincronización entre las ubicaciones. Puede copiar propiedades como los permisos POSIX para archivos y carpetas, las etiquetas asociadas a los objetos y las listas de control de acceso (ACLs).
## Opciones del modo de transferencia
Puede configurar si DataSync transfiere solo los datos (incluidos los metadatos) que se modifican tras una copia inicial o todos los datos cada vez que ejecute la tarea. Si se planifican transferencias recurrentes, es posible que solo se desee transferir lo que haya cambiado desde la ejecución anterior de la tarea.
| Opción en la consola | Opción en la API | Description (Descripción) |
| --- | --- | --- |
| **Transferir solo los datos que han cambiado** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) es `CHANGED`. | Tras la transferencia completa inicial, DataSync copia solo los datos y metadatos que difieran de la ubicación de origen y la de destino. |
| **Transferir todos los datos** | [TransferMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) es `ALL`. | DataSync copia todo el contenido de la fuente al destino sin comparar las diferencias entre las ubicaciones. |
## Opciones de gestión de archivos y objetos
Puede controlar algunos aspectos del DataSync tratamiento de los archivos u objetos en la ubicación de destino. Por ejemplo, DataSync puede eliminar archivos del destino que no estén en el origen.
| Opción en la consola | Opción en la API | Description (Descripción) |
| --- | --- | --- |
| **Conservar archivos eliminados** | [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles) | Especifica si DataSync mantiene los archivos u objetos en la ubicación de destino que no existen en el origen. Si se configura la tarea para eliminar objetos del bucket de Amazon S3, se pueden generar cargos mínimos por duración de almacenamiento para determinadas clases de almacenamiento. Para obtener información detallada, consulta [Consideraciones sobre las clases de almacenamiento con las transferencias de Amazon S3](create-s3-location.md#using-storage-classes). No es posible configurar la tarea para eliminar datos en el destino y también [transferir todos los datos](#task-option-transfer-mode). Al transferir todos los datos, DataSync no escanea la ubicación de destino y no sabe qué eliminar. |
| **Sobrescribir archivos** | [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode) | Especifica si DataSync modifica los datos de la ubicación de destino cuando cambian los datos de origen o los metadatos. Si no se configura la tarea para sobrescribir los datos, los datos del destino no se sobrescriben aunque los datos del origen difieran. Si la tarea sobrescribe objetos, es posible que se apliquen cargos adicionales para determinadas clases de almacenamiento (por ejemplo, por la recuperación o por la eliminación anticipada). Para obtener información detallada, consulta [Consideraciones sobre las clases de almacenamiento con las transferencias de Amazon S3](create-s3-location.md#using-storage-classes). |
## Opciones de gestión de datos
DataSync puede conservar los metadatos de archivos y objetos durante una transferencia. Los metadatos que DataSync se pueden conservar dependen de los sistemas de almacenamiento involucrados y de si esos sistemas utilizan una estructura de metadatos similar.
Antes de configurar la tarea, asegúrese de entender cómo se gestionan [los DataSync metadatos y los](metadata-copied.md) [archivos especiales](special-files-copied.md) cuando se transfieren entre las ubicaciones de origen y destino.
**importante**
DataSync admite las transferencias desde y hacia determinados sistemas de almacenamiento en la nube de terceros, como Google Cloud Storage e IBM Cloud Object Storage, que gestionan los metadatos del sistema de una forma que no es totalmente compatible con S3. Para estas transferencias, DataSync intenta copiar atributos de metadatos como`ContentType`, `ContentEncoding``ContentLanguage`, y haciendo `CacheControl` el mejor esfuerzo posible. Si el sistema de almacenamiento de destino no se aplica estos atributos, se omiten durante la verificación de la tarea.
| Opción en la consola | Opción en la API | Description (Descripción) |
| --- | --- | --- |
| **Propiedad de la copia** | [Gid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Gid) y [Uid](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Uid) | Especifica si DataSync copia la propiedad de los archivos y carpetas POSIX, como el ID de grupo de los propietarios del archivo y el ID de usuario del propietario del archivo. |
| **Copiar permisos** | [PosixPermissions](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PosixPermissions) | Especifica si DataSync copia los permisos POSIX de los archivos y carpetas del origen al destino. |
| Copiar las marcas de tiempo | [Atime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Atime) y [Mtime](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-Mtime) | Especifica si DataSync copia los metadatos de la marca de tiempo del origen al destino. Es obligatorio cuando se necesita ejecutar una tarea más de una vez. |
| Copiar las etiquetas del objeto | [ObjectTags](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-ObjectTags) | Especifica si DataSync conserva las etiquetas asociadas a los objetos al transferirlos entre sistemas de almacenamiento de objetos. |
| Propiedad de la copia DACLs, y SACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) es OWNER\$1DACL\$1SACL. | DataSync copia lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/configure-metadata.html) |
| Copie la propiedad y DACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) es OWNER\$1DACL. | DataSync copia lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/configure-metadata.html) DataSync no se copiará SACLs al seleccionar esta opción. |
| No copies la propiedad o ACLs | [SecurityDescriptorCopyFlags ](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-SecurityDescriptorCopyFlags) es NONE. | DataSync no copia ningún dato de propiedad o permiso. Los objetos que DataSync escriben en la ubicación de destino son propiedad del usuario cuyas credenciales se proporcionan DataSync para acceder al destino. Los permisos de los objetos de destino se determinan en función de los permisos configurados en el servidor de destino. |
## Configuración de las opciones de gestión de archivos, objetos y metadatos
Puede configurar el modo en DataSync que se gestionan los archivos, los objetos y los metadatos al crear, editar o iniciar la tarea de transferencia.
### Uso de la DataSync consola
Las siguientes instrucciones describen cómo configurar las opciones de administración de archivos, objetos y metadatos al crear una tarea.
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. En **Modo transferencia**, elija una de las siguientes opciones:
+ **Transferir solo los datos que han cambiado**
+ **Transferir todos los datos**
Para obtener más información sobre estas opciones, consulte [Opciones del modo de transferencia](#task-option-transfer-mode).
1. Seleccione **Conservar los archivos eliminados** si DataSync desea mantener los archivos u objetos en la ubicación de destino que no existen en la fuente.
Si no selecciona esta opción y la tarea elimina objetos del bucket de Amazon S3, es posible que se apliquen cargos mínimos por la duración de almacenamiento para determinadas clases de almacenamiento. Para obtener información detallada, consulta [Consideraciones sobre las clases de almacenamiento con las transferencias de Amazon S3](create-s3-location.md#using-storage-classes).
**aviso**
No puede desactivar esta opción y activar la opción **Transferir todos los datos**. Al transferir todos los datos, DataSync no escanea la ubicación de destino y no sabe qué eliminar.
1. Seleccione **Sobrescribir archivos** si DataSync desea modificar los datos en la ubicación de destino cuando cambien los datos de origen o los metadatos.
Si la tarea sobrescribe objetos, es posible que se apliquen cargos adicionales para determinadas clases de almacenamiento (por ejemplo, por la recuperación o por la eliminación anticipada). Para obtener información detallada, consulta [Consideraciones sobre las clases de almacenamiento con las transferencias de Amazon S3](create-s3-location.md#using-storage-classes).
Si no elige esta opción, los datos de destino no se sobrescribirán aunque los datos de origen sean diferentes.
1. En **Opciones de transferencia**, selecciona cómo quieres DataSync gestionar los metadatos. Para obtener más información sobre las opciones, consulte [Opciones de gestión de datos](#task-option-metadata-handling).
**importante**
Las opciones que se muestran en la consola dependen de las ubicaciones de origen y destino de la tarea. Es posible que deba ampliar **Ajustes adicionales** para ver algunas de estas opciones.
+ **Propiedad de la copia**
+ **Copiar permisos**
+ **Copiar las marcas de tiempo**
+ **Copiar las etiquetas del objeto**
+ **Propiedad de la copia DACLs, y SACLs**
+ **Propiedad de la copia y DACLs**
+ **No copie la propiedad o ACLs**
### Uso de la DataSync API
Puede configurar las opciones de administración de archivos, objetos y metadatos mediante el uso del parámetro `Options` con cualquiera de las siguientes operaciones:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
# Configurar cómo se AWS DataSync verifica la integridad de los datos
Durante una transferencia, AWS DataSync utiliza la verificación por suma de comprobación para comprobar la integridad de los datos que copias de una ubicación a otra. También puedes configurarlo DataSync para que realice una verificación adicional al final de la transferencia.
## Opciones de verificación de datos
Usa la siguiente información como ayuda para decidir si deseas DataSync realizar estas comprobaciones adicionales y de qué manera.
| Opción de la consola | Opción de la API | Description (Descripción) |
| --- | --- | --- |
| **Verificar solo los datos transferidos** (recomendado) | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode) es `ONLY_FILES_TRANSFERRED`. | DataSync calcula la suma de comprobación de los datos transferidos (incluidos los metadatos) en la ubicación de origen. Al final de la transferencia, DataSync compara esta suma de verificación con la suma de verificación calculada con los mismos datos en el destino. Es conveniente utilizar esta opción cuando la transferencia se realice a S3 Glacier Flexible Retrieval o a las clases de almacenamiento de S3 Glacier Deep Archive. Para obtener más información, consulte [Consideraciones sobre las clases de almacenamiento con las transferencias de Amazon S3](create-s3-location.md#using-storage-classes). |
| **Verificar todos los datos** | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode) es `POINT_IN_TIME_CONSISTENT`. | Al final de la transferencia, DataSync comprueba todo el origen y el destino para comprobar que ambas ubicaciones estén completamente sincronizadas. No es compatible cuando la tarea usa el [modo mejorado](choosing-task-mode.md). Si utilizas un [manifiesto](transferring-with-manifest.md), DataSync solo escanea y verifica lo que aparece en el manifiesto. No puede utilizar esta opción cuando la transferencia se realice a S3 Glacier Flexible Retrieval o a las clases de almacenamiento de S3 Glacier Deep Archive. Para obtener más información, consulte [Consideraciones sobre las clases de almacenamiento con las transferencias de Amazon S3](create-s3-location.md#using-storage-classes). |
| No verificar los datos después de la transferencia | [VerifyMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-VerifyMode) es `NONE`. | DataSync realiza comprobaciones de integridad de los datos solo durante la transferencia. A diferencia de otras opciones, no hay ninguna verificación adicional al final de la transferencia. |
## Configuración de la verificación de datos
Puede configurar las opciones de verificación de datos al crear una tarea, actualizar una tarea o iniciar la ejecución de una tarea.
### Uso de la DataSync consola
Las siguientes instrucciones describen cómo configurar las opciones de verificación de datos al crear una tarea.
**Cómo configurar la verificación de los datos usando la 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. Para **verificar**, elija una de las siguientes opciones:
+ **Verificar solo los datos transferidos** (recomendado)
+ **Verificar todos los datos**
+ **No verificar los datos después de la transferencia**
### Uso de la DataSync API
Puede configurar la forma en DataSync que se verifican los datos mediante el `VerifyMode` parámetro con cualquiera de las siguientes operaciones:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
# Establecer límites de ancho de banda para su tarea AWS DataSync
Puede configurar los límites de ancho de banda de la red para su AWS DataSync tarea y para cada una de sus ejecuciones.
## Limitación del ancho de banda para una tarea
Configure un límite de ancho de banda al crear, editar o iniciar una tarea.
### Uso de la DataSync consola
Las siguientes instrucciones describen cómo configurar un límite de ancho de banda para la tarea en el momento de crearla.
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. En **Límite de ancho de banda**, elija una de las siguientes opciones:
+ Seleccione **Usar disponibles** para usar todo el ancho de banda de la red disponible para cada una de las ejecuciones de la tarea.
+ Seleccione **Establecer límite de ancho de banda (MiB/s)** e introduzca el ancho de banda máximo que desee utilizar DataSync para la ejecución de cada tarea.
### Uso de la API DataSync
Puede configurar el límite del ancho de banda de una tarea mediante el parámetro `BytesPerSecond` con cualquiera de las siguientes operaciones:
+ [CreateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html)
+ [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)
+ [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html)
## Limitación del ancho de banda para la ejecución de una tarea
Puede modificar el límite del ancho de banda para la ejecución de una tarea en estado de ejecución o en cola.
### 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, expanda **Transferencia de datos** y, a continuación, seleccione **Tareas**.
1. Elija la tarea y, a continuación, seleccione **Historial** para ver las ejecuciones de la tarea.
1. Elija la ejecución de la tarea que desee modificar y, a continuación, seleccione **Editar**.
1. En el cuadro de diálogo, elija una de las siguientes acciones:
+ Seleccione **Usar disponibles** para usar todo el ancho de banda de la red disponible para cada una de las ejecuciones de la tarea.
+ Seleccione **Establecer límite de ancho de banda (MiB/s)** e introduzca el ancho de banda máximo que desee utilizar DataSync para la ejecución de la tarea.
1. Seleccione **Save changes (Guardar cambios)**.
El nuevo límite de ancho de banda entrará en vigor en 60 segundos.
### Uso de la API DataSync
Puede modificar el límite de ancho de banda para la ejecución de una tarea en ejecución o en cola utilizando el `BytesPerSecond` parámetro que acompaña a la [UpdateTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTaskExecution.html)operación.
# Programar cuándo se ejecuta la tarea de AWS DataSync
Puede configurar una programación de tarea de AWS DataSync para transferir datos periódicamente entre ubicaciones de almacenamiento.
## Cómo funciona la programación de tareas de DataSync
Una tarea programada de DataSync se ejecuta con la frecuencia que configure con un intervalo mínimo de 1 hora. Puede crear un programación de tareas mediante expresiones Cron o Rate.
**importante**
No puede programar una tarea para que se ejecute en un intervalo superior a 1 hora.
**Uso de expresiones Cron**
Use expresiones Cron para las programaciones de tareas que se ejecuten a una hora y un día específicos. Por ejemplo, aquí le explicamos cómo configurar una programación de tareas en el AWS CLI que se ejecute a las 12:00 UTC cada miércoles y domingo.
```
cron(0 12 ? * SUN,WED *)
```
**Uso de expresiones Rate**
Utilice expresiones Rate para los programas de tareas que se ejecuten a intervalos regulares, por ejemplo cada 12 horas. Por ejemplo, aquí le explicamos cómo configurar una programación de tareas en el AWS CLI que se ejecute cada 12 horas.
```
rate(12 hours)
```
**sugerencia**
Para obtener más información sobre la sintaxis de expresiones Cron y Rate, consulte la [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html).
## Creación de una programación de tareas de DataSync
Puede programar la frecuencia con la que debe ejecutarse la tarea mediante la consola de DataSync, AWS CLI o la API de DataSync.
### Uso de la consola de DataSync
Las siguientes instrucciones describen cómo configurar una programación al crear una tarea. Puede modificar la programación más adelante al editar la tarea.
En la consola, algunas opciones de programación permiten especificar la hora exacta a la que se ejecutará la tarea (por ejemplo, todos los días a las 22:30). Si no incluye una hora en estas opciones, la tarea se ejecutará en el momento en que la cree (o actualice).
1. Abra la consola de AWS DataSync 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. En **Frecuencia** de la programación, elija una de las siguientes opciones:
+ Elija **Not Scheduled (No programada)** si no desea que la tarea se ejecute siguiendo una programación.
+ Elija **Hourly (Cada hora)** y, a continuación, elija el minuto de la hora en que quiere que se ejecute la tarea.
+ Elija **Daily (A diario)** e introduzca la hora UTC a la que desea que se ejecute la tarea.
+ Elija **Weekly (Cada semana)** y el día de la semana e introduzca la hora UTC a la que desea que se ejecute la tarea.
+ Elija **Days of the week (Días de la semana)**, seleccione el día o los días concretos e introduzca la hora UTC a la que debe ejecutarse la tarea, con el formato HH:MM.
+ Elija **Custom (Personalizado)** y, a continuación, seleccione **Expresión Cron** o **expresión Rate**. Introduzca su programa de tareas con un intervalo mínimo de 1 hora.
### Uso de AWS CLI
Puede crear una programación para la tarea de DataSync mediante el parámetro `--schedule` con el comando`create-task`, `update-task` o `start-task-execution`.
Las siguientes instrucciones describen cómo hacer esto con el comando `create-task`.
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 \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)"
}'
```
1. Para el parámetro `--source-location-arn`, especifique el nombre de recurso de Amazon (ARN) de la ubicación desde la que transfiere los datos.
1. Para el parámetro `--destination-location-arn`, especifique el ARN de la ubicación a la que transfiere los datos.
1. Para el parámetro `--schedule`, especifique una expresión Cron o Rate para su programación.
En el ejemplo, la expresión Cron `cron(0 12 ? * SUN,WED *)` establece una programación de la tarea que se ejecuta a las 12:00 UTC cada miércoles y domingo.
1. Ejecute el comando `create-task` para crear la tarea con una programación.
## Poner en pausa una programación de tareas de DataSync
Puede haber situaciones en las que necesite detener temporalmente la programación de tareas de DataSync. Por ejemplo, es posible que tenga que detener temporalmente una transferencia periódica para solucionar un problema con la tarea o realizar tareas de mantenimiento en el sistema de almacenamiento.
Puede que DataSync inhabilite la programación de tareas de forma automática por las razones siguientes:
+ La tarea falla repetidamente con el mismo error.
+ [Deshabilite un Región de AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) que esté utilizando su tarea.
### Uso de la consola de DataSync
1. Abra la consola de AWS DataSync 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** y, a continuación, seleccione **Tareas**.
1. Elija la tarea para la que desee pausar la programación y, a continuación, elija **Editar**.
1. En **Programar**, desactive **Activar programación**. Elija **Save changes (Guardar cambios)**.
### Mediante AWS CLI
1. Copie el siguiente comando `update-task`:
```
aws datasync update-task \
--task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh \
--schedule '{
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED"
}'
```
1. Para el parámetro `--task-arn`, especifique el ARN de la tarea para la que desea pausar la programación.
1. Para el parámetro `--schedule`, haga lo siguiente:
+ Para `ScheduleExpression`, especifique una expresión Cron o Rate para su programación.
En el ejemplo, la expresión `cron(0 12 ? * SUN,WED *)` establece una programación de la tarea que se ejecuta a las 12:00 UTC cada miércoles y domingo.
+ Para `Status`, especifique `DISABLED` para pausar la programación de la tarea.
1. Ejecute el comando `update-task`.
1. Para reanudar la programación, ejecute el mismo comando `update-task` con el valor `Status` establecido en `ENABLED`.
## Comprobar el estado de una programación de tareas de DataSync
Puede comprobar si la programación de tareas de DataSync está habilitada.
### Uso de la consola de DataSync
1. Abra la consola de AWS DataSync 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** y, a continuación, seleccione **Tareas**.
1. En la columna **Programación**, compruebe si la programación de la tarea está habilitada o deshabilitada.
### Uso de AWS CLI
1. Copie el siguiente comando `describe-task`:
```
aws datasync describe-task \
--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 sobre la que desea obtener información.
1. Ejecute el comando `describe-task`.
Recibirá una respuesta que proporciona detalles sobre su tarea, incluida su programación. (El siguiente ejemplo se centra principalmente en la configuración de la programación de la tarea y no muestra una respuesta de `describe-task` completa).
El ejemplo muestra que la programación de la tarea se ha deshabilitado manualmente. Si la programación ha sido inhabilitada por el `SERVICE` de DataSync, verá un mensaje de error para `DisabledReason` que lo ayudará a entender por qué la tarea sigue fallando. Para obtener más información, consulte [Solución de AWS DataSync problemas](troubleshooting-datasync.md).
```
{
"TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh",
"Status": "AVAILABLE",
"Schedule": {
"ScheduleExpression": "cron(0 12 ? * SUN,WED *)",
"Status": "DISABLED",
"StatusUpdateTime": 1697736000,
"DisabledBy": "USER",
"DisabledReason": "Manually disabled by user."
},
...
}
```
# Etiquetar tus tareas AWS DataSync
Las *etiquetas* son pares clave-valor que te ayudan a administrar, filtrar y buscar tus AWS DataSync recursos. Puedes añadir hasta 50 etiquetas a cada DataSync tarea y ejecución de tareas.
Por ejemplo, puede crear una tarea para realizar una migración de datos de gran tamaño y etiquetarla con la clave **Project** y el valor **Large Migration**. Para una mejor organización de la migración, puede etiquetar una ejecución de la tarea con la clave **Transfer Date** y el valor **May 2021** (es posible que se etiqueten las siguientes ejecuciones de las tareas **June 2021**, **July 2021**, etc.).
## Etiquetar tu tarea DataSync
Solo puede etiquetar la DataSync tarea al crearla.
### 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. En la página **Configurar ajustes**, seleccione **Añadir etiqueta nueva** para etiquetar la tarea.
### Usando el AWS CLI
1. Copie el siguiente comando `create-task`:
```
aws datasync create-task \
--source-location-arn 'arn:aws:datasync:region:account-id:location/source-location-id' \
--destination-location-arn 'arn:aws:datasync:region:account-id:location/destination-location-id' \
--tags Key=tag-key,Value=tag-value
```
1. Especifique los siguientes parámetros en el comando:
+ `--source-location-arn`: especifique el nombre de recurso de Amazon (ARN) de la ubicación de origen en la transferencia.
+ `--destination-location-arn`: especifique el ARN de la ubicación de destino en la transferencia.
+ `--tags`: especifique las etiquetas que desea aplicar a la tarea.
Si hay más de una etiqueta, separe cada par clave-valor con un espacio.
1. (Opcional) Especifique otros parámetros que tengan sentido para su escenario de transferencia.
Para obtener una lista de `--options`, consulte el comando [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html).
1. Ejecute el comando `create-task`.
Recibirá una respuesta que le mostrará la tarea que acaba de crear.
```
{
"TaskArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
}
```
Para ver las etiquetas que ha añadido a esta tarea, puede utilizar el [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.
## Etiquetar la ejecución de la DataSync tarea
Puede etiquetar cada ejecución de la DataSync tarea.
Si la tarea ya tiene etiquetas, recuerde lo siguiente sobre el uso de etiquetas en la ejecución de tareas:
+ Si inicia la tarea con la consola, las etiquetas creadas por el usuario se aplicarán de forma automática a la ejecución de la tarea. Sin embargo, no se aplicarán las etiquetas creadas por el sistema que comiencen por `aws:`.
+ Si empiezas la tarea con la DataSync API o AWS CLI, sus etiquetas no se aplican automáticamente a la ejecución de la tarea.
### Uso de la DataSync consola
Para añadir, editar o eliminar etiquetas de la ejecución de una tarea, debe iniciar la tarea con las opciones de anulación.
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** y, a continuación, seleccione **Tareas**.
1. Elija la tarea.
1. Seleccione **Iniciar** y, a continuación, elija una de las siguientes opciones:
+ **Iniciar con los valores predeterminados**: aplica cualquier etiqueta asociada a la tarea.
+ **Comenzar con las opciones principales**: permite añadir, editar o eliminar etiquetas para la ejecución de esta tarea en particular.
### Usando el AWS CLI
1. Copie el siguiente comando `start-task-execution`:
```
aws datasync start-task-execution \
--task-arn 'arn:aws:datasync:region:account-id:task/task-id' \
--tags Key=tag-key,Value=tag-value
```
1. Especifique los siguientes parámetros en el comando:
+ `--task-arn`: especifique el ARN de la tarea que desea iniciar.
+ `--tags`: especifique las etiquetas que desea aplicar a esta ejecución específica de la tarea.
Si hay más de una etiqueta, separe cada par clave-valor con un espacio.
1. (Opcional) Especifique otros parámetros que tengan sentido para su situación.
Para obtener más información, consulte el comando [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html).
1. Ejecute el comando `start-task-execution`.
Recibirá una respuesta que muestra la ejecución de la tarea que usted acaba de iniciar.
```
{
"TaskExecutionArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
}
```
Para ver las etiquetas que ha añadido a esta tarea, puede utilizar el [list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)comando.