# 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.

Screenshot: Prévia JSON de app-config.json como árvore, com as visualizações Tree e Text

Screenshot: Prévia CSV: uma tabela de pedidos com a linha de cabeçalho detectada e uma nota sobre a chave do KMS

Screenshot: Prévia de uma imagem PNG com zoom de pinça

Screenshot: Um objeto criptografado com KMS que a função não consegue descriptografar: Needs kms:Decrypt on the key

## 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](https://cloudconsole.dev/pt-br/help/share-s3-file). 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](https://cloudconsole.dev/pt-br/help/free-and-pro), no seu nível de [proteções](https://cloudconsole.dev/pt-br/help/guardrails)) 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:GetObject` em `arn:aws:s3:::bucket/key` e, 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-payer` depois 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.

**Ainda com dúvidas?**

Escreva para [support@cloudconsole.dev](mailto:support@cloudconsole.dev) 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.

## Veja também

- [Compartilhar um arquivo do S3 com um link](https://cloudconsole.dev/pt-br/help/share-s3-file) – Como usar o app
- [Entenda “No permission” e outros erros de acesso](https://cloudconsole.dev/pt-br/help/access-denied) – Permissões e erros
- [Permissões recomendadas de somente leitura](https://cloudconsole.dev/pt-br/help/recommended-permissions) – Permissões e erros
- [Permissões para alterações (ações do Pro)](https://cloudconsole.dev/pt-br/help/permissions-for-changes) – Permissões e erros

[Todos os tópicos de ajuda →](https://cloudconsole.dev/pt-br/help/)

---

Source: https://cloudconsole.dev/pt-br/help/preview-s3-objects

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
