Introdução
Recupere uma capa sobrescrita com versões S3 e confira a imagem correta no site real.
Conclua o laboratório de S3 privado. Este ambiente novo traz um site autorizado para três capas e projects.json. Você ativa e cria versões, sem recursos ou credenciais anteriores.
Relação com certificação
| Certificação | Tarefas | Prática |
|---|---|---|
| AWS Certified Cloud Practitioner (CLF-C02) | Task 3.6 | Preservar e recuperar conteúdo com versionamento S3. |
Visão geral

Preserve uma versão correta
Nesta etapa, você ativará versões e guardará o ID da capa AURA correta.
Abra o site pelo AWS View: AURA mostra produtos de skincare. Carregue identificadores e confira o bucket:
cd /home/labex/project
source website.env
echo "$PORTFOLIO_BUCKET"
S3 Versioning guarda várias versões sob a mesma chave. A leitura normal retorna a atual; VersionId escolhe uma versão específica. Ative no bucket:
aws s3api put-bucket-versioning \
--bucket "$PORTFOLIO_BUCKET" \
--versioning-configuration Status=Enabled
A atualização não gera saída. Leia a configuração e confirme Status=Enabled:
aws s3api get-bucket-versioning --bucket "$PORTFOLIO_BUCKET"
Objetos existentes mantêm null; ativar versões não cria novos IDs retroativamente. Envie AURA novamente para criar uma versão nomeada. put-object envia --body; $(...) guarda o VersionId escolhido por --query e --output text:
--content-type image/webp identifica uma imagem WebP. Copie todo o bloco: a barra invertida final continua o comando.
ORIGINAL_VERSION=$(aws s3api put-object \
--bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
--body portfolio-assets/images/aura-brand.webp --content-type image/webp \
--query VersionId --output text)
echo "$ORIGINAL_VERSION"
O ID identifica a versão, não bucket ou chave. Mantenha Terminal aberto: ORIGINAL_VERSION será usado na etapa 3. Atualize; AURA continua correta porque o arquivo é o mesmo.

Observe a atualização errada
Nesta etapa, você enviará uma capa incorreta e verá o resultado real.
aura-draft.webp contém o disco ECHO e simula escolher o arquivo errado para AURA. A mesma chave recebe uma nova versão atual, preservando a correta anterior:
aws s3api put-object \
--bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
--body aura-draft.webp --content-type image/webp \
--query VersionId --output text
O comando mostra o VersionId do rascunho. Atualize: AURA mostra um disco com a mesma etiqueta. FORMA e ECHO mantêm suas imagens.

Confira só o histórico AURA. --query filtra a chave e seleciona VersionId e IsLatest; --output table facilita a comparação:
aws s3api list-object-versions \
--bucket "$PORTFOLIO_BUCKET" \
--query 'Versions[?Key==`"images/aura-brand.webp"`].{VersionId:VersionId,IsLatest:IsLatest}' \
--output table
Espere três linhas: null e duas versões novas. IsLatest=True marca o rascunho servido; ORIGINAL_VERSION permanece disponível. Ordem e IDs variam. A recuperação está no S3, além de manter uma cópia local.
Recupere a imagem anterior
Nesta etapa, você recuperará a versão correta e enviará seus bytes como nova capa atual.
get-object baixa o objeto. --version-id escolhe ORIGINAL_VERSION, não o rascunho; recovered-aura.webp é o arquivo local:
aws s3api get-object \
--bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
--version-id "$ORIGINAL_VERSION" recovered-aura.webp
Após baixar, a CLI mostra metadados. Confira o VersionId guardado; ainda não precisa interpretar cada checksum. Verifique depois o conteúdo.
Compare com o original correto. Sem saída de cmp e com o prompt de volta, os bytes coincidem:
cmp portfolio-assets/images/aura-brand.webp recovered-aura.webp
Baixar sozinho não altera o site. Envie o arquivo recuperado à mesma chave para criar uma nova versão atual:
aws s3api put-object \
--bucket "$PORTFOLIO_BUCKET" --key images/aura-brand.webp \
--body recovered-aura.webp --content-type image/webp \
--query VersionId --output text
Atualize: AURA volta ao skincare. FORMA, ECHO e projects.json não mudam. Leia o histórico novamente:

aws s3api list-object-versions \
--bucket "$PORTFOLIO_BUCKET" \
--query 'Versions[?Key==`"images/aura-brand.webp"`].{VersionId:VersionId,IsLatest:IsLatest}' \
--output table
Quatro versões AURA permanecem. A restaurada tem IsLatest=True; o rascunho fica no histórico, mas não é atual. O site foi recuperado sem perder as mudanças.
Resumo
Você ativou versões, guardou a correta, observou um envio errado e restaurou os bytes anteriores como versão atual. Site e histórico confirmaram a recuperação; os outros materiais não mudaram.
Referências oficiais: S3 Versioning, retrieving object versions.



