Tovanix
Tovanix

Almacenamiento de objetos

Esta guía explica cómo activar y usar el almacenamiento de objetos de Tovanix:

  • Es compatible con S3 y el tráfico de salida no se cobra aparte; la suscripción es por cuenta, la cuota mensual incluye cierta cantidad de almacenamiento y de solicitudes, y el excedente se liquida cada día desde el saldo.
  • Al crear un bucket eliges la ubicación y la clase de almacenamiento, y el sistema le agrega un prefijo al nombre para que sea único a nivel global.
  • Cada bucket puede tener varias claves de acceso de solo lectura o de lectura y escritura; el secreto solo se muestra una vez, y una clave nueva tarda un tiempo en sincronizarse.
  • Desde la consola puedes subir y descargar, los archivos grandes se suben por partes automáticamente, y puedes configurar acceso público, CORS, ciclo de vida, migración y bloqueo.
  • Desde el día del vencimiento pasa a solo lectura y se revocan las claves emitidas; si pasan 7 días sin renovar, los datos se vacían y eliminan.

Qué es y cómo se cobra

El almacenamiento de objetos es compatible con S3: cada bucket recibe sus propias claves de acceso, los SDK y herramientas de S3 que ya usas se conectan directamente, y el tráfico de salida no se cobra aparte. En «Servicios en la nube → Buckets», elige el plazo (1, 3, 6 o 12 meses) y pulsa «Activar ahora»; la suscripción es por cuenta, y después de activarla puedes crear varios buckets.

  • La cuota mensual incluye cierta cantidad de almacenamiento y de solicitudes por mes, y el número de buckets tiene un límite; lo que exceda se cobra por almacenamiento y por número de solicitudes (de clase A y de clase B). Las cifras concretas son las que muestra la página de activación.
  • El uso se recopila una vez al día (por día UTC); el «Excedente de este mes (estimado)» se calcula con el uso ya recopilado y no incluye la cuota mensual.
  • El excedente se liquida cada día desde el saldo de la cuenta, que por eso puede quedar en negativo; cuando pasa a negativo recibes un aviso, así que mantén saldo suficiente.

Crear un bucket

En la página «Buckets», pulsa «Crear bucket»: el nombre solo puede tener letras minúsculas, números y guiones, y el sistema le agrega automáticamente un prefijo para que sea único a nivel global, aunque tú siempre ves el nombre que elegiste; la ubicación puede ser «Auto» (el sistema elige la más cercana) o una región concreta; la clase de almacenamiento puede ser «Estándar» o «Acceso poco frecuente».

La lista de buckets muestra el espacio ocupado, la ubicación y la clase de almacenamiento de cada uno. Pulsa el nombre para abrir el detalle, que tiene cuatro pestañas: «Objetos», «Claves de acceso», «Métricas» y «Configuración».

Claves de acceso

  • En la pestaña «Claves de acceso» del bucket, pulsa «Emitir clave» y elige el permiso «Lectura y escritura» o «Solo lectura». La clave emitida solo puede acceder a ese bucket y se puede usar en cualquier SDK o herramienta de S3; un bucket puede tener varias.
  • La Secret Access Key solo se muestra una vez, al emitirla, y después de cerrar ya no se puede volver a ver: cópiala y guárdala de inmediato, o pulsa «Copiar como configuración».
  • Una clave nueva tarda un tiempo en sincronizarse con los nodos de almacenamiento, y la página indica aproximadamente cuántos segundos; mientras tanto las llamadas devuelven 401, lo que no significa que la clave esté mal escrita: espera un poco y vuelve a intentarlo.
  • En «General», dentro de la «Configuración» del bucket, están el endpoint S3 y el nombre completo del bucket, que necesitas para conectarte; las claves que ya no uses, revócalas con «Revocar». La forma de conectarse y ejemplos de código están en la documentación de la API de almacenamiento de objetos (/docs/objstore).

Gestionar archivos en la consola

En la pestaña «Objetos» del bucket puedes crear una «Nueva carpeta», «Subir» archivos o «Subir carpeta», y también descargar, copiar el enlace, eliminar y filtrar por prefijo del nombre; los archivos grandes se suben automáticamente por partes, y la ruta de un archivo puede tener hasta 1024 bytes. Puedes marcar varios archivos o carpetas para eliminarlos juntos.

La primera vez que abres un bucket hay que preparar credenciales de acceso temporales, lo que tarda alrededor de medio minuto, y después continúa solo. La pestaña «Métricas» muestra el uso de ese bucket; los datos se actualizan una vez al día, y un bucket nuevo no tiene datos hasta el día siguiente.

Configuración del bucket

La pestaña «Configuración» del detalle del bucket tiene estas secciones:

  • General — Muestra el nombre completo del bucket, el endpoint S3, la ubicación, la clase de almacenamiento y la fecha de creación.
  • Acceso público — Si lo activas, cualquiera puede leer públicamente todos los objetos del bucket. La «URL pública de desarrollo» solo sirve para pruebas; para uso real, vincula un «Dominio personalizado», que solo puede ser un dominio a tu nombre con DNS administrado.
  • CORS — Hay que configurar CORS cuando una página web va a leer o escribir directamente en este bucket (subidas o lecturas directas desde el frontend); el origen no puede ser el comodín *.
  • Ciclo de vida — Elimina objetos automáticamente según prefijo y días, los pasa a acceso poco frecuente o limpia las subidas por partes sin terminar; se recomienda agregar en cada bucket una regla que limpie las subidas por partes sin terminar.
  • Migración — Trae los datos de tu bucket S3 en otro lugar poco a poco, a medida que se accede a ellos: cuando se lee un archivo que este bucket todavía no tiene, se recupera en tiempo real del bucket de origen y se guarda aquí, sin interrumpir el servicio. Hay que indicar el nombre, la región y la clave de acceso del bucket de origen, y basta con permiso de solo lectura; la plataforma solo usa esa clave para leer el bucket de origen y no la guarda. Los datos migrados ocupan almacenamiento de este bucket y cuentan como solicitudes; al desactivar la migración, los archivos ya migrados se quedan en este bucket.
  • Bloqueo — Durante el período de retención, los archivos que coinciden con el prefijo no se pueden eliminar ni sobrescribir: no puedes hacerlo tú ni el soporte de la plataforma, y mientras tanto se siguen cobrando. Se configura en días, y el máximo es el que muestra la página; no hay bloqueo permanente.
  • Subidas sin terminar — Cuando se interrumpe la subida de un archivo grande quedan las partes ya subidas, que se cobran como almacenamiento pero no aparecen en la lista de archivos; aquí puedes verlas y limpiar las de hace más de 24 horas.
  • Zona de peligro — «Vaciar bucket» elimina todos los archivos del bucket y no se puede deshacer; antes de eliminar un bucket hay que vaciarlo, y al eliminarlo se revocan también todas sus claves.

Renovación y vencimiento

  • En la página «Buckets», pulsa «Renovar», elige el plazo y paga. Por ahora no hay renovación automática; antes del vencimiento la plataforma envía recordatorios.
  • Desde el día del vencimiento los buckets pasan a solo lectura: todavía puedes explorar, descargar, eliminar y vaciar, pero no subir, cambiar la configuración, crear buckets nuevos ni emitir claves nuevas.
  • Al vencer se revocan las claves de acceso emitidas, y después de renovar hay que emitir claves nuevas.

Si pasan 7 días desde el vencimiento sin renovar, la plataforma vacía y elimina los datos de los buckets, sin posibilidad de recuperarlos, y te avisa después de eliminarlos. Si necesitas conservar los datos, descárgalos o renueva antes de ese momento.

Solución de problemas

  • Las llamadas con una clave recién emitida devuelven 401 — La clave nueva todavía se está sincronizando con los nodos de almacenamiento — Espera lo que indica la página y vuelve a intentarlo; no vuelvas a crear la clave una y otra vez.
  • La factura incluye costos de almacenamiento, pero el bucket no muestra tantos archivos — Hay partes de subidas interrumpidas, que no aparecen en la lista de archivos — Revísalas y límpialas en «Configuración → Subidas sin terminar».
  • No se puede eliminar el bucket — El bucket todavía tiene archivos, o hay archivos dentro de su período de bloqueo — Primero usa «Vaciar bucket»; si se indica que hay un bloqueo, revisa la regla en «Configuración → Bloqueo»: los archivos dentro del período de retención solo se pueden eliminar cuando este termine.
  • Al abrir el bucket aparece que se están preparando credenciales de acceso temporales — La primera vez que se abre hay que preparar credenciales temporales — Tarda alrededor de medio minuto y después continúa solo; no hace falta recargar la página.
  • Aparece que se alcanzó el límite de buckets — El número de buckets a tu nombre llegó al límite — Elimina los buckets que ya no uses y vuelve a crear uno.
  • El saldo de la cuenta quedó en negativo — El uso que excede lo incluido se liquida cada día desde el saldo — Recarga para cubrir el saldo; el excedente estimado del mes se ve en la página «Buckets».

Preguntas frecuentes

¿Descargar archivos cobra tráfico aparte?

No, el tráfico de salida no se cobra aparte. Los costos vienen de la cuota mensual y del almacenamiento y las solicitudes que excedan lo incluido.

¿Los datos se eliminan apenas vence?

No. Desde el día del vencimiento los buckets pasan a solo lectura y puedes descargar y limpiar; solo si pasan 7 días desde el vencimiento sin renovar se vacían y eliminan, sin posibilidad de recuperarlos.

¿Qué hago si perdí la Secret Access Key?

Solo se muestra una vez, al emitirla, y si se pierde no se puede recuperar. Revoca la clave anterior y emite una nueva.

Páginas relacionadas: Centro de ayuda · Guías y preguntas frecuentes · Almacenamiento de objetos compatible con S3 · API de almacenamiento de objetos

Cargando…