Começar

Armazenamento de objetos para arquivos e uploads.

Armazenamento compatível com S3 para um projeto: como adicionar um bucket, as variáveis S3_* que a sua aplicação recebe e como o armazenamento e as operações são cobrados.

2 MIN DE LEITURA

O armazenamento de objetos guarda arquivos fora da sua aplicação: uploads de usuários, relatórios gerados, mídia, seus próprios backups. Ele funciona com qualquer biblioteca ou ferramenta que fale o protocolo S3 — os SDKs da AWS, o disco s3 do Laravel, django-storages, boto3, rclone e muitas outras.

Como adicionar armazenamento

Na aplicação, Visão geral → Serviços → Armazenamento de objetos → Adicionar armazenamento. Dê um nome ao bucket — letras latinas minúsculas, números e hifens, começando por uma letra — e confirme. O bucket fica pronto em instantes.

Um projeto pode ter até 3 buckets.

As variáveis que a sua aplicação recebe

Os dados de acesso são adicionados sozinhos às variáveis do projeto; a aplicação passa a usá-los no próximo deploy:

VariávelO que é
S3_ENDPOINTo endereço do armazenamento
S3_REGIONa região para usar no seu cliente S3
S3_BUCKETo nome do bucket
S3_KEYa chave de acesso
S3_SECRETa chave secreta

A chave funciona só para este bucket. Um segundo bucket do projeto recebe variáveis com o nome dele na frente: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET e assim por diante.

Uma variável sua com o mesmo nome continua valendo — útil se parte da aplicação deve continuar usando um armazenamento em outro lugar. Veja Variáveis de ambiente.

Exemplo: Laravel

Em config/filesystems.php, aponte o disco s3 para as variáveis:

'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,
],

Depois defina FILESYSTEM_DISK=s3 na aba Variáveis.

Exemplo: 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 },
})

Preço

Preço
ArmazenamentoUS$ 0,025 por GB por mês
Tráfegográtis — downloads do armazenamento não custam nada
GravaçõesUS$ 6 por milhão de operações
LeiturasUS$ 0,50 por milhão de operações

O armazenamento é medido todos os dias e cobrado pela média do mês, então um arquivo guardado por meio mês custa metade. O uso de um mês do calendário entra no próximo pagamento do projeto como uma única linha; não existe assinatura separada.

Como trazer seus arquivos

Arquivos que já estão no Amazon S3, no Google Cloud Storage, em outro armazenamento compatível com S3 ou numa pasta do seu servidor podem ser movidos para um bucket — tudo de uma vez ou aos poucos, sem tirar nada do ar. Veja Mover arquivos para o armazenamento de objetos.

Como excluir um bucket

Excluir o bucket remove todos os arquivos dele; eles não podem ser recuperados, e as variáveis do bucket saem do projeto. Excluir um bucket está disponível para o titular da conta e para os Administradores da aplicação.

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte