INTEGRACIÓN S3 n8n: AUTOMATIZAR S3 CON N8N

Esta acción recupera una lista de carpetas (prefijos) dentro de un bucket S3 específico. Es particularmente útil cuando necesitas explorar la estructura de directorios de tu almacenamiento S3 para identificar carpetas que contienen archivos específicos, listar subcarpetas para procesamiento posterior, o generar un inventario automatizado de la organización de tu bucket.

Parámetros clave: Bucket Name (requerido, campo de texto donde especificas el nombre exacto del bucket S3 que contiene las carpetas a listar), Return All (opcional, interruptor on/off que cuando está activado recupera todas las carpetas disponibles sin límite), Limit (opcional, campo numérico que define el número máximo de carpetas a devolver, por defecto 100), y Options (opcional, sección que permite añadir propiedades adicionales para filtrar o personalizar la búsqueda de carpetas).

Casos de uso: Listar automáticamente todas las carpetas de un bucket para generar un reporte de estructura de almacenamiento, identificar carpetas que contienen archivos de un mes específico para procesamiento posterior, explorar subcarpetas de un bucket antes de ejecutar operaciones de copia o eliminación masiva, o construir dinámicamente un menú de selección de carpetas basado en el contenido real de tu bucket S3.

Cuándo usarlo: Utiliza esta acción cuando necesites conocer la estructura de directorios de tu bucket S3 antes de ejecutar otras operaciones. Es especialmente útil en workflows que requieren navegar por jerarquías de carpetas, procesar contenido organizado por fechas o categorías, o construir lógica condicional basada en la presencia o ausencia de carpetas específicas.

Esta acción elimina una carpeta (prefijo) completa de un bucket S3, incluyendo potencialmente todos los archivos que contiene. Es fundamental para automatizar la limpieza de almacenamiento, eliminar carpetas temporales una vez completado un proceso, o reorganizar la estructura de directorios de tu bucket de forma programática.

Parámetros clave: Bucket Name (requerido, campo de texto donde introduces el nombre del bucket S3 que contiene la carpeta a eliminar) y Folder Key (requerido, campo de texto donde especificas la ruta completa o clave de la carpeta que deseas eliminar dentro del bucket, por ejemplo "archivos-temporales/2024-01/" o "respaldos/antiguos/").

Casos de uso: Eliminar automáticamente carpetas de archivos temporales después de completar un proceso de conversión o procesamiento, limpiar carpetas de respaldo antiguas según una política de retención definida (por ejemplo, eliminar carpetas de más de 90 días), borrar carpetas de staging después de mover su contenido a producción, o reorganizar la estructura de almacenamiento eliminando categorías obsoletas.

Cuándo usarlo: Emplea esta acción cuando necesites automatizar la limpieza de tu almacenamiento S3. Es especialmente valiosa para implementar políticas de retención de datos, liberar espacio eliminando contenido temporal una vez procesado, o mantener tu estructura de carpetas organizada eliminando directorios que ya no se utilizan. Ten mucho cuidado con esta acción: la eliminación es definitiva y puede borrar todo el contenido de la carpeta.

Esta acción crea una nueva carpeta (prefijo) dentro de un bucket S3 existente. Aunque técnicamente S3 no tiene "carpetas" tradicionales sino prefijos de objetos, esta acción te permite estructurar tu almacenamiento de forma lógica y organizada, facilitando la gestión posterior de archivos.

Parámetros clave: Bucket Name (requerido, campo de texto donde especificas el nombre del bucket S3 donde se creará la carpeta), Folder Name (requerido, campo de texto donde defines el nombre completo de la carpeta a crear, incluyendo su ruta completa, por ejemplo "documentos/2024/enero/" o "respaldos/diarios/"), y Additional Fields (opcional, sección que permite añadir propiedades avanzadas para personalizar la creación de la carpeta).

Casos de uso: Crear automáticamente una nueva carpeta cada mes para organizar archivos cronológicamente (por ejemplo, "facturas/2024/marzo/"), generar dinámicamente carpetas por cliente cuando se registra un nuevo usuario en tu aplicación, establecer una estructura de directorios organizada antes de iniciar procesos de carga masiva de archivos, o crear carpetas temporales para procesos de staging antes de mover archivos a su ubicación definitiva.

Cuándo usarlo: Utiliza esta acción cuando necesites automatizar la organización de tu almacenamiento S3. Es particularmente útil al inicio de workflows que suben archivos, para garantizar que existe la estructura de carpetas necesaria antes de proceder con operaciones de carga. Combínala con expresiones n8n para generar nombres de carpetas dinámicos basados en fechas, IDs de usuarios, o cualquier otro dato de tu workflow.

Esta acción sube un archivo a un bucket S3 desde datos binarios disponibles en tu workflow n8n. Es la operación fundamental para transferir documentos, imágenes, PDFs, o cualquier tipo de archivo desde otras aplicaciones hacia tu almacenamiento S3.

Parámetros clave: Bucket Name (requerido, campo de texto donde especificas el bucket S3 de destino para el archivo), File Name (requerido, campo de texto donde defines la ruta completa y el nombre del archivo una vez subido a S3), Binary File (opcional, interruptor on/off que cuando está activado indica que el archivo a subir proviene de datos binarios de un nodo anterior), Input Binary Field (requerido cuando Binary File está activo, campo de texto que especifica el nombre del campo binario de entrada, valor por defecto "data"), Additional Fields (opcional, permite añadir propiedades adicionales como ACLs, metadatos personalizados, o configuraciones de almacenamiento), y Tags (opcional, permite asociar etiquetas clave-valor al objeto S3).

Casos de uso: Subir automáticamente archivos adjuntos de formularios TypeForm o Google Forms directamente a S3, transferir documentos procesados por herramientas de conversión (PDF a imagen, por ejemplo) hacia almacenamiento permanente, respaldar archivos generados dinámicamente (reportes CSV, exportaciones JSON) a S3 cada noche, o subir imágenes redimensionadas o optimizadas a S3 después de procesarlas con servicios de imagen.

Cuándo usarlo: Esta acción es esencial en cualquier workflow que necesite almacenar archivos permanentemente en S3. Úsala después de nodos que descargan, generan, o transforman archivos para garantizar que el resultado se conserva de forma segura. Combínala con la acción "Create Folder" para organizar automáticamente los archivos en la estructura de directorios correcta.

Esta acción recupera una lista de archivos de un bucket S3 específico. A diferencia de descargar el contenido, esta operación te proporciona metadatos sobre los archivos (nombres, tamaños, fechas de modificación) sin consumir ancho de banda para transferir su contenido. Es perfecta para inventariar archivos, buscar elementos específicos, o construir lógica condicional basada en la presencia de archivos.

Parámetros clave: Bucket Name (requerido, campo de texto donde especificas el bucket S3 que contiene los archivos a listar), Return All (opcional, interruptor on/off que cuando está activado recupera todos los archivos disponibles sin límite), Limit (opcional, campo numérico que define el máximo de archivos a devolver, por defecto 100), y Options (opcional, sección que permite añadir propiedades adicionales, como especificar un prefijo para filtrar archivos dentro de una carpeta específica).

Casos de uso: Listar todos los archivos de un bucket para generar un inventario automatizado o reporte de almacenamiento, buscar archivos que cumplen ciertos criterios de nombre (por ejemplo, todos los PDFs subidos en enero) para procesarlos posteriormente, verificar la presencia de archivos específicos antes de ejecutar operaciones de descarga o copia, o construir un catálogo dinámico de recursos disponibles en S3 para mostrar en una aplicación web.

Cuándo usarlo: Utiliza esta acción cuando necesites conocer qué archivos existen en un bucket sin descargar su contenido. Es especialmente útil al inicio de workflows que procesan archivos por lotes, para construir lógica condicional basada en nombres de archivo, o para generar reportes de contenido almacenado. Combínala con filtros en n8n para seleccionar únicamente los archivos que cumplen criterios específicos y procesarlos después.

Esta acción descarga el contenido completo de un archivo desde un bucket S3 y lo coloca en un campo binario de tu workflow n8n. Una vez descargado, puedes procesar el archivo con otras herramientas de n8n (conversión, análisis, envío por email, etc.).

Parámetros clave: Bucket Name (requerido, campo de texto donde especificas el bucket S3 que contiene el archivo a descargar), File Key (requerido, campo de texto donde proporcionas la ruta completa y el nombre del archivo específico dentro del bucket), y Put Output File in Field (opcional, campo de texto que define el nombre de la propiedad binaria en la salida del nodo donde se colocará el contenido del archivo descargado, por defecto "data").

Casos de uso: Descargar un archivo específico desde S3 para procesarlo con herramientas de conversión (PDF a texto, imagen a miniatura), recuperar documentos almacenados en S3 para adjuntarlos automáticamente a emails enviados vía Gmail o SendGrid, descargar archivos de datos (CSV, JSON) desde S3 para importarlos a bases de datos o aplicaciones, u obtener imágenes desde S3 para analizarlas con servicios de IA de reconocimiento visual.

Cuándo usarlo: Emplea esta acción cuando necesites acceder al contenido real de un archivo almacenado en S3, no solo a sus metadatos. Es fundamental en workflows que procesan, transforman, o redistribuyen archivos almacenados previamente. Asegúrate de conocer la ruta exacta del archivo (obtenida quizás con la acción "Get Many") antes de ejecutar la descarga.

Esta acción elimina definitivamente un archivo específico de un bucket S3. Es útil para automatizar la limpieza de archivos temporales, implementar políticas de retención de datos, o reorganizar tu almacenamiento eliminando contenido obsoleto.

Parámetros clave: Bucket Name (requerido, campo de texto donde especificas el bucket S3 que contiene el archivo a eliminar), File Key (requerido, campo de texto donde proporcionas la ruta completa y el nombre del archivo que deseas eliminar dentro del bucket), y Options (opcional, sección que permite añadir propiedades avanzadas para la operación de eliminación).

Casos de uso: Eliminar automáticamente archivos temporales una vez completado un proceso de conversión o análisis, implementar políticas de retención eliminando archivos de más de X días desde su creación, borrar archivos de staging después de moverlos exitosamente a producción, o limpiar archivos duplicados o versiones antiguas detectadas automáticamente.

Cuándo usarlo: Utiliza esta acción con precaución: la eliminación es definitiva e irreversible. Es especialmente útil al final de workflows de procesamiento para liberar espacio, o en workflows programados que ejecutan limpieza periódica según reglas de retención. Combínala con la acción "Get Many" para listar archivos primero y aplicar filtros antes de eliminar, garantizando que solo se borran los archivos correctos.

Esta acción copia un archivo de una ubicación S3 a otra dentro del mismo servicio. Puedes copiar archivos entre diferentes buckets o dentro del mismo bucket con un nombre diferente. Es fundamental para duplicar contenido, crear respaldos, o reorganizar la estructura de almacenamiento sin necesidad de descargar y volver a subir archivos.

Parámetros clave: Source Path (requerido, campo de texto donde especificas la ruta completa del archivo origen, incluyendo el nombre del bucket, formato "/bucket-origen/ruta/archivo.ext"), Destination Path (requerido, campo de texto donde defines la ruta completa de destino, incluyendo el bucket y el nuevo nombre del archivo), y Additional Fields (opcional, sección que permite añadir propiedades avanzadas como ACLs para el archivo copiado, metadatos personalizados, o configuraciones de almacenamiento).

Casos de uso: Copiar automáticamente archivos procesados desde un bucket de staging a un bucket de producción, duplicar archivos críticos hacia un bucket de respaldo en cuanto se suben al bucket principal, reorganizar la estructura de almacenamiento copiando archivos a nuevas ubicaciones con nombres estandarizados, o crear múltiples copias de un archivo con diferentes ACLs para controlar permisos de acceso.

Cuándo usarlo: Emplea esta acción cuando necesites duplicar o mover archivos dentro de tu infraestructura S3 de forma eficiente. Es mucho más rápida que descargar y volver a subir, ya que la copia se ejecuta directamente en el servidor. Es ideal para implementar estrategias de respaldo, gestionar flujos de trabajo con múltiples entornos (desarrollo, staging, producción), o reorganizar archivos según nuevas convenciones de nomenclatura.

Esta acción busca contenido dentro de un bucket S3 según criterios específicos. Permite filtrar archivos por prefijo, tamaño, fecha, o cualquier otro atributo disponible, devolviéndote una lista de resultados que cumplen tus condiciones de búsqueda.

Parámetros clave: Bucket Name (requerido, campo de texto donde especificas el bucket S3 en el cual ejecutar la búsqueda), Return All (opcional, interruptor on/off que cuando está activado devuelve todos los resultados encontrados sin límite), Limit (opcional, campo numérico que define el máximo de resultados a devolver, por defecto 100), y Additional Fields (opcional, sección fundamental que permite añadir criterios de búsqueda avanzados, como especificar un prefijo para limitar la búsqueda a una carpeta específica, definir un patrón de nombre, o filtrar por fecha de modificación).

Casos de uso: Buscar todos los archivos PDF subidos en los últimos 7 días para procesarlos automáticamente, localizar archivos que contienen una palabra clave específica en su nombre para categorizarlos, encontrar archivos que superan cierto tamaño para moverlos a almacenamiento de archivo más económico, o buscar archivos con extensiones específicas (.csv, .json) para importarlos a una base de datos como Airtable.

Cuándo usarlo: Utiliza esta acción cuando necesites encontrar archivos específicos dentro de un bucket grande sin conocer su ubicación exacta. Es especialmente útil para workflows que procesan archivos según criterios dinámicos, implementan limpieza selectiva basada en atributos, o generan reportes de archivos que cumplen condiciones específicas. Combínala con filtros adicionales en n8n para refinar aún más los resultados y procesarlos posteriormente.

Esta acción recupera una lista de todos los buckets S3 disponibles en tu cuenta o servicio. Te proporciona metadatos sobre cada bucket (nombre, fecha de creación) sin acceder a su contenido, permitiéndote inventariar tu infraestructura de almacenamiento.

Parámetros clave: Return All (opcional, interruptor on/off que cuando está activado recupera todos los buckets disponibles sin límite), y Limit (opcional, campo numérico que define el máximo de buckets a devolver, por defecto 100).

Casos de uso: Generar un inventario automatizado de todos tus buckets S3 para auditorías o reportes de infraestructura, verificar la existencia de buckets específicos antes de ejecutar operaciones de carga o configuración, construir lógica condicional que selecciona dinámicamente el bucket correcto según el nombre o fecha de creación, o monitorear la creación de nuevos buckets en tu cuenta para aplicar políticas de seguridad automáticamente.

Cuándo usarlo: Emplea esta acción cuando necesites una vista general de tu infraestructura S3. Es útil al inicio de workflows de administración, para construir selectores dinámicos de buckets, o para generar reportes de recursos disponibles. Si trabajas con un único bucket conocido, no necesitas esta acción; úsala cuando gestiones múltiples buckets o cuando el bucket de destino se determine dinámicamente según condiciones del workflow.

Esta acción elimina completamente un bucket S3. Ten en cuenta que la mayoría de servicios S3 requieren que el bucket esté vacío (sin archivos) antes de poder eliminarlo. Es una operación administrativa que debes usar con extrema precaución.

Parámetros clave: Name (probablemente requerido, campo de texto donde proporcionas el nombre exacto del bucket S3 que deseas eliminar. Este campo puede configurarse como valor fijo o usar una expresión para obtener el nombre dinámicamente desde pasos anteriores del workflow).

Casos de uso: Eliminar buckets temporales creados dinámicamente para procesos puntuales una vez completada su función, implementar limpieza automatizada de entornos de testing que crean buckets efímeros, ejecutar tareas de administración programadas que eliminan buckets obsoletos según políticas de retención, o reorganizar infraestructura eliminando buckets migrados a nuevas ubicaciones.

Cuándo usarlo: Utiliza esta acción con máxima precaución: eliminar un bucket es una operación irreversible que puede causar pérdida de datos si el bucket aún contiene archivos. Es útil únicamente en workflows de administración de infraestructura, limpieza de entornos temporales, o reorganización profunda de tu arquitectura S3. Siempre combínala con verificaciones previas que aseguren que el bucket está vacío y que realmente deseas eliminarlo.

Esta acción crea un nuevo bucket S3 en tu servicio de almacenamiento. Es una operación administrativa fundamental para establecer nuevos espacios de almacenamiento, organizar contenido en buckets separados, o provisionar infraestructura dinámicamente según las necesidades de tu aplicación.

Parámetros clave: Name (requerido, campo de texto donde defines el nombre del nuevo bucket S3. Los nombres de bucket deben ser únicos globalmente dentro del servicio S3 y seguir convenciones específicas: solo minúsculas, números, y guiones; sin espacios ni caracteres especiales), y Additional Fields (opcional, sección que permite añadir propiedades avanzadas para configurar el bucket, como especificar la región de almacenamiento, definir ACLs por defecto, configurar políticas de versionado, o establecer reglas de ciclo de vida).

Casos de uso: Crear automáticamente un bucket dedicado para cada nuevo cliente que se registra en tu aplicación, provisionar buckets temporales para procesos de procesamiento por lotes que requieren almacenamiento aislado, establecer buckets organizados por fecha (por ejemplo, "respaldos-2024-03") al inicio de cada mes, o generar dinámicamente buckets con configuraciones específicas según el tipo de contenido que almacenarán.

Cuándo usarlo: Emplea esta acción cuando necesites crear infraestructura de almacenamiento de forma programática. Es especialmente útil en aplicaciones multi-tenant que requieren espacios aislados por cliente, en workflows de provisión de entornos, o al implementar estrategias de organización que separan contenido en múltiples buckets según criterios específicos. Combínala con la acción "Create Folder" para establecer también la estructura interna del nuevo bucket inmediatamente después de su creación.