最新情報とお知らせ

製品アップデート情報

製品のお知らせ

製品概要

機能概要

応用シナリオ

製品の優位性

基本概念

リージョンとアクセスドメイン名

仕様と制限

製品の課金

課金概要

課金方式

課金項目

無料利用枠

記帳例

請求書の確認とダウンロード

お支払い遅れについて

よくある質問

クイックスタート

コンソールクイックスタート

COSBrowserクイックスタート

ユーザーガイド

リクエストの作成

バケット

オブジェクト

データ管理

バッチ処理

グローバルアクセラレーション

監視とアラーム

運用管理センター

データ処理

インテリジェントツールボックス使用ガイド

データワークフロー

アプリ統合

ツールガイド

ツール概要

環境のインストールと設定

COSBrowserツール

COSCLIツール

COSCMDツール

COS Migrationツール

FTP Serverツール

Hadoopツール

COSDistCpツール

HDFS TO COSツール

オンラインツール (Onrain Tsūru)

セルフ診断ツール

実践チュートリアル

概要

アクセス制御と権限管理

パフォーマンスの最適化

AWS S3 SDKを使用したCOSアクセス

データディザスタリカバリバックアップ

ドメイン名管理の実践

画像処理の実践

COSオーディオビデオプレーヤーの実践

データセキュリティ

データ検証

COSコスト最適化ソリューション

サードパーティアプリケーションでのCOSの使用

移行ガイド

サードパーティクラウドストレージのデータをCOSへ移行

データレークストレージ

クラウドネイティブデータレイク

メタデータアクセラレーション

データアクセラレーター GooseFS

データ処理

データ処理概要

画像処理

メディア処理

コンテンツ審査

ファイル処理

ドキュメントプレビュー

トラブルシューティング

RequestId取得の操作ガイド

パブリックネットワーク経由でのCOSへのファイルアップロード速度の遅さ

COSへのアクセス時に403エラーコードが返される

リソースアクセス異常

POST Objectの一般的な異常

セキュリティとコンプライアンス

データ災害復帰

データセキュリティ

クラウドアクセスマネジメント

よくある質問

よくあるご質問

一般的な問題

従量課金に関するご質問

ドメインコンプライアンスに関するご質問

バケット設定に関する質問

ドメイン名とCDNに関するご質問

ファイル操作に関するご質問

権限管理に関するご質問

データ処理に関するご質問

データセキュリティに関するご質問

署名付きURLに関するご質問

SDKクラスに関するご質問

ツール類に関するご質問

APIクラスに関するご質問

Agreements

Service Level Agreement

プライバシーポリシー

データ処理とセキュリティ契約

連絡先

用語集

カスタムHeaders

PDF

フォーカスモード

フォントサイズ

最終更新日: 2025-11-18 16:52:54

概要
オブジェクトのHTTPヘッダー(メタデータヘッダー)は、HTTPプロトコルでHTML資料をブラウザに渡す前にサーバーによって送信する文字列です。HTTPヘッダー(メタデータヘッダー)を変更することで、ページのレスポンス形式を変更したり、キャッシュ時間の変更などの設定情報を伝達したりすることもできます。オブジェクトのHTTPヘッダーを変更しても、オブジェクト自体は変更されません。
説明：
 アーカイブストレージ（ARCHIVE）およびディープアーカイブストレージ（DEEP ARCHIVE）タイプのオブジェクトは、アップロード時にカスタム Headers を設定することのみがサポートされており、既にアップロードされたオブジェクトにカスタム Headers を設定することはサポートされていません。
操作手順
1. ﻿COSコンソールにログインします。
2. 左側ナビゲーションバーでバケットリストをクリックし、バケットリストページに進みます。
3. オブジェクトがあるバケットを見つけ、そのバケット名をクリックし、バケット管理ページに進みます。
4. 左側ナビゲーションバーでファイルリストを選択し、ファイルリストページに進みます。
カスタムヘッダーを必要とするオブジェクトを見つけ、その右側のアクションバーで、その他 > カスタムヘッダークリックして設定してください。複数のオブジェクトに対してヘッダーをカスタマイズする必要がある場合は、複数のオブジェクトを選択し、その上のその他の操作 > カスタムヘッダーをクリックして設定してください。
5. ポップアップしたウィンドウで、設定するメタデータヘッダーパラメータタイプを選択し、対応するメタデータ値を入力し、OKをクリックします。
COSは、次の6種類のオブジェクトHTTPヘッダー識別子の設定を提供しています。ヘッダーの設定に関する説明は、次のとおりです。
HTTP ヘッダー
説明
例
Content-Type
ファイルの MIME 情報
image/jpeg
Cache-Control
ファイルのキャッシュメカニズム
no-cache：キャッシュを直接使わず、まずサーバーにアクセスして Object が更新されているかどうかを確認します。Object が更新されている場合は、キャッシュの有効期限が切れているため、サーバーから Object を再ダウンロードする必要があります。オブジェクトが更新されていない場合は、キャッシュの有効期限が切れていないため、ローカルキャッシュが使用されます。
max-age=200：キャッシュされたコンテンツの相対的な有効期限であり、単位は秒です。
Content-Disposition
MIME プロトコルの拡張
inline：ファイルの内容を直接プレビューします。
attachment：オリジナルのファイル名でブラウザが指定したパスにダウンロードします。
attachment; filename="FileName"：カスタマイズしたファイル名でブラウザが指定したパスにダウンロードします。FileName は、example.jpg など、ダウンロード後のファイル名をカスタマイズするために使用されます。添付ファイル名が中国語の場合、URL エンコーディングが必要です。例としてattachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.txt
Content-Encoding
ファイルのエンコードディング形式
gzip
注意：Header のContent-Encoding を gzip に変更しましたが、ファイル自体があらかじめ gzip で圧縮されていないため、デコーディングにエラー発生します。
Expires
はキャッシュの失効期日を管理するために使用されます
Wed, 21 Oct 2015 07:28:00 GMT
x-cos-meta-\\[カスタムサフィックス\\]
ユーザーがカスタマイズしたコンテンツ
x-cos-meta-via: homepage
注意：ヘッダー名はマイナス記号（-）、数字、英語（a～z）のみをサポートします。大文字の英字は小文字に変換され、下線（_）を含むその他の文字はサポートされません。
事例
APPIDが1250000000で、名前がexamplebucket-1250000000のバケットを作成します。バケットのルートディレクトリに、オブジェクトexampleobject.txtをアップロードしています。
オブジェクトをカスタマイズしていない HTTP ヘッダー
オブジェクトのHTTPヘッダーがカスタマイズされていない場合、ブラウザまたはクライアントによって、ダウンロード時に取得されるオブジェクトヘッダーの例は次のとおりになります。
リクエスト
GET /exampleobject.txt HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Apr 2020 09:35:16 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1586511316;1586518516&q-key-time=1586511316;1586518516&q-header-list=date;host&q-url-param-list=&q-signature=1bd1898e241fb978df336dc68aaef4c0acae****
Connection: close
レスポンス
HTTP/1.1 200 OK
Content-Type: text/plain
Access-Control-Allow-Origin: *
Last-Modified: Fri, 10 Apr 2020 09:35:05 GMT 
オブジェクトをカスタマイズした HTTP ヘッダー
 操作手順を参照し、以下のカスタムヘッダー設定を追加してください：
パラメータ
値
Content-Type
image/jpeg
Cache-Control
no-cache
Content-Disposition
attachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.jpeg
x-cos-meta-md5
1234
リクエストが再度開始されると、ブラウザまたはクライアントによって取得されるオブジェクトヘッダーの例は、次のとおりになります。
リクエスト
GET /exampleobject.txt HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Apr 2020 09:35:16 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1586511316;1586518516&q-key-time=1586511316;1586518516&q-header-list=date;host&q-url-param-list=&q-signature=1bd1898e241fb978df336dc68aaef4c0acae****
Connection: close
レスポンス
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Type: image/jpeg
Content-Disposition: attachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.jpeg
x-cos-meta-md5: 1234
Access-Control-Allow-Origin: *
Last-Modified: Fri, 10 Apr 2020 09:35:05 GMT 
これにより、カスタムヘッダーを使用すると、ページのレスポンス形式を変更できることがわかります。

ヘルプとサポート

この記事はお役に立ちましたか？

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

tencent cloud

Cloud Object Storage

カスタムHeaders

概要

操作手順

事例

オブジェクトをカスタマイズしていない HTTP ヘッダー

リクエスト

レスポンス

オブジェクトをカスタマイズした HTTP ヘッダー

リクエスト

レスポンス

ヘルプとサポート

HTTP ヘッダー	説明	例
Content-Type	ファイルの MIME 情報	image/jpeg
Cache-Control	ファイルのキャッシュメカニズム	no-cache：キャッシュを直接使わず、まずサーバーにアクセスして Object が更新されているかどうかを確認します。Object が更新されている場合は、キャッシュの有効期限が切れているため、サーバーから Object を再ダウンロードする必要があります。オブジェクトが更新されていない場合は、キャッシュの有効期限が切れていないため、ローカルキャッシュが使用されます。 max-age=200：キャッシュされたコンテンツの相対的な有効期限であり、単位は秒です。
Content-Disposition	MIME プロトコルの拡張	inline：ファイルの内容を直接プレビューします。 attachment：オリジナルのファイル名でブラウザが指定したパスにダウンロードします。 attachment; filename="FileName"：カスタマイズしたファイル名でブラウザが指定したパスにダウンロードします。FileName は、example.jpg など、ダウンロード後のファイル名をカスタマイズするために使用されます。添付ファイル名が中国語の場合、URL エンコーディングが必要です。例として`attachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.txt`
Content-Encoding	ファイルのエンコードディング形式	gzip 注意：Header のContent-Encoding を gzip に変更しましたが、ファイル自体があらかじめ gzip で圧縮されていないため、デコーディングにエラー発生します。
Expires	はキャッシュの失効期日を管理するために使用されます	Wed, 21 Oct 2015 07:28:00 GMT
x-cos-meta-\\[カスタムサフィックス\\]	ユーザーがカスタマイズしたコンテンツ	x-cos-meta-via: homepage 注意：ヘッダー名はマイナス記号（-）、数字、英語（a～z）のみをサポートします。大文字の英字は小文字に変換され、下線（_）を含むその他の文字はサポートされません。

パラメータ	値
Content-Type	image/jpeg
Cache-Control	no-cache
Content-Disposition	attachment; filename* = UTF-8' '%E4%B8%AD%E6%96%87.jpeg
x-cos-meta-md5	1234