

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.

# Elegir qué AWS DataSync se transfiere
<a name="task-options"></a>

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
<a name="transferring-with-manifest"></a>

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
<a name="transferring-with-manifest-create"></a>

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
<a name="transferring-with-manifest-guidelines"></a>

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
<a name="manifest-examples"></a>

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
<a name="transferring-with-manifest-access"></a>

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
<a name="creating-manfiest-role-automatically"></a>

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)
<a name="creating-manfiest-role-automatically-same-account"></a>

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)
<a name="creating-manfiest-role-automatically-different-account"></a>

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
<a name="creating-manfiest-role-automatically-different-account-1"></a>

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
<a name="creating-manfiest-role-automatically-different-account-2"></a>

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
<a name="manifest-creating-task"></a>

Puedes especificar el manifiesto que quieres usar DataSync al crear una tarea.

### Uso de la DataSync consola
<a name="manifest-creating-task-console"></a>

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
<a name="manifest-creating-task-cli"></a>

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
<a name="manifest-starting-task"></a>

Puede especificar el manifiesto que desea usar DataSync al ejecutar una tarea.

### Uso de la DataSync consola
<a name="manifest-starting-task-console"></a>

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
<a name="manifest-starting-task-cli"></a>

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
<a name="transferring-with-manifest-limitations"></a>
+ 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
<a name="manifests-troubleshooting"></a>

**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
<a name="manifests-next-steps"></a>

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
<a name="filtering"></a>

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
<a name="filter-overview"></a>

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
<a name="sample-filters"></a>

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
<a name="include-filters"></a>

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
<a name="include-filters-console"></a>

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
<a name="include-filters-cli"></a>

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
<a name="exclude-filters"></a>

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
<a name="directories-ignored-during-transfers"></a>

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
<a name="adding-exclude-filters"></a>

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
<a name="adding-exclude-filters-cli"></a>

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
<a name="metadata-copied"></a>

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
<a name="metadata-copied-system-level"></a>

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
<a name="metadata-copied-amazon-s3"></a>

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
<a name="metadata-copied-to-s3"></a>


| 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
<a name="metadata-copied-between-object-s3"></a>

[\[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
<a name="metadata-copied-between-hdfs-s3"></a>


| 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
<a name="metadata-copied-nfs"></a>

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
<a name="metadata-copied-smb"></a>

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
<a name="metadata-copied-different"></a>

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
<a name="POSIX-metadata"></a>

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
<a name="special-files-copied"></a>

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 name="special-files-copied-hard-links"></a>

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
<a name="special-files-copied-symbolic-links"></a>

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
<a name="special-files-copied-directories"></a>

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
<a name="configure-metadata"></a>

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
<a name="task-option-transfer-mode"></a>

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
<a name="task-option-file-object-handling"></a>

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
<a name="task-option-metadata-handling"></a>

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
<a name="configure-file-metadata-options"></a>

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
<a name="configure-metadata-console"></a>

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
<a name="configure-file-metadata-options-api"></a>

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)