控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

自定义 Headers

最近更新时间:2022-06-07 09:10:10

简介

对象的 HTTP 头部(元数据头部 )是服务器以 HTTP 协议传送 HTML 资料到浏览器前所送出的字符串。通过修改 HTTP 头部(元数据头部),可以改变页面的响应形式,或者传达配置信息,例如修改缓存时间。修改对象的 HTTP 头部不会修改对象本身。

例如:修改了 Header 中的 Content-Encoding 为 gzip,但是文件本身没有提前用 gz 压缩过,会出现解码错误。

说明:

归档存储类型的对象不支持自定义 Headers。

操作步骤

  1. 登录 对象存储控制台
  2. 在左侧导航栏中,单击存储桶列表,进入存储桶列表页面。
  3. 找到对象所在的存储桶,单击其存储桶名称,进入存储桶管理页面。
  4. 在左侧导航栏中,选择文件列表,进入文件列表页面。
  5. 找到需要自定义头部的单个对象,在其右侧操作栏中,单击更多操作 > 自定义头部

    若您需要对多个对象自定义头部,可勾选多个对象,并单击上方的更多操作 > 自定义头部即可。
  6. 在弹出的窗口中,选择需要设置的元数据头部参数类型,输入对应的元数据值,单击确定即可。
    COS 提供了以下6种对象 HTTP 头部标识供配置。头部配置说明如下:
    HTTP 头部 说明 示例
    Content-Type 文件的 MIME 信息 image/jpeg
    Cache-Control 文件的缓存机制 no-cache;max-age=200
    Content-Disposition MIME 协议的扩展 attachment;filename="fname.ext"
    Content-Encoding 文件的编码格式 gzip
    Expires 用来控制缓存的失效日期 Wed, 21 Oct 2015 07:28:00 GMT
    x-cos-meta-[自定义后缀] 用户自定义内容 x-cos-meta-via: homepage

示例

在 APPID 为 1250000000,创建存储桶名称为 examplebucket-1250000000。存储桶根目录下上传了对象 exampleobject.txt。

未自定义对象的 HTTP 头部时,浏览器或客户端下载时得到的对象头部范例如下:

请求

GET /exampleobject 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
Content-Disposition: attachment; filename*="UTF-8''exampleobject.txt"
Access-Control-Allow-Origin: *
Last-Modified: Fri, 10 Apr 2020 09:35:05 GMT 

添加如下配置:

再次发起请求,浏览器或客户端得到的对象头部范例如下:

请求

GET /exampleobject 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*="abc.txt"
x-cos-meta-md5: 1234
Access-Control-Allow-Origin: *
Last-Modified: Fri, 10 Apr 2020 09:35:05 GMT 

目录