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