カスタムHeaders

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

カスタムHeaders

最終更新日: 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 
これにより、カスタムヘッダーを使用すると、ページのレスポンス形式を変更できることがわかります。

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

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

はい

いいえ

フィードバック

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

tencent cloud

概要

操作手順

事例

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

リクエスト

レスポンス

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

リクエスト

レスポンス