Upload Storage File

Tipo: storage-upload-file · Paquete: Storage Activities v1.0.5 · Salida: object

Sube un archivo del disco del robot a un bucket del Almacenamiento de Zoan Cloud. Devuelve la referencia del archivo (id, bucket, name, size…), que puedes pasar a otras actividades, a otros procesos o a un AI Workflow.

Cómo funciona

Lee el archivo de path (falla si no existe).
Lo sube al bucket bucket (por defecto default) con el nombre name (por defecto, el nombre del archivo). Si el bucket no existe, se crea.
Si ya hay un archivo con el mismo nombre en el mismo bucket, lo reemplaza y conserva su id. Por eso repetir la subida es seguro: no crea duplicados.

Zoan Cloud revisa cada archivo antes de guardarlo:

Detecta el tipo por su contenido real, no por la extensión. Rechaza ejecutables, scripts y archivos HTML o SVG.
Lo analiza en busca de malware; si encuentra una amenaza, lo rechaza y no lo guarda.
Comprueba que la organización tenga espacio en su almacenamiento (al reemplazar un archivo, solo cuenta la diferencia de tamaño).
Acepta archivos de hasta 100 MB.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`path`	`string`	—	Ruta local del archivo que se sube. Ej: `C:/reportes/ventas.xlsx`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`name`	`string`	nombre del archivo	Nombre de destino dentro del bucket. Puede incluir carpetas (`2026/ventas.xlsx`).
`bucket`	`string`	`"default"`	Nombre del bucket: letras, dígitos, `.`, `_` y `-`, hasta 120 caracteres.

Salida

Devuelve un object (diccionario) con la referencia del archivo guardado:

Campo	Tipo	Descripción
`id`	`string`	Id del archivo. Si reemplazaste uno existente, es el mismo id de antes.
`bucket`	`string`	Bucket donde quedó.
`name`	`string`	Nombre dentro del bucket.
`size`	`number`	Tamaño en bytes.
`content_type`	`string`	Tipo de contenido detectado.
`created_at`	`string`	Fecha de creación del archivo (la original, si se reemplazó).

Léelos con archivo["id"], archivo["name"]…

Errores comunes

Mensaje	Causa y solución
`'path' es obligatorio.`	No indicaste `path`.
`No se encontró el archivo.`	La ruta de `path` no existe en la máquina del robot. Revisa la ruta o genera el archivo antes.
`Las actividades de almacenamiento requieren el contexto de ejecución de Zoan Cloud. Falta: …`	El proceso no corre desde Zoan Cloud ni desde el Designer con sesión iniciada.
`… HTTP 400: …Invalid bucket name…`	El nombre del bucket tiene caracteres no permitidos (espacios, `/`, tildes) o más de 120 caracteres.
`… HTTP 400: …Bucket '…' is read-only; uploads are not allowed.`	El bucket es de solo lectura. Usa otro o pide a un administrador que cambie su configuración en Almacenamiento.
`… HTTP 400: …No se aceptan archivos … por seguridad…` / `…contiene software malicioso…`	El contenido del archivo es de un tipo bloqueado o tiene malware. No se guarda nada.
`… HTTP 403: …Se alcanzó el almacenamiento de la organización…`	No hay espacio disponible. Borra archivos que ya no uses (por ejemplo con Delete Storage File) o pide ampliar el almacenamiento.
`… HTTP 404: …Ese bucket no existe en este ambiente.`	El nombre corresponde a un bucket reservado de Zoan Cloud. Usa otro nombre.

Todos llegan con el prefijo “No se pudo subir el archivo: ”. Captúralos con Try / Catch; un error de red pasajero se puede reintentar con Retry.

Ejemplo

Upload Storage File   path = "C:/reportes/cierre-diario.pdf"
                      bucket = "reportes"   name = "2026/09/cierre-diario.pdf"
                      → output: archivo
Get Storage File URL  id = archivo["id"]   → output: enlace
Log   level = info   message = "Reporte guardado con id " + str(archivo["id"])

Actividades relacionadas

Download Storage File — traer el archivo de vuelta a una máquina.
Get Storage File URL — compartir el archivo con un enlace temporal.
List Storage Files — ver qué hay en el bucket.