Usa Almacenamiento de App para almacenar, organizar y gestionar archivos usados por tu app en ejecución, incluidas imágenes, videos, documentos y cargas de usuarios.

Antes de usar Almacenamiento de App, conecta el proyecto a Nube de Atoms. Si no está conectado, pídele al Agente que conecte Nube de Atoms o sigue Nube de Atoms.

Comprende Almacenamiento de App en Nube de Atoms

Almacenamiento de App almacena archivos que tu proyecto necesita conservar y a los que necesita acceder. Está separado de los datos estructurados almacenados en tu Base de datos, los archivos cargados en Chat y los archivos que componen el código de tu proyecto.

Términos clave

• Bucket: El contenedor principal que se usa para almacenar y agrupar archivos relacionados. Puedes pensar en un bucket como un área de almacenamiento para una categoría de archivos. Cada bucket se configura como Public o Private, lo que controla quién puede acceder a los archivos dentro de él.
• Folder: Una forma opcional de organizar archivos dentro de un bucket. Las carpetas funcionan como las carpetas de tu computadora y pueden ayudar a que las colecciones grandes de archivos sean más fáciles de gestionar.
• Object: Un archivo individual almacenado en un bucket o carpeta, como una imagen, documento, video u otro archivo cargado.
• Object key: La ruta única que se usa para identificar dónde se almacena un archivo dentro de un bucket. Por ejemplo, images/profile/avatar.png podría ser la object key de una imagen almacenada dentro de una carpeta images/profile.

Elige Public o Private

Elige el tipo de bucket antes de crearlo:

Tipo de bucket	Úsalo para
Private	Archivos sensibles, específicos de la cuenta o cargados por usuarios.
Public	Archivos no sensibles que son intencionalmente seguros para exponer públicamente.

Usa Private para archivos sensibles o específicos del usuario. Si encuentras un error de acceso, no cambies el bucket a Public solo para hacer accesible el archivo. En su lugar, asegúrate de que tu app verifique que la persona que solicita el archivo tenga permiso para acceder a él.

Abre Almacenamiento de App en Nube de Atoms

1. Abre tu proyecto en un dispositivo de escritorio.
2. En la misma barra de herramientas del espacio de trabajo donde está el Visor de Apps , selecciona Nube de Atoms.
3. Selecciona Almacenamiento de App en la barra lateral de Nube de Atoms.

Permisos en Almacenamiento de App

Almacenamiento de App usa tu rol del espacio de trabajo. Tanto los Editores como los propietarios del espacio de trabajo pueden gestionar el almacenamiento de los proyectos que pueden abrir. Las personas que no son miembros del espacio de trabajo no pueden abrir ni gestionar el Almacenamiento de App del proyecto.

La configuración Public o Private del bucket no cambia quién puede gestionarlo en Nube de Atoms. Esa configuración controla cómo la app en ejecución puede proporcionar acceso a los archivos; los permisos del espacio de trabajo controlan quién puede gestionar el almacenamiento desde el espacio de trabajo de Nube de Atoms.

Crea un bucket

Una app puede tener hasta 10 buckets. Crea buckets separados cuando diferentes grupos de archivos necesiten distintas configuraciones de acceso o deban mantenerse separados para facilitar la organización.

1. En la página de Almacenamiento de App, selecciona Create Bucket.
2. En Bucket Name, introduce un nombre único para el bucket. El nombre debe:
   • contener entre 3 y 63 caracteres;
   • usar solo letras minúsculas, números y guiones; y
   • comenzar y terminar con una letra o un número.
3. En Bucket Type, elige Private o Public. Public está seleccionado de forma predeterminada, así que asegúrate de elegir el nivel de acceso que quieres antes de continuar.
4. Selecciona Create.

El nuevo bucket aparece en la página de Almacenamiento de App con su nombre, tipo y fecha de creación. Selecciona el bucket para abrirlo y ver su contenido.

Selecciona Create Bucket en Almacenamiento de App.

Los nombres de los buckets no se pueden cambiar después de su creación, así que elige un nombre claro que no necesites cambiar más adelante. Si tu app ya tiene 10 buckets, Create Bucket dejará de estar disponible.

Carga y organiza archivos

Dentro de un bucket, puedes cargar archivos directamente o crear una carpeta vacía sin cargar primero ningún archivo.

Crea una carpeta nueva

1. Abre el bucket o la folder donde quieres crear la nueva carpeta.
2. Selecciona Add Folder.
3. Introduce un nombre para la carpeta y luego selecciona Create. Los nombres de carpeta pueden contener letras, números, puntos (.), guiones (-) y guiones bajos (_), y no pueden tener más de 100 caracteres. Los nombres de carpeta no se pueden cambiar después de su creación.

Nombra la carpeta y luego selecciona Create.

Carga archivos

1. Abre el bucket o la folder donde quieres almacenar los archivos.
2. Selecciona Upload y luego elige uno o más archivos de tu dispositivo. Cada archivo puede tener hasta 100 MB.
3. Espera a que termine la carga y luego verifica que los archivos aparezcan en la lista.

La lista de archivos muestra el Name, Type, Size, la fecha de Last Modified y las Actions disponibles de cada elemento. Si necesitas volver a cargar el contenido de la carpeta actual, selecciona el botón refresh.

Carga archivos en el bucket o la carpeta seleccionados.

Previsualiza y gestiona archivos

Selecciona un archivo para abrir File Details. Las imágenes y videos compatibles se pueden previsualizar en el panel. Otros tipos de archivo muestran sus detalles disponibles y aún pueden descargarse. Si se usan todos los créditos, File Details muestra un estado de créditos agotados, y Download de un solo archivo te dirige a Actualizar en lugar de descargarlo.

Gestiona un archivo

Abre ... en la columna Actions del archivo y luego elige:

• Download para guardar una copia local cuando haya créditos disponibles. Si se usan todos los créditos, esta acción te dirige a Actualizar en su lugar.
• Rename para cambiar el nombre del archivo. El nuevo nombre puede usar letras, números, puntos, guiones y guiones bajos.
• Delete para eliminar el archivo después de confirmarlo.

Usa el menú de acciones del archivo para descargarlo, renombrarlo o eliminarlo.

Gestiona varios archivos

1. Selecciona la casilla junto a cada archivo. Las carpetas no se incluyen en la selección por lotes.
2. Selecciona Download para descargar juntos los archivos seleccionados, o selecciona Delete.
3. Si vas a eliminar, revisa la cantidad de archivos seleccionados y confirma Delete.

La eliminación no se puede deshacer desde Almacenamiento de App. Antes de renombrar o eliminar un archivo, verifica si la app todavía usa su object key. Después, actualiza cualquier referencia almacenada para que la app no siga solicitando la clave anterior.

Usa un archivo almacenado en tu app

Tu app identifica cada archivo almacenado usando su bucket name y object key. La object key muestra dónde se encuentra el archivo dentro del bucket. Por ejemplo, images/profile/avatar.png podría ser la object key de una imagen almacenada dentro de una carpeta images/profile.

Almacena el bucket name y la object key en la base de datos de tu app para que la app pueda localizar el archivo más tarde. Cuando tu app necesite mostrar o descargar el archivo, puede usar estos detalles para solicitar una URL de acceso.

Las URL de acceso pueden ser temporales. No las guardes como datos permanentes de la app, no las codifiques de forma fija en tu app ni las compartas en Chat, capturas de pantalla, registros o mensajes de soporte. En su lugar, almacena la object key y solicita una nueva URL de acceso cuando sea necesario acceder al archivo.

No almacenes claves de API, contraseñas u otras credenciales en Almacenamiento de App. Almacena las credenciales privadas de tiempo de ejecución en Claves and secrets. Solo el propietario del espacio de trabajo puede gestionar allí las credenciales privadas de tiempo de ejecución. Si eres Editor, pídele al propietario del espacio de trabajo que agregue o actualice la credencial.

Límites actuales

Límite	Valor actual
Buckets por app	10
Tamaño de cada archivo cargado	100 MB

Para obtener información actual sobre uso y capacidad de Cloud, consulta Cloud & AI Wallet.

Preguntas frecuentes

Mi espacio en disco está lleno. ¿Cómo libero almacenamiento?

1. Verifica el uso actual del almacenamiento e identifica los chats, proyectos o archivos más grandes.
2. Descarga o haz una copia de seguridad de cualquier cosa que puedas necesitar más adelante.
3. Elimina solo los elementos que ya no necesites. Si al eliminar un chat aparece una opción para quitar los datos de disco asociados, selecciónala solo después de confirmar que esos datos pueden descartarse.
4. Elimina los archivos grandes innecesarios, luego actualiza y vuelve a verificar el espacio disponible.

La eliminación puede ser permanente y puede afectar a un proyecto que haga referencia al archivo eliminado. Si el uso no disminuye después de la limpieza, contacta con Soporte con una captura de pantalla del almacenamiento, tu plan y la cuenta o espacio de trabajo afectados. No envíes el contenido de los archivos a menos que se solicite a través de un canal aprobado.