S3 オブジェクトのプレビュー
テキスト、JSON、CSV、gzip のログ、画像を部分的な読み取りでスマホに表示。PDF やメディアは 5 分間有効なリンクで開き、KMS キー、Glacier、拒否された読み取りにははっきりした説明を表示します。
Services → S3 でバケットとオブジェクトを開きます。Preview では、CloudConsole が必要なオブジェクトの先頭部分だけを(S3 への HTTP Range リクエストで)スマホから直接取得し、スマホ上でデコードします。CloudConsole のサーバーを経由するものは何もありません。プレビューは読み取りなので無料で、オブジェクトに対する s3:GetObject が必要です。




表示されるものと制限
| 種類 | 表示のされ方 | 読み取る最大量 |
|---|---|---|
| テキスト、ログ、コード、XML、YAML、Markdown | 選択と横スクロールができる等幅フォントのテキスト。 | 最初の 256 KB。それより大きいファイルでは、たとえば Showing the first 256 KB of 4.2 MB と表示されます。 |
| JSON(と JSON Lines) | 開閉できるツリー(CloudTrail のレコードはイベント名でラベル付け)、またはインデントした JSON の Text。ファイルが 256 KB で途切れる場合はテキストで表示されます。 | 最初の 256 KB。 |
| CSV と TSV | 横にスクロールできる表。ヘッダー行を検出し、引用符で囲んだフィールド、カンマ、改行も正しく扱います。 | 最初の 256 KB、最大 200 行。 |
Gzip(.gz、または Content-Encoding: gzip で保存):CloudTrail、ALB、CloudFront、VPC フローログ | スマホ上で展開し、テキストか JSON で表示。 | 圧縮ファイルの最初の 1 MB を、最大 2 MB まで展開。 |
| PNG、JPEG、GIF、WebP、BMP(スマホがデコードできれば HEIC も) | 画像そのもの。ピンチで拡大できます。 | 画像全体、最大 10 MB。2 MB を超える画像は Show image を押すまで待ちます。 |
| SVG | ソースをテキストで表示。Draw it で求めに応じて描画します(スクリプトや外部ファイルは使いません)。 | 最初の 256 KB。 |
| PDF、動画、音声、Office ファイル、アーカイブ | Open でスマホのビューアーやブラウザに渡します。 | アプリでは読み取りません。ビューアーがダウンロードします。 |
| それ以外 | 最初のバイトを 16 進数で表示し、そこから推測されるファイルの種類(たとえば pg_dump や Parquet のファイル)を示します。 | 512 バイト。 |
種類は、オブジェクトの Content-Type、次にファイルの拡張子、次に先頭のバイトから判断します。
Open
Open(読み取れるすべてのオブジェクトにあります)は、5 分間有効な署名付きリンクをスマホ上で作成し、システムのビューアーやブラウザに渡します。自分のためのものなので Pro のアクションではなく、記録もされません。ほかの人にファイルを渡すには Share link を使います。デモではリンクに署名はされますが、開きません。
KMS で暗号化されている場合
HeadObject がオブジェクトに SSE-KMS が使われていると示すと、画面にキーが表示され、読み取りにはそのキーに対する kms:Decrypt も必要だと案内されます。キーが原因で S3 に拒否された場合、プレビューには s3:GetObject だけでなく、キーの名前とともに Needs kms:Decrypt on the key と表示されます。Details には、キーの ARN と管理者向けの最小限のポリシーがあります。キー自身のキーポリシーでも、アカウントによる使用が許可されている必要があります。
Glacier、Deep Archive、Intelligent-Tiering のアーカイブ
アーカイブされたオブジェクトは、復元するまで読み取れません。画面には、オブジェクトがどのアーカイブにあるかと、HeadObject の復元ステータスから、復元が進行中(In progress)か、ある日付までコピーが利用できるかが表示されます。Restore(Pro のアクションで、ガードレールの設定に従います)では、速度と、Glacier ではコピーを残す日数を選べます:
- Glacier Flexible Retrieval:Expedited(通常 1〜5 分)、Standard(3〜5 時間)、Bulk(5〜12 時間)。コピーを 1、3、7、30 日間残します。
- Glacier Deep Archive:Standard(12 時間以内)または Bulk(48 時間以内)。
- Intelligent-Tiering Archive Access:Standard または Bulk。オブジェクトは Frequent Access 階層に戻るため、日数の選択はありません。
AWS は取り出しの料金を請求し、Glacier では一時的なコピーを、存在する間 Standard の料金で保存します。引っ張って更新すると、準備ができたかを確認できます。
読み取りが拒否された場合
- プレビューが拒否されると、
arn:aws:s3:::bucket/keyに対するs3:GetObjectを示し、AWS のメッセージからわかる場合は、拒否したのがロール、バケットポリシー、組織のポリシー(SCP)のどれかも示します。Details に最小限のポリシーがあります。 - オブジェクトの詳細(HeadObject)まで拒否されても、フォルダーの一覧を取得できていれば、一覧から得たサイズ、日付、ストレージクラスは画面に残り、Unavailable の行が表示されます。
- Requester Pays のバケット(読む側が支払う、ほかのアカウントのバケット):読み取りが拒否され、バケットが Requester Pays だと示している場合、アプリはそれを説明し、Read as payer をタップして同意したあとでのみ
x-amz-request-payerヘッダーを追加します。その場合、それらのリクエストとデータ転送の料金はあなたのアカウントが支払います。 - 別のリージョンにあるバケットは自動的に処理されます。
権限
| アクション | 必要になる場面 | 読み取り専用? |
|---|---|---|
s3:GetObject | オブジェクトの詳細(HeadObject)、プレビュー、Open | あり |
kms:Decrypt | KMS キーで暗号化されたオブジェクトのプレビューや Open(そのキーに対して) | あり |
s3:GetBucketRequestPayment | 拒否されたバケットが Requester Pays であることの案内(任意) | あり |
s3:RestoreObject | Restore(Pro) | いいえ(変更であり、AWS が料金を請求します) |
よくある質問
プレビューのためにアプリはファイル全体をダウンロードしますか?
いいえ。S3 に要求するのは、テキストなら最初の 256 KB、gzip ファイルなら最初の 1 MB、不明なファイルなら 512 バイトです。ファイル全体を取得するのは 10 MB までの画像だけです。
KMS で暗号化されたファイルもプレビューできますか?
はい。ロールがキーに対する kms:Decrypt を持ち、キーポリシーがアカウントを許可していればできます。そうでなければ、プレビューにキーと足りない権限が表示されます。
Restore が Pro のアクションなのはなぜですか?
オブジェクトを変更し、AWS が取り出しの料金を請求するため、ほかの変更と同じ確認、ガードレール、アクティビティログを通ります。
試したことと、アプリに表示されたメッセージを添えて[email protected]までメールでお問い合わせください。アクセスキーやシークレットは送らないでください。2営業日以内にご返信します。