# Importar archivos desde Amazon S3 Robot: `/s3/import` 🤖/s3/import importa directorios completos de archivos desde tu bucket de S3. Si es la primera vez que usas Amazon S3, consulta nuestro tutorial sobre [cómo usar tu propio bucket de S3](/es/docs/faq/how-to-set-up-an-amazon-s3-bucket.md). La URL del archivo resultante en tu bucket de S3 se devolverá en el Assembly Status JSON. > [!Warning] > **Usa nombres de bucket compatibles con DNS**. El nombre de tu bucket [debe ser compatible con DNS](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html) y no debe contener letras mayúsculas. Los caracteres no alfanuméricos de los nombres de archivo se reemplazarán por un guion bajo y los espacios se reemplazarán por guiones. Si tu bucket de S3 existente contiene letras mayúsculas o no es compatible con DNS por algún otro motivo, reescribe las URL de los resultados mediante el parámetro `url_prefix` del Robot. ## Limitar el acceso También tendrás que agregar permisos a tu bucket para que Transloadit pueda acceder a él correctamente. A continuación, se muestra un ejemplo de una política de IAM que puedes usar. De acuerdo con el [principio de privilegio mínimo](https://en.wikipedia.org/wiki/Principle_of_least_privilege), contiene los **permisos mínimos necesarios** para importar un archivo desde tu bucket de S3 mediante Transloadit. Es posible que necesites más permisos (especialmente permisos de visualización), según tu aplicación. Cambia `{BUCKET_NAME}` según corresponda en los valores de `Sid` y `Resource`. Además, esta política concederá los permisos mínimos requeridos a todos tus usuarios. Te recomendamos crear un usuario de Amazon IAM independiente y usar su ARN de usuario, que puedes encontrar en la pestaña «Resumen» de un usuario [aquí](https://console.aws.amazon.com/iam/home#users), como valor de `Principal`. Puedes encontrar más información al respecto [aquí](https://docs.aws.amazon.com/AmazonS3/latest/dev/AccessPolicyLanguage_UseCases_s3_a.html). ```json { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowTransloaditToImportFilesIn{BUCKET_NAME}Bucket", "Effect": "Allow", "Action": ["s3:GetBucketLocation", "s3:ListBucket"], "Resource": ["arn:aws:s3:::{BUCKET_NAME}", "arn:aws:s3:::{BUCKET_NAME}/*"] } ] } ``` El valor `Sid` es simplemente un identificador que te permite reconocer la regla más adelante. Puedes asignarle el nombre que prefieras. La política debe dividirse en dos partes porque la acción `ListBucket` requiere permisos sobre el bucket, mientras que las demás acciones requieren permisos sobre los objetos del bucket. Cuando se especifican los objetos, el parámetro `Resource` incluye una barra diagonal y un asterisco al final; cuando la política especifica el bucket, se omiten la barra diagonal y el asterisco. Para crear URL de resultados correctas, necesitamos saber en qué región se encuentra tu bucket de S3. Para ello, necesitamos el permiso `GetBucketLocation`. Determinar de esta manera la región de tu bucket también ralentizará tus Assemblies. Para acelerar considerablemente el proceso y evitar que sea necesario el permiso `GetBucketLocation`, agregamos el parámetro `bucket_region` a los Robots /s3/store y /s3/import. Recomendamos usarlo siempre. Ten en cuenta que, si usas cifrado de bucket, es posible que también debas agregar `"sts:*"` y `"kms:*"` a la política del bucket. Si tienes problemas con nuestra política de bucket de ejemplo, consulta la información disponible [aquí](https://docs.aws.amazon.com/kms/latest/developerguide/kms-api-permissions-reference.html) y [aquí](https://aws.amazon.com/blogs/security/how-to-restrict-amazon-s3-bucket-access-to-a-specific-iam-role/). Etapa: ga ## Ejemplo de uso Importa archivos desde el directorio \`path/to/files\` y sus subdirectorios: ```json { "steps": { "imported": { "robot": "/s3/import", "credentials": "YOUR_AWS_CREDENTIALS", "path": "path/to/files/", "recursive": true } } } ``` ## Parámetros * `interpolate`: Controla si las Assembly Variables se interpolan en campos de instrucciones individuales. De forma predeterminada, la mayoría de los campos de instrucciones de los Robots interpolan Assembly Variables. Establece esta opción en `false` para tratar todos los campos de instrucciones como texto literal, o establece la ruta de un campo individual en `false` para tratar únicamente ese campo como texto literal. En el caso de los campos específicos de un Robot que son literales de forma predeterminada, establece esta opción en `true` o la ruta de ese campo en `true` para volver a habilitar la interpolación. Usa nombres de campos como `path` o rutas con puntos como `ffmpeg.vf` para los objetos anidados. * `output_meta`: Te permite especificar un conjunto de metadatos cuyo cálculo requiere más recursos de CPU y que, por lo tanto, está desactivado de forma predeterminada para que tus Assemblies se procesen rápidamente. Para imágenes, puedes añadir `"has_transparency": true` a este objeto para determinar si la imagen contiene partes transparentes y `"dominant_colors": true` para extraer un array de códigos de color hexadecimales de la imagen. Para imágenes, también puedes añadir `"blurhash": true` para extraer una cadena [BlurHash](https://blurha.sh), una representación compacta de un marcador de posición para la imagen que resulta útil para mostrar una vista previa desenfocada mientras se carga la imagen completa. Para videos, puedes añadir el parámetro `"colorspace": true` para extraer el espacio de color del video de salida. Para videos, también puedes añadir `"interlaced": true` para detectar si el video está entrelazado. Esto combina el indicador `field_order` de ffprobe, cuyo costo en recursos de procesamiento es bajo, con una pasada de muestreo limitada mediante `idet` sobre los primeros fotogramas de la fuente, y expone `interlaced`, `field_order` y un objeto de diagnóstico `interlace_detection` en `file.meta`. Esto requiere muchos recursos computacionales y se factura en consecuencia. Para audio, puedes añadir `"mean_volume": true` para obtener un único valor que represente el volumen promedio del archivo de audio. También puedes establecerlo en `false` para omitir la extracción de metadatos y acelerar la transcodificación. * `user_meta`: Añade metadatos personalizados a cada archivo emitido por este Robot sin modificar el contenido del archivo. Los valores se combinan con los `user_meta` existentes en el archivo de entrada. Si ambos objetos contienen la misma clave, el valor de este Robot tiene prioridad. Se admiten Assembly Variables, por ejemplo `{ "internal_file_id": "${file.id}" }`. * `result`: Indica si los resultados de este Step deben aparecer en el Assembly Status JSON * `queue`: Establecer la cola en «batch» reduce manualmente la prioridad de los Jobs de este Step para evitar consumir cupos prioritarios con Jobs que no necesitan un tiempo de espera cero en la cola * `force_accept`: Forzar a un Robot a aceptar un tipo de archivo que habría ignorado. De forma predeterminada, los Robots ignoran los archivos que no reconocen. [🤖/video/encode](/es/docs/robots/video-encode.md), por ejemplo, ignorará sin problemas las imágenes de entrada. Si configuras el parámetro `force_accept` como `true`, puedes forzar a los Robots a aceptar todos los archivos que reciban. Esto normalmente provocará errores y solo debe usarse para depuración o para abordar casos extremos. * `ignore_errors`: Ignorar errores durante fases específicas del procesamiento. Establecer este parámetro en `["meta"]` hará que el Robot ignore los errores durante la extracción de metadatos. Establecer este parámetro en `["execute"]` hará que el Robot ignore los errores durante la fase principal de ejecución. Establecer este parámetro en `["import"]` hará que el Robot ignore los errores al importar el archivo de origen. La fase `"import"` solo está disponible para los Robots de importación. Establecer este parámetro en `true` equivale a `["meta", "import", "execute"]` y hará que se ignoren los errores en las tres fases. * `force_name`: Nombre personalizado para el archivo o los archivos importados. De forma predeterminada, los nombres de archivo se derivan de la fuente. * `import_on_errors`: Si estableces este parámetro en `["meta"]`, el archivo se importará incluso si se producen errores al extraer los metadatos. `ignore_errors` funciona de forma similar: también ignora el error y evita que el Robot se detenga, pero no importa el archivo. * `credentials`: Crea las credenciales de Template asociadas en tu cuenta de Transloadit y usa el nombre de esas credenciales de Template como valor de este parámetro. Contendrán los valores de `bucket`, `key`, `secret` y `bucket_region` para S3. Aunque recomendamos usar siempre credenciales de Template, algunos casos de uso requieren credenciales dinámicas para las que resulta demasiado engorroso usar credenciales de Template debido a su naturaleza estática. Si tienes este requisito, puedes usar en su lugar los siguientes parámetros: `"bucket"`, `"bucket_region"` (por ejemplo: `"us-east-1"` o `"eu-west-2"`), `"key"`, `"secret"`. * `bucket` * `bucket_region` * `key` * `secret` * `path`: La ruta de tu bucket al archivo o directorio específico. Si la ruta apunta a un archivo, solo se importará ese archivo. Por ejemplo: `images/avatar.jpg`. Si apunta a un directorio, indicado mediante una barra diagonal al final (`/`), se importarán todos los archivos que sean descendientes directos de ese directorio. Por ejemplo: `images/`. Los directorios **no** se importan de forma recursiva. Si quieres importar archivos de subdirectorios y de subdirectorios anidados, habilita el parámetro `recursive`. Si quieres importar todos los archivos del directorio raíz, usa `/` como valor. En este caso, asegúrate de que todos tus objetos pertenezcan a una ruta. Si tienes objetos en la raíz de tu bucket que no llevan el prefijo `/`, recibirás este error: `A client error (NoSuchKey) occurred when calling the GetObject operation: The specified key does not exist.` También puedes usar aquí un array de cadenas de rutas para importar varias rutas en el mismo Robot, dentro de su Step. * `recursive`: Si estableces este parámetro en `true`, se habilitará la importación de archivos desde los subdirectorios y subdirectorios anidados (etc.) de la ruta indicada. Usa con prudencia los parámetros de paginación `page_number` y `files_per_page`. * `page_number`: El número de página de la paginación. Por ahora, para no afectar la compatibilidad con versiones anteriores en las importaciones no recursivas, esto solo funciona cuando recursive está establecido en `true`. Cuando realices importaciones grandes, asegúrate de que otros scripts no agreguen ni eliminen archivos dentro de tu ruta; de lo contrario, podrías obtener resultados inesperados en la paginación. * `files_per_page`: El tamaño de página de la paginación. Por ahora, esto solo funciona cuando recursive es `true`, para no afectar la compatibilidad con versiones anteriores en las importaciones no recursivas. * `return_file_stubs`: Si estableces este parámetro en `true`, el Robot aún no importará los archivos reales, sino que devolverá un stub de archivo vacío que incluye una URL desde la cual los Robots posteriores podrán importar el archivo. Esto resulta útil cuando los Steps posteriores necesitan mayor control sobre el proceso de importación, como ocurre con 🤖/video/ondemand. Este parámetro solo debe establecerse si todos los Steps posteriores usan Robots compatibles con stubs de archivo. * `range`: Te permite especificar uno o más rangos de bytes para importar desde el archivo. Para que esto funcione, S3 debe admitir solicitudes de rango. **Rango único**: Usa una cadena como `"0-99"` para importar los bytes 0-99 (los primeros 100 bytes). **Varios rangos**: Usa un array como `["0-99", "200-299"]` para importar varios rangos independientes. El archivo resultante contendrá todos los rangos solicitados concatenados, y los espacios entre rangos no contiguos se rellenarán con bytes cero (\0). **Formatos de rango**: * `"0-99"`: Bytes desde 0 hasta 99 (inclusive) * `"100-199"`: Bytes desde 100 hasta 199 (inclusive) * `"-100"`: Los últimos 100 bytes del archivo **Notas importantes**: * S3 admite solicitudes de rango de forma predeterminada * Se permiten rangos superpuestos y se incluirán según lo solicitado * El tamaño del archivo resultante corresponderá a la posición de byte más alta solicitada, y los espacios se rellenarán con bytes cero * Cada rango se obtiene mediante una solicitud independiente para garantizar la compatibilidad con S3