Começar

Armazenamento de objetos para ficheiros 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 são cobrados o armazenamento e as operações.

2 MIN DE LEITURA

O armazenamento de objetos guarda ficheiros fora da sua aplicação: uploads dos utilizadores, relatórios gerados, multimédia, as suas próprias cópias de segurança. Funciona com qualquer biblioteca ou ferramenta que fale o protocolo S3 — os SDK da AWS, o disco s3 do Laravel, django-storages, boto3, rclone e muitas outras.

Adicionar armazenamento

Na aplicação, Visão geral → Serviços → Armazenamento de objetos → Adicionar armazenamento. Dê um nome ao bucket — letras latinas minúsculas, algarismos e hífenes, a começar por uma letra — e confirme. O bucket fica pronto num instante.

Um projeto pode ter até 3 buckets.

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

Os dados de acesso são acrescentados automaticamente às variáveis do projeto; a aplicação passa a usá-los na publicação seguinte:

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

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

Uma variável sua com o mesmo nome mantém-se — útil se parte da aplicação tiver de continuar a usar armazenamento noutro sítio. Consulte 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 no separador 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
Armazenamento0,025 US$ por GB por mês
Tráfegogratuito — as transferências a partir do armazenamento não custam nada
Escritas6 US$ por milhão de operações
Leituras0,50 US$ por milhão de operações

O armazenamento é medido todos os dias e calculado em média ao longo do mês, por isso um ficheiro guardado durante meio mês custa metade. A utilização de cada mês civil é somada ao próximo pagamento do projeto numa única linha; não há uma subscrição separada.

Trazer ficheiros

Os ficheiros que já estão no Amazon S3, no Google Cloud Storage, noutro armazenamento compatível com S3 ou numa pasta do seu servidor podem ser movidos para um bucket — de uma só vez ou aos poucos, sem interrupções. Consulte Mover ficheiros para o armazenamento de objetos.

Eliminar um bucket

Eliminar o bucket apaga todos os ficheiros que contém; não podem ser restaurados, e as respetivas variáveis saem do projeto. A eliminação de um bucket está disponível para o titular da conta e para os Administradores da aplicação.

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte