--- title: "Object Storage" description: "Crea buckets compatibles con S3 y access keys, conecta cualquier cliente S3, sirve ficheros por el CDN y conoce los tiers, precios y límites." category: "Despliegue" language: es source: https://cubepath.com/es/docs/products/despliegue/almacenamiento-de-objetos updated: 2026-10-28 --- # Object Storage Crea buckets compatibles con S3 desde **Object Storage** en [my.cubepath.com](https://my.cubepath.com). Funcionan con cualquier cliente S3: la AWS CLI, rclone, restic, boto3 y el resto de SDKs de AWS, o `cubecli`. ``` https://eu.cubestorage.io (región eu) ``` > Nota: Tu cuenta debe estar [verificada](/docs/products/introduccion/configurar-tu-cuenta) antes de poder crear un bucket, y Object Storage solo está disponible en proyectos con facturación **por hora**. ## Para qué sirve Object Storage guarda ficheros (objetos) en buckets y los sirve por HTTPS con la API S3. Encaja con datos que escribes desde una aplicación o una herramienta, no desde un disco montado: - **Backups y archivos**: dumps de bases de datos, copias de servidores con restic o rclone, logs que tienes que conservar. - **Datos de aplicación**: ficheros que suben tus usuarios, informes generados, exportaciones. - **Recursos estáticos y media** servidos al público a través del [CDN](/docs/products/despliegue/desplegar-un-cdn). Los buckets son **siempre privados**. No hay buckets públicos ni hosting de webs estáticas: para publicar ficheros, conecta el bucket a una zona CDN (mira **Servir ficheros al público** más abajo). ## Tiers | Tier | Soporte | Ideal para | |------|---------|------------| | **Infrequent Access** | HDD | Backups, archivos, logs y datos que se escriben una vez y se leen poco | | **Standard** | SSD | Próximamente. Contenido que se lee a menudo: media, recursos del CDN, datos de aplicación | Todos los tiers de una región comparten el mismo endpoint. Un bucket **no puede cambiar de tier** una vez creado. ## Crear un bucket ```steps ### Elige un tier de almacenamiento Escoge el tier según la frecuencia con que se vayan a leer los datos. La tarjeta muestra sus precios y lo que incluye gratis. ![Selección de tier con los precios de Infrequent Access](https://cdn.cubepath.com/img/docs/products/4adae0d9-4fd8-417a-9f21-5cb9a44e8c18.png) ### Ponle nombre al bucket De 3 a 63 letras minúsculas, números y guiones, empezando y terminando por letra o número. Los nombres son **únicos entre todos los clientes de CubePath**, así que uno muy común puede estar cogido. ### Versionado (opcional) Marca **Activar versionado** para conservar las versiones anteriores de los objetos sobrescritos o borrados. También puedes activarlo después. ### Crea Pulsa **Crear bucket**. Está listo en 10 a 20 segundos. ``` > Nota: Tu primer bucket puede requerir un saldo de al menos **5 $**. Cada organización puede tener hasta **20 buckets**. ## Crear un access key Los clientes S3 se autentican con un **access key**, no con tu usuario de CubePath ni con tu token de API. Abre **Object Storage → Access keys → Crear access key**: - **Nombre**: para qué es la clave (por ejemplo, `backups-db01`). - **Tier**: las claves funcionan sobre los buckets de un tier. - **Permiso**: **Lectura y escritura**, o **Solo lectura**. - **Acceso a buckets**: **Todos los buckets** del proyecto en ese tier (incluidos los que crees después), o **Solo los buckets seleccionados**. - **Caducidad** (opcional): la clave deja de funcionar al final de ese día (UTC) y después se elimina. > Aviso: La **secret access key solo se muestra una vez**. Cópiala o descarga uno de los ficheros listos para usar (`.env`, `rclone.conf` o `~/.aws/credentials`) antes de cerrar el diálogo. Si la pierdes, borra la clave y crea otra. La clave empieza a funcionar unos segundos después de crearla, cuando su estado pasa a **Active**. > Consejo: Crea una clave por aplicación, dale solo los buckets que necesita y hazla de solo lectura si nunca escribe. Así, si se filtra una clave, expone un bucket y no todos. ## Conectar un cliente S3 Usa el endpoint `https://eu.cubestorage.io`, la región `eu` y tu access key. **AWS CLI** ```bash aws configure set aws_access_key_id CPXXXXXXXXXXXXXXXXXX aws configure set aws_secret_access_key TU_SECRET aws configure set region eu aws s3 cp backup.tar.gz s3://mi-bucket/ --endpoint-url https://eu.cubestorage.io aws s3 ls s3://mi-bucket/ --endpoint-url https://eu.cubestorage.io ``` **rclone** (`~/.config/rclone/rclone.conf`) ```ini [cubepath] type = s3 provider = Other access_key_id = CPXXXXXXXXXXXXXXXXXX secret_access_key = TU_SECRET endpoint = https://eu.cubestorage.io region = eu ``` ```bash rclone copy ./backups cubepath:mi-bucket/backups ``` **cubecli** ```bash cubecli s3 bucket create mi-bucket --tier ia cubecli s3 key create --name backups --tier ia --bucket mi-bucket --output rclone >> ~/.config/rclone/rclone.conf ``` Funcionan los dos estilos de URL: `https://eu.cubestorage.io/mi-bucket/fichero.txt` (path style) y `https://mi-bucket.eu.cubestorage.io/fichero.txt` (virtual host). Las subidas directas desde un navegador (CORS) solo funcionan con la URL **path style**. ## Las pestañas del bucket | Pestaña | Para qué sirve | |---------|----------------| | **Resumen** | Tamaño, número de objetos, uso y coste del mes, y los datos de conexión (endpoint, región, URLs) | | **Archivos** | Navegar, subir, descargar y borrar ficheros, y crear carpetas | | **CDN** | Servir los ficheros del bucket al público a través de una zona CDN | | **Ajustes** | Versionado, protección contra borrado y datos de facturación | | **Actividad** | Cada cambio en el bucket y quién lo hizo | El tamaño cuenta todas las versiones guardadas y se actualiza aproximadamente cada 15 minutos. ### Archivos La pestaña **Archivos** es un explorador de ficheros dentro del panel: abre carpetas, **Sube** ficheros (o arrástralos al panel), **Descarga**, **Borra** ficheros o carpetas enteras y crea una **Nueva carpeta**. Los ficheros grandes se suben por partes automáticamente. El explorador funciona con tu sesión del panel; los scripts y aplicaciones usan un access key y cualquier cliente S3. Sus peticiones se facturan como cualquier otra petición al bucket. ### Ajustes - **Versionado** conserva cada versión de un objeto, para poder recuperar ficheros sobrescritos o borrados. Las versiones antiguas se almacenan y facturan como cualquier otro dato. Una vez activado, el versionado se puede **suspender** pero nunca desactivar. - **Protección contra borrado** impide borrar el bucket desde el panel, la API o la CLI hasta que la desactives. ## Servir ficheros al público Los buckets siguen siendo privados. Para publicar sus ficheros, añade el bucket como **origen** de una [zona CDN](/docs/products/despliegue/desplegar-un-cdn): abre la zona → [Orígenes](/docs/products/despliegue/cdn-origins-es) → **Añadir origen** y elige el bucket. La pestaña **CDN** del bucket te lleva hasta ahí y muestra la URL pública cuando está conectado. El CDN lee el bucket con una clave dedicada de solo lectura que solo funciona desde los edges del CDN, y cachea los ficheros cerca de tus visitantes. Los access keys de tu bucket nunca salen de tus aplicaciones. - El tráfico del bucket al CDN **no se factura como egress**: pagas la zona CDN. - Las peticiones de los edges del CDN cuentan como **peticiones de clase B** del bucket. - Un origen CDN por bucket. Para dejar de servirlo, borra ese origen de la zona. ## Precios Se factura por horas vencidas, desde que el bucket está activo hasta que se borra. No se cobra nada mientras se está creando. | Infrequent Access | Precio | |-------------------|--------| | Almacenamiento | 0,004 $ por GiB-mes | | Egress (hacia Internet) | 0,01 $ por GiB | | Peticiones clase A (escrituras y listados: PUT, POST, COPY, LIST) | 0,006 $ cada 1.000 | | Peticiones clase B (lecturas: GET y HEAD de un objeto) | 0,0006 $ cada 1.000 | | Borrados, ListBuckets, OPTIONS | Gratis | **Gratis cada mes**, por organización y tier: **5 GiB-mes** de almacenamiento, **5 GiB** de egress y **20.000 peticiones**. Recibes un email cuando se agota lo gratuito. La pestaña **Uso** muestra el almacenamiento, el egress y las peticiones de cada bucket en el mes, lo facturado hasta ahora y una proyección del mes completo. Las peticiones fallidas (4xx y 5xx) nunca se facturan. ## Límites - **20 buckets** por organización y **20 access keys** por proyecto y tier. - **5 GiB** por subida simple; los ficheros más grandes van por partes (multipart, hasta 10.000 partes). El panel se encarga de ello por ti. - **1 TiB por bucket** como límite blando: recibes un email cuando un bucket lo supera y, si sigue por encima pasadas **72 horas**, se pausan las subidas a ese bucket (lecturas, listados y borrados siguen funcionando) hasta que vuelva a estar por debajo. Contacta con soporte si un bucket necesita más. - Las URLs prefirmadas duran como mucho 24 horas. Las subidas multipart sin terminar se limpian a los 7 días. ## Borrar un bucket Desde **Ajustes → Eliminar bucket**, escribe el nombre del bucket para confirmar. - Por defecto el bucket solo se borra si está **vacío**. Marca **Eliminar también todos los objetos del bucket** para borrar antes todos los objetos, versiones y subidas a medias. No se puede deshacer y tarda un rato en buckets grandes. - Un bucket protegido, o que todavía sirve un origen CDN, no se puede borrar hasta que desactives la protección o quites el origen. - La facturación se detiene cuando termina el borrado. El nombre queda **reservado para tu organización durante 90 días**. > Nota: Si un bucket aparece como **suspendido**, tus datos se conservan pero no se puede acceder a ellos. Si es porque tu organización está suspendida, recargar el saldo restaura el acceso.