tencent cloud

フィードバック

カスタムHeaders

最終更新日:2024-05-06 09:47:09

    概要

    オブジェクトの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
    これにより、カスタムヘッダーを使用すると、ページのレスポンス形式を変更できることがわかります。
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)