Actualizado el Jul 26, 2026

Crear URL Firmada de Almacenamiento

Usa esta acción cuando un paso posterior necesite una URL de descarga de corta duración para un archivo que ya existe en el storage de tu empresa.

Mejor para

• Convertir una referencia de archivo almacenado (por ejemplo message.body.file o el step(N).file de un paso anterior) en una URL descargable
• Enviar una imagen almacenada a una entrada de visión de un LLM, protegida por el tipo de medio image
• Volver a compartir un archivo ya subido en un paso posterior sin subirlo de nuevo

Campos principales

Campo	Qué hace
Archivo	Expresión CEL que resuelve a una referencia de archivo de storage con bucket y fullPath, como message.body.file o step(0).file. Cuando se completa, los dos campos siguientes se ignoran
bucket	Expresión CEL que resuelve al bucket de storage. Úsalo solo cuando Archivo no esté definido
full_path	Expresión CEL que resuelve a la ruta del objeto en el storage. Úsalo solo cuando Archivo no esté definido
media_kind	Guarda opcional de tipo de contenido: any (predeterminado), image, audio, video, pdf, text o document. Cuando el tipo del archivo almacenado no coincide, el paso falla en vez de devolver una URL. Elige image cuando la URL se enviará a una entrada de imagen de un LLM
expires_in_seconds	Tiempo de vida de la URL firmada en segundos. Por defecto es 900 (15 minutos) y está limitado a 3600 (1 hora)
Propósito	Etiqueta opcional de para qué se usará la URL, mostrada en los logs

Qué pueden usar los pasos posteriores

• step(N).signedUrl
• step(N).contentType
• step(N).size
• step(N).mediaKind
• step(N).bucket
• step(N).fullPath
• step(N).name
• step(N).expiresAt
• step(N).file — un objeto de archivo listo para reutilizar (bucket, fullPath, name, metadata) en pasos de medios posteriores

Consejos

• El archivo debe existir y pertenecer a tu empresa: los objetos en el área de storage de otro tenant siempre se deniegan (storage_media_acl_denied), y los objetos inexistentes fallan con storage_media_not_found.
• Mantén el tiempo de vida tan corto como lo permita el sistema consumidor — la URL deja de funcionar en expiresAt.
• Usa la guarda de tipo de medio cuando el siguiente paso asuma un tipo de archivo específico; una discrepancia falla con storage_media_unsupported_type en vez de pasar el archivo equivocado.
• Combina con Subir a Storage o Descargar al Almacenamiento (actions/network/http/download-to-storage) cuando el archivo todavía no esté en el storage.