すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSS 内のファイルのプレビュー動作を設定する方法

最終更新日:Nov 09, 2025

ブラウザが OSS 内のファイルにアクセスする際にダウンロードを強制する場合、OSS、CDN、およびブラウザの設定を確認してください。

確認項目

原因

解決策

OSS

デフォルトのドメイン名またはアクセラレーションエンドポイントを使用して、特定の時刻以降に作成されたバケット内の特定の種類のファイル (Content-Type が text/html または image/jpeg のファイルなど) にアクセスすると、OSS はダウンロードヘッダー (x-oss-force-download: true および Content-Disposition: attachment) を応答に追加します。これにより、ブラウザはファイルをプレビューする代わりにダウンロードを強制します。 詳細については、「付録: 強制ダウンロードをトリガーする x-oss-ec ルール」をご参照ください。

カスタムドメイン名を使用してバケットにアタッチします。 詳細については、「デフォルトドメイン名」をご参照ください。

Content-Type の値が実際のファイルタイプと一致しません。ブラウザはファイルを正しくレンダリングできず、代わりにダウンロードを開始します。

適切な Content-Type を設定します。 詳細については、「Content-Type (MIME) の設定方法」をご参照ください。

Content-Dispositionattachment に設定されています。これにより、ブラウザはファイルをダウンロードします。

Content-Disposition を inline に設定します。 詳細については、「オブジェクトのメタデータの管理」をご参照ください。

CDN

リソースが CDN キャッシュからパージされていません。

CDN キャッシュからリソースをパージします。 詳細については、「リソースの更新とプリフェッチ」をご参照ください。

ブラウザ

ブラウザがこのファイル形式のプレビューをサポートしていません。

ブラウザの拡張機能をインストールするか、

付録: 強制ダウンロードをトリガーする x-oss-ec ルール

次の x-oss-ec ルールは、デフォルトのドメイン名またはアクセラレーションエンドポイントを使用して特定の種類のファイルにアクセスするときに、強制ダウンロードをトリガーします。

OSS のデフォルトドメイン名

次の表に、さまざまなリージョンにおける OSS のデフォルトドメイン名の有効期間とその他の情報を示します。

有効なリージョン

有効期間

影響を受けるオブジェクト

Content-Type

x-oss-ec

中国 (杭州)、中国 (上海)、中国 (青島)、中国 (北京)、中国 (張家口)、中国 (フフホト)、中国 (深圳)、中国 (成都)

2018 年 9 月 28 日 08:00 以降

指定されたリージョンで作成されたバケット

text/html

0048-00000001

中国 (南京 - ローカルリージョン - 提供終了)、中国 (福州 - ローカルリージョン - 提供終了)、中国 (武漢 - ローカルリージョン)、中国 (ウランチャブ)、中国 (河源)、中国 (広州)、米国 (シリコンバレー)、米国 (バージニア)、韓国 (ソウル)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、フィリピン (マニラ)、タイ (バンコク)、英国 (ロンドン)、アラブ首長国連邦 (ドバイ)

2019 年 9 月 25 日 12:00 以降

中国 (香港)

2019 年 11 月 25 日 14:00 以降

中国 (フフホト)

2019 年 9 月 23 日 17:00 以降

  • image/jpeg

  • image/gif

  • image/tiff

  • image/png

  • image/webp

  • image/svg+xml

  • image/bmp

  • image/x-ms-bmp

  • image/x-cmu-raster

  • image/exr

  • image/x-icon

  • image/heic

  • text/html

0048-00000100

中国 (青島)、中国 (成都)

2019 年 9 月 24 日 11:00 以降

0048-00000101

中国 (張家口)

2019 年 9 月 24 日 17:00 以降

0048-00000102

中国 (上海)、中国 (深圳)

2019 年 9 月 29 日 17:00 以降

0048-00000103

中国 (北京)

2019 年 9 月 29 日 18:00 以降

0048-00000104

中国 (杭州)

2019 年 9 月 30 日 15:00 以降

0048-00000105

すべてのリージョン

2022 年 10 月 9 日 00:00 以降

OSS を有効化したユーザー

すべて

0048-00000113

アクセラレーションエンドポイント

次の表に、さまざまなリージョンにおけるアクセラレーションエンドポイントの有効期間とその他の情報を示します。

有効なリージョン

有効期間

影響を受けるオブジェクト

Content-Type

x-oss-ec

すべてのリージョン

2020 年 12 月 31 日 00:00 以降

指定されたリージョンで転送アクセラレーションが有効になっているバケット

text/html

0048-00000002

アラブ首長国連邦 (ドバイ)

2021 年 1 月 7 日 12:00 以降

すべて

0048-00000107

マレーシア (クアラルンプール)、英国 (ロンドン)

2021 年 1 月 7 日 18:00 以降

0048-00000108

日本 (東京)、インドネシア (ジャカルタ)、ドイツ (フランクフルト)

2021 年 1 月 8 日 18:00 以降

0048-00000109

米国 (シリコンバレー)、米国 (バージニア)、シンガポール

2021 年 1 月 14 日 12:00 以降

0048-00000110

中国 (香港)

2021 年 1 月 16 日 00:00 以降

0048-00000111

SAU (リヤド - パートナーリージョン)韓国 (ソウル)、フィリピン (マニラ)、タイ (バンコク)

2023 年 2 月 1 日 00:00 以降

0048-00000112