tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
对象存储
    文档
    Download PDF

    自定义 Headers

    最后更新时间：2024-05-06 09:46:09
    下载PDF

      简介

      对象的 HTTP 头部（元数据头部 ）是服务器以 HTTP 协议传送 HTML 资料到浏览器前所送出的字符串。通过修改 HTTP 头部（元数据头部），可以改变页面的响应形式，或者传达配置信息，例如修改缓存时间、修改对象的 HTTP 头部不会修改对象本身。
      说明：
      归档存储、深度归档存储类型的对象，仅支持在上传时设置自定义 Headers，不支持对已上传的对象设置自定义 Headers。

      操作步骤

      1. 登录 对象存储控制台。
      2. 在左侧导航栏中，单击存储桶列表，进入存储桶列表页面。
      3. 找到对象所在的存储桶，单击其存储桶名称，进入存储桶管理页面。
      4. 在左侧导航栏中，选择文件列表，进入文件列表页面。
      5. 找到需要自定义头部的对象，在其右侧操作栏中，单击更多 > 自定义头部进行设置。若您需要对多个对象自定义头部，可勾选多个对象，并单击上方的更多操作 > 自定义头部进行设置。
      6. 在弹出的窗口中，选择需要设置的元数据头部参数类型，输入对应的元数据值，单击确定即可。 COS 提供了以下6种对象 HTTP 头部标识供配置。头部配置说明如下：
      HTTP 头部
      说明
      示例
      Content-Type
      文件的 MIME 信息
      image/jpeg
      Cache-Control
      文件的缓存机制
      no-cache：不可直接使用缓存，而是先到服务端验证 Object 是否已更新。如果 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
      由此可见，当使用自定义头部时，可以改变页面的响应形式。
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款