CloudConsole

S3 オブジェクトのプレビュー

テキスト、JSON、CSV、gzip のログ、画像を部分的な読み取りでスマホに表示。PDF やメディアは 5 分間有効なリンクで開き、KMS キー、Glacier、拒否された読み取りにははっきりした説明を表示します。

Services → S3 でバケットとオブジェクトを開きます。Preview では、CloudConsole が必要なオブジェクトの先頭部分だけを(S3 への HTTP Range リクエストで)スマホから直接取得し、スマホ上でデコードします。CloudConsole のサーバーを経由するものは何もありません。プレビューは読み取りなので無料で、オブジェクトに対する s3:GetObject が必要です。

app-config.json の JSON プレビュー。Tree と Text の表示があるツリー
JSON をツリーで表示
CSV のプレビュー:ヘッダー行を検出した注文の表と、KMS キーの注記
CSV を表で表示
ピンチで拡大できる PNG 画像のプレビュー
画像はピンチで拡大
ロールが復号できない KMS で暗号化されたオブジェクト:Needs kms:Decrypt on the key
Needs kms:Decrypt on the key

表示されるものと制限

種類表示のされ方読み取る最大量
テキスト、ログ、コード、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:DecryptKMS キーで暗号化されたオブジェクトのプレビューや Open(そのキーに対して)あり
s3:GetBucketRequestPayment拒否されたバケットが Requester Pays であることの案内(任意)あり
s3:RestoreObjectRestore(Pro)いいえ(変更であり、AWS が料金を請求します)

よくある質問

プレビューのためにアプリはファイル全体をダウンロードしますか?

いいえ。S3 に要求するのは、テキストなら最初の 256 KB、gzip ファイルなら最初の 1 MB、不明なファイルなら 512 バイトです。ファイル全体を取得するのは 10 MB までの画像だけです。

KMS で暗号化されたファイルもプレビューできますか?

はい。ロールがキーに対する kms:Decrypt を持ち、キーポリシーがアカウントを許可していればできます。そうでなければ、プレビューにキーと足りない権限が表示されます。

Restore が Pro のアクションなのはなぜですか?

オブジェクトを変更し、AWS が取り出しの料金を請求するため、ほかの変更と同じ確認、ガードレール、アクティビティログを通ります。

解決しない場合

試したことと、アプリに表示されたメッセージを添えて[email protected]までメールでお問い合わせください。アクセスキーやシークレットは送らないでください。2営業日以内にご返信します。