Actualizado el Jul 26, 2026

Descargar al Almacenamiento

Usa esta acción cuando quieras descargar un archivo desde una URL externa y transmitirlo directamente al storage de tu empresa.

Mejor para

• Archivos demasiado grandes para el límite de 5 MB de respuesta de la acción Solicitud HTTP — esta acción transmite hasta 500 MB sin mantener el archivo completo en memoria
• Guardar un archivo remoto una sola vez y reutilizar su referencia almacenada o URL firmada en pasos posteriores
• Importar medios (imágenes, videos, audios, documentos) desde sistemas externos

Campos principales

Campo	Qué hace
URL HTTP	Expresión CEL que resuelve a la URL de descarga. Solo se hacen solicitudes GET, y solo se permiten URLs HTTP(S) públicas
Propósito	Etiqueta opcional de lo que hace la descarga, mostrada en los logs
Encabezados HTTP	Headers de solicitud opcionales, por ejemplo para autenticación. Las claves y los valores son expresiones CEL — combina con Resolver Variables para cargar secretos
File Name	Expresión CEL opcional para el nombre del archivo almacenado. Si se omite, usa el header Content-Disposition de la respuesta, luego la ruta de la URL y finalmente un nombre generado
Tipo de contenido	Expresión CEL opcional para el tipo MIME. Se detecta automáticamente desde el header Content-Type de la respuesta o la extensión del archivo cuando se omite
Categoría	Almacena el archivo como images, videos, audios o documents. Se detecta automáticamente desde el tipo de contenido cuando se omite
Public	Controla si el archivo almacenado debe ser abiertamente accesible (desactivado por defecto)

Qué pueden usar los pasos posteriores

• step(N).status
• step(N).file
• step(N).signedUrl
• step(N).contentType
• step(N).size

step(N).file contiene el objeto almacenado (bucket, fullPath, name, metadata), y step(N).signedUrl es una URL de descarga temporal válida por unos 15 minutos.

Consejos

• Las descargas están limitadas a 500 MB — las transferencias mayores se abortan con download_size_limit_exceeded.
• Los bytes descargados cuentan para la cuota de storage de tu empresa, y el paso falla con storage_quota_exceeded cuando la descarga no cabe en ella.
• Una respuesta no-2xx hace fallar el paso (http_client_error o http_server_error), y la descarga completa debe terminar en un máximo de 5 minutos.
• No queda nada atrás en caso de fallo: un archivo parcialmente almacenado se limpia automáticamente.
• Usa Crear URL Firmada de Almacenamiento (actions/media/storage/signed-url) más tarde cuando necesites un nuevo enlace de descarga después de que expire el inicial.