Empezar

Almacenamiento de objetos para archivos y subidas.

Almacenamiento compatible con S3 para un proyecto: cómo añadir un bucket, las variables S3_* que recibe tu aplicación y cómo se cobran el almacenamiento y las operaciones.

2 MIN DE LECTURA

El almacenamiento de objetos guarda archivos fuera de tu aplicación: subidas de los usuarios, informes generados, archivos multimedia, tus propias copias de seguridad. Funciona con cualquier biblioteca o herramienta que hable el protocolo S3: los SDK de AWS, el disco s3 de Laravel, django-storages, boto3, rclone y muchas más.

Añadir almacenamiento

En la aplicación, Resumen → Servicios → Almacenamiento de objetos → Añadir almacenamiento. Ponle un nombre al bucket —letras latinas minúsculas, números y guiones, empezando por una letra— y confirma. El bucket estará listo en un momento.

Un proyecto puede tener hasta 3 buckets.

Las variables que recibe tu aplicación

Los datos de acceso se añaden solos a las variables del proyecto; la aplicación los toma con su próximo despliegue:

VariableQué es
S3_ENDPOINTla dirección del almacenamiento
S3_REGIONla región que debes usar en tu cliente S3
S3_BUCKETel nombre del bucket
S3_KEYla clave de acceso
S3_SECRETla clave secreta

La clave funciona solo con este bucket. Un segundo bucket del proyecto recibe sus variables con su nombre delante: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET, etc.

Si tienes una variable propia con el mismo nombre, se mantiene; es útil si parte de tu aplicación debe seguir usando un almacenamiento en otro sitio. Consulta Variables de entorno.

Ejemplo: Laravel

En config/filesystems.php, apunta el disco s3 a las variables:

's3' => [
    'driver' => 's3',
    'key' => env('S3_KEY'),
    'secret' => env('S3_SECRET'),
    'region' => env('S3_REGION'),
    'bucket' => env('S3_BUCKET'),
    'endpoint' => env('S3_ENDPOINT'),
    'use_path_style_endpoint' => true,
],

Después, define FILESYSTEM_DISK=s3 en la pestaña Variables.

Ejemplo: Node.js

import { S3Client } from '@aws-sdk/client-s3'
 
const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: process.env.S3_REGION,
  credentials: { accessKeyId: process.env.S3_KEY, secretAccessKey: process.env.S3_SECRET },
})

Precio

Precio
Almacenamiento0,025 US$ por GB al mes
Tráficogratis: las descargas desde el almacenamiento no cuestan nada
Escrituras6 US$ por millón de operaciones
Lecturas0,50 US$ por millón de operaciones

El almacenamiento se mide cada día y se promedia a lo largo del mes, así que un archivo guardado durante medio mes cuesta la mitad. El uso de cada mes natural se suma al próximo pago del proyecto como una sola línea; no hay una suscripción aparte.

Traer tus archivos

Los archivos que ya tienes en Amazon S3, Google Cloud Storage, otro almacenamiento compatible con S3 o una carpeta de tu servidor se pueden pasar a un bucket, todos de una vez o poco a poco sin cortes de servicio. Consulta Mover archivos al almacenamiento de objetos.

Eliminar un bucket

Eliminar el bucket borra todos los archivos que contiene; no se pueden recuperar y sus variables desaparecen del proyecto. Eliminar un bucket está disponible para el propietario de la cuenta y los Administradores de la aplicación.

¿Sigues con dudas?

Escríbenos por chat: la AI responde al momento y un ingeniero se une cuando hace falta, a cualquier hora del día.

Contactar con soporte