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

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

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

Screenshot: app-config.json の JSON プレビュー。Tree と Text の表示があるツリー

Screenshot: CSV のプレビュー：ヘッダー行を検出した注文の表と、KMS キーの注記

Screenshot: ピンチで拡大できる PNG 画像のプレビュー

Screenshot: ロールが復号できない KMS で暗号化されたオブジェクト：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](https://cloudconsole.dev/ja/help/share-s3-file) を使います。デモではリンクに署名はされますが、開きません。

## 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](https://cloudconsole.dev/ja/help/free-and-pro) のアクションで、[ガードレール](https://cloudconsole.dev/ja/help/guardrails)の設定に従います）では、速度と、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 が取り出しの料金を請求するため、ほかの変更と同じ確認、ガードレール、アクティビティログを通ります。

**解決しない場合**

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

## 関連ページ

- [S3 のファイルをリンクで共有する](https://cloudconsole.dev/ja/help/share-s3-file) – アプリを使う
- [「No permission」などのアクセスエラーを理解する](https://cloudconsole.dev/ja/help/access-denied) – 権限とエラー
- [推奨する読み取り専用の権限](https://cloudconsole.dev/ja/help/recommended-permissions) – 権限とエラー
- [変更に必要な権限（Proの操作）](https://cloudconsole.dev/ja/help/permissions-for-changes) – 権限とエラー

[すべてのヘルプトピック →](https://cloudconsole.dev/ja/help/)

---

Source: https://cloudconsole.dev/ja/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.
