Crear un bucket

El bucket es el contenedor donde guardas tus objetos en OtterStorage. Puedes crearlo de dos maneras: desde la consola web, con un formulario guiado, o con cualquier cliente de la API compatible con S3 apuntando a nuestro endpoint https://s3.otterstorage.io. En esta guía recorrerás ambas vías con ejemplos reales, las reglas de nombres y las opciones que conviene decidir al crear el bucket.

Antes de empezar

Solo necesitas una cuenta de OtterStorage. Al crear un bucket emitirás sus credenciales, ya que las claves de acceso son por bucket: cada bucket tiene su propio par access key + secret key, lo que te permite aislar permisos por proyecto sin compartir una clave global.

• Endpoint S3: https://s3.otterstorage.io
• Región de ejemplo: eu-mad
• Credenciales: access key + secret key, emitidas por bucket.

Buena noticia para tu día a día: en OtterStorage no cobramos por peticiones ni por borrados, así que listar, escribir y limpiar objetos no añade coste de operaciones.

Reglas de nombres de bucket

El nombre del bucket forma parte de la dirección de tus objetos, por lo que debe cumplir las convenciones de S3. Antes de crearlo, comprueba que tu nombre:

• Usa solo minúsculas, números, guiones (-) y puntos (.).
• No contiene espacios, mayúsculas ni guiones bajos (_).
• Tiene entre 3 y 63 caracteres.
• Empieza y termina con una letra minúscula o un número.
• No tiene forma de dirección IP (por ejemplo, 192.168.0.1).
• Es único dentro de tu cuenta de OtterStorage.

Ejemplos válidos: mi-primer-bucket, backups-2026, fotos-eu-mad. Ejemplos no válidos: Mi_Bucket (mayúsculas y guion bajo), backup prod (espacio), ab (demasiado corto).

Crear un bucket desde la consola web

Es la vía más rápida si prefieres una interfaz visual. Inicia sesión en la consola y sigue estos pasos.

1. Abre el formulario de creación

En la sección Buckets pulsa el botón Crear bucket. Se abrirá un formulario con las opciones que verás a continuación.

2. Nombre del bucket

Escribe un nombre que cumpla las reglas de la sección anterior. La consola valida el nombre en el momento y te avisa si contiene caracteres no permitidos o si ya existe.

3. Elige la región

Selecciona la región donde se almacenarán los datos. En esta guía usamos eu-mad (Madrid, Unión Europea). Elegir la región más cercana a tus usuarios reduce la latencia y te ayuda a cumplir requisitos de residencia de datos.

4. Elige la tecnología de disco

OtterStorage te deja escoger el tipo de almacenamiento según tu caso de uso. Elige según el patrón de acceso y el rendimiento que necesites:

• HDD — la opción más económica. Ideal para backups, archivado y datos a los que accedes con poca frecuencia.
• SSD — equilibrio entre coste y rendimiento. Buena elección para activos web, imágenes y cargas de trabajo de acceso habitual.
• NVMe — el máximo rendimiento y la menor latencia. Pensado para datos en caliente, analítica y aplicaciones sensibles a la velocidad.

5. Opciones de versionado y Object Lock

Antes de confirmar, puedes activar dos protecciones directamente en el momento de la creación:

• Versionado: conserva copias anteriores de cada objeto, lo que te protege frente a sobrescrituras y borrados accidentales. Puedes activarlo o desactivarlo más tarde. Más detalles en ciclo de vida.
• Object Lock: aplica un modelo WORM (escribir una vez, leer muchas) que impide borrar o modificar objetos antes de una fecha. Debe habilitarse al crear el bucket y activa también el versionado de forma automática. Consulta la guía de retención y Object Lock.

6. Crea el bucket y emite las claves

Pulsa Crear. La consola creará el bucket y te ofrecerá generar el par de claves de acceso. Copia la secret key en un lugar seguro: se muestra una sola vez. Con esas claves ya podrás operar el bucket desde cualquier cliente S3.

Crear un bucket con la API S3

Si prefieres la terminal o automatizar la creación, usa cualquier cliente compatible con S3 apuntando a https://s3.otterstorage.io. A continuación tienes los ejemplos con AWS CLI y MinIO Client.

Con AWS CLI: aws s3 mb

La forma más directa es el comando de alto nivel mb (make bucket). Asume que ya tienes un perfil configurado con tu endpoint y credenciales (consulta la guía de AWS CLI):

aws --profile otter s3 mb s3://mi-primer-bucket

Si no has fijado el endpoint en el perfil, indícalo en la propia llamada:

aws --endpoint-url https://s3.otterstorage.io s3 mb s3://mi-primer-bucket

Con AWS CLI: aws s3api create-bucket

Para indicar explícitamente la región usa la operación de bajo nivel create-bucket con --create-bucket-configuration LocationConstraint=eu-mad:

aws --profile otter s3api create-bucket \
  --bucket mi-bucket-api \
  --create-bucket-configuration LocationConstraint=eu-mad

Si quieres habilitar Object Lock (modelo WORM) desde el inicio, añade --object-lock-enabled-for-bucket. Esto activa también el versionado de forma automática:

aws --profile otter s3api create-bucket \
  --bucket bucket-worm \
  --create-bucket-configuration LocationConstraint=eu-mad \
  --object-lock-enabled-for-bucket

Para activar el versionado en un bucket que ya existe, sin Object Lock:

aws --profile otter s3api put-bucket-versioning \
  --bucket mi-bucket-api \
  --versioning-configuration Status=Enabled

Con MinIO Client: mc mb

Si usas MinIO Client (mc), primero registra un alias para el endpoint de OtterStorage con tus claves y luego crea el bucket con mc mb:

# Registrar el endpoint como alias "otter"
mc alias set otter https://s3.otterstorage.io TU_ACCESS_KEY TU_SECRET_KEY

# Crear el bucket
mc mb otter/mi-primer-bucket

# Crear el bucket con Object Lock (WORM) habilitado
mc mb --with-lock otter/bucket-worm

Tienes la configuración completa de este cliente en la guía de MinIO Client.

Comprobar que el bucket existe

Lista tus buckets para confirmar que se ha creado correctamente. Como no facturamos las peticiones, puedes listar las veces que necesites:

# Con AWS CLI
aws --profile otter s3 ls

# Con MinIO Client
mc ls otter

Resumen

• Elige un nombre válido: minúsculas, sin espacios, único, de 3 a 63 caracteres.
• Desde la consola: nombre, región (eu-mad), tecnología (HDD/SSD/NVMe) y, si procede, versionado y Object Lock al crear.
• Con la API S3: aws s3 mb para lo rápido, o aws s3api create-bucket --create-bucket-configuration LocationConstraint=eu-mad para fijar la región; mc mb con MinIO Client.
• Object Lock solo puede habilitarse al crear el bucket y activa también el versionado.
• Las claves de acceso son por bucket; guarda la secret key de forma segura. Y recuerda: no cobramos por peticiones ni por borrados.

¿Listo para subir tu primer objeto? Continúa con la guía de AWS CLI o vuelve a la documentación.