CloudConsole

Preview S3 objects

Text, JSON, CSV, gzipped logs and images shown on your phone from a ranged read; PDFs and media open through a 5-minute link; clear answers for KMS keys, Glacier and denied reads.

Open Services → S3, a bucket and an object. Under Preview CloudConsole fetches only the start of the object it needs (an HTTP Range request to S3), straight from your phone, and decodes it on the phone. Nothing passes through a CloudConsole server. Previews are reads, so they're free; you need s3:GetObject on the object.

JSON preview of app-config.json as a tree with Tree and Text views
JSON as a tree
CSV preview: a table of orders with the header row detected and a KMS key note
CSV as a table
PNG image preview with pinch to zoom
Images, pinch to zoom
A KMS-encrypted object the role cannot decrypt: Needs kms:Decrypt on the key
Needs kms:Decrypt on the key

What it shows, and the limits

KindHow it's shownMost it reads
Text, logs, code, XML, YAML, MarkdownMonospace text you can select and scroll sideways.The first 256 KB. A bigger file says, for example, Showing the first 256 KB of 4.2 MB.
JSON (and JSON lines)A tree you can open and close (CloudTrail records are labelled by event name), or Text for the indented JSON. If the file is cut off at 256 KB it's shown as text.The first 256 KB.
CSV and TSVA table that scrolls sideways, with the header row detected and quoted fields, commas and line breaks handled.The first 256 KB, up to 200 rows.
Gzip (.gz, or stored with Content-Encoding: gzip): CloudTrail, ALB, CloudFront and VPC Flow LogsDecompressed on the phone, then shown as text or JSON.The first 1 MB of the compressed file, decompressed to at most 2 MB.
PNG, JPEG, GIF, WebP, BMP (HEIC where your phone can decode it)The picture, with pinch to zoom.The whole image, up to 10 MB. Images over 2 MB wait for Show image.
SVGIts source as text. Draw it renders it on request (no scripts, no external files).The first 256 KB.
PDF, video, audio, Office files, archivesOpen hands them to your phone's viewer or browser.Nothing in the app: the viewer downloads it.
Anything elseThe first bytes as hex, with the file type they suggest (for example a pg_dump or Parquet file).512 bytes.

The type comes from the object's Content-Type, then its file extension, then its first bytes.

Open

Open (on every object you can read) makes a presigned link on your phone that works for 5 minutes and passes it to the system viewer or browser. It's for you, so it isn't a Pro action and isn't logged; to give a file to someone else, use Share link. In the demo the link is signed but doesn't open.

Encrypted with KMS

When HeadObject says an object uses SSE-KMS, the screen notes the key and that reading also needs kms:Decrypt on it. If S3 refuses because of the key, the preview says Needs kms:Decrypt on the key and names the key, not just s3:GetObject; Details has the key ARN and a minimal policy for your admin. The key's own key policy also has to let your account use it.

Glacier, Deep Archive and Intelligent-Tiering archives

Archived objects can't be read until they're restored. The screen says which archive the object is in and, from HeadObject's restore status, whether a restore is In progress or a copy is available until a date. Restore (a Pro action, at your guardrail level) lets you choose the speed and, for Glacier, how many days to keep the copy:

  • Glacier Flexible Retrieval: Expedited (usually 1–5 minutes), Standard (3–5 hours) or Bulk (5–12 hours); keep the copy for 1, 3, 7 or 30 days.
  • Glacier Deep Archive: Standard (within 12 hours) or Bulk (within 48 hours).
  • Intelligent-Tiering Archive Access: Standard or Bulk. The object moves back to the Frequent Access tier, so there are no days to choose.

AWS charges for the retrieval and, for Glacier, stores the temporary copy at the Standard rate while it lasts. Pull to refresh to see when it's ready.

When a read is denied

  • If the preview is refused, it names s3:GetObject on arn:aws:s3:::bucket/key and, where AWS's message says so, whether your role, the bucket policy or an organisation policy (SCP) said no. Details has the minimal policy.
  • If even the object's details (HeadObject) are denied but you could list the folder, the size, date and storage class from the listing stay on screen with an Unavailable row.
  • Requester Pays buckets (another account's bucket where the reader pays): when a read is refused and the bucket says it's Requester Pays, the app explains it and only adds the x-amz-request-payer header after you tap Read as payer and agree. Your account then pays for those requests and the data transfer.
  • A bucket in another region is handled automatically.

Permissions

ActionNeeded forRead-only?
s3:GetObjectObject details (HeadObject), the preview and OpenYes
kms:DecryptPreviewing or opening an object encrypted with a KMS key (on that key)Yes
s3:GetBucketRequestPaymentTelling you a refused bucket is Requester Pays (optional)Yes
s3:RestoreObjectRestore (Pro)No (it's a change, and AWS bills it)

Questions

Does the app download the whole file to preview it?

No. It asks S3 for the first 256 KB of text, the first 1 MB of a gzip file, or 512 bytes of an unknown file. Only images up to 10 MB are fetched whole.

Can it preview files encrypted with KMS?

Yes, if your role has kms:Decrypt on the key and the key policy allows your account. If not, the preview names the key and the missing permission.

Why is Restore a Pro action?

It changes the object and AWS bills the retrieval, so it goes through the same confirm, guardrail and activity log as other changes.

Still stuck?

Email [email protected] with what you tried and any message the app showed. Don’t send access keys or secrets. We reply within two working days.