Prévia de objetos do S3
Texto, JSON, CSV, logs compactados com gzip e imagens no celular a partir de uma leitura parcial; PDFs e mídias abrem por um link de 5 minutos; respostas claras para chaves do KMS, Glacier e leituras negadas.
Abra Services → S3, um bucket e um objeto. Em Preview, o CloudConsole busca só o início do objeto de que precisa (uma solicitação HTTP Range ao S3), direto do seu celular, e o decodifica no celular. Nada passa por um servidor do CloudConsole. Prévias são leituras, então são gratuitas; você precisa de s3:GetObject no objeto.




O que é mostrado, e os limites
| Tipo | Como é mostrado | O máximo que lê |
|---|---|---|
| Texto, logs, código, XML, YAML, Markdown | Texto em fonte monoespaçada que você pode selecionar e rolar para os lados. | Os primeiros 256 KB. Um arquivo maior mostra, por exemplo, Showing the first 256 KB of 4.2 MB. |
| JSON (e JSON Lines) | Uma árvore que você pode abrir e fechar (os registros do CloudTrail são rotulados pelo nome do evento), ou Text para o JSON indentado. Se o arquivo for cortado em 256 KB, ele é mostrado como texto. | Os primeiros 256 KB. |
| CSV e TSV | Uma tabela que rola para os lados, com a linha de cabeçalho detectada e campos entre aspas, vírgulas e quebras de linha tratados. | Os primeiros 256 KB, até 200 linhas. |
Gzip (.gz, ou armazenado com Content-Encoding: gzip): CloudTrail, ALB, CloudFront e VPC Flow Logs | Descompactado no celular e mostrado como texto ou JSON. | O primeiro 1 MB do arquivo compactado, descompactado para no máximo 2 MB. |
| PNG, JPEG, GIF, WebP, BMP (HEIC quando o celular consegue decodificar) | A imagem, com zoom de pinça. | A imagem inteira, até 10 MB. Imagens acima de 2 MB esperam por Show image. |
| SVG | O código-fonte como texto. Draw it desenha a imagem quando você pede (sem scripts e sem arquivos externos). | Os primeiros 256 KB. |
| PDF, vídeo, áudio, arquivos do Office, arquivos compactados | Open os entrega ao visualizador ou navegador do celular. | Nada no app: o visualizador faz o download. |
| Todo o resto | Os primeiros bytes em hexadecimal, com o tipo de arquivo que eles sugerem (por exemplo, um pg_dump ou um arquivo Parquet). | 512 bytes. |
O tipo vem do Content-Type do objeto, depois da extensão do arquivo e depois dos primeiros bytes.
Open
Open (em qualquer objeto que você possa ler) cria no celular um link pré-assinado que funciona por 5 minutos e o entrega ao visualizador ou navegador do sistema. Ele é para você, então não é uma ação Pro e não é registrado; para dar um arquivo a outra pessoa, use o Share link. Na demonstração, o link é assinado, mas não abre.
Criptografado com KMS
Quando o HeadObject informa que um objeto usa SSE-KMS, a tela mostra a chave e avisa que a leitura também precisa de kms:Decrypt nela. Se o S3 recusar por causa da chave, a prévia diz Needs kms:Decrypt on the key e nomeia a chave, não só o s3:GetObject; em Details estão o ARN da chave e uma política mínima para o seu administrador. A política da própria chave também precisa permitir que sua conta a use.
Glacier, Deep Archive e arquivamentos do Intelligent-Tiering
Objetos arquivados não podem ser lidos até serem restaurados. A tela mostra em qual arquivamento o objeto está e, pelo status de restauração do HeadObject, se há uma restauração em andamento (In progress) ou uma cópia disponível até uma data. Restore (uma ação Pro, no seu nível de proteções) permite escolher a velocidade e, no Glacier, por quantos dias manter a cópia:
- Glacier Flexible Retrieval: Expedited (normalmente 1–5 minutos), Standard (3–5 horas) ou Bulk (5–12 horas); a cópia fica por 1, 3, 7 ou 30 dias.
- Glacier Deep Archive: Standard (em até 12 horas) ou Bulk (em até 48 horas).
- Intelligent-Tiering Archive Access: Standard ou Bulk. O objeto volta para o nível Frequent Access, então não há dias a escolher.
A AWS cobra a recuperação e, no Glacier, armazena a cópia temporária na tarifa Standard enquanto ela existir. Puxe para atualizar e ver quando está pronta.
Quando uma leitura é negada
- Se a prévia for recusada, ela informa
s3:GetObjectemarn:aws:s3:::bucket/keye, quando a mensagem da AWS diz, se quem negou foi a sua função, a política do bucket ou uma política da organização (SCP). Em Details está a política mínima. - Se até os detalhes do objeto (HeadObject) forem negados, mas você pôde listar a pasta, o tamanho, a data e a classe de armazenamento da listagem continuam na tela, com uma linha Unavailable.
- Buckets Requester Pays (o bucket de outra conta em que quem lê paga): quando uma leitura é recusada e o bucket informa que é Requester Pays, o app explica isso e só adiciona o cabeçalho
x-amz-request-payerdepois que você toca em Read as payer e concorda. Sua conta passa a pagar essas solicitações e a transferência de dados. - Um bucket em outra região é tratado automaticamente.
Permissões
| Ação | Necessária para | Somente leitura? |
|---|---|---|
s3:GetObject | Detalhes do objeto (HeadObject), a prévia e Open | Sim |
kms:Decrypt | Ver a prévia ou abrir um objeto criptografado com uma chave do KMS (nessa chave) | Sim |
s3:GetBucketRequestPayment | Avisar que um bucket recusado é Requester Pays (opcional) | Sim |
s3:RestoreObject | Restore (Pro) | Não (é uma alteração, e a AWS cobra por ela) |
Perguntas frequentes
O app baixa o arquivo inteiro para mostrar a prévia?
Não. Ele pede ao S3 os primeiros 256 KB de um texto, o primeiro 1 MB de um arquivo gzip ou 512 bytes de um arquivo desconhecido. Só imagens de até 10 MB são baixadas inteiras.
Ele mostra prévias de arquivos criptografados com KMS?
Sim, se a sua função tiver kms:Decrypt na chave e a política da chave permitir a sua conta. Se não, a prévia informa a chave e a permissão que falta.
Por que Restore é uma ação Pro?
Ela altera o objeto e a AWS cobra a recuperação, então passa pela mesma confirmação, pelas mesmas proteções e pelo mesmo registro de atividades que as outras alterações.
Escreva para [email protected] contando o que você tentou e qual mensagem o app mostrou. Não envie chaves de acesso nem segredos. Respondemos em até dois dias úteis.