Skip to main content

以下是将网页内容转换为 Markdown 格式的结果：

自定义 Headers - 对象存储（COS） - 文档中心

最近更新时间​

2024-08-23 15:08:00

简介​

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

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

配置详情​

COS 提供了 5 种对象 HTTP 头部标识供配置：

HTTP 头部说明示例
Cache-Control文件的缓存机制no-cache;max-age=200
Content-Type文件的 MIME 信息text/html
Content-DispositionMIME 协议的扩展attachment;filename="fname.ext"
Content-Language文件的语言zh-CN
Content-Encoding文件的编码格式UTF-8
x-cos-meta-[自定义内容]自定义内容自定义内容

配置步骤​

  1. 登录 COS 控制台。

  2. 在左侧导航树中，选择 【存储桶列表】，单击相应存储桶名称，进入存储桶的文件列表。

  3. 找到需要设置头部的对象（如 example.exe），单击对象右侧的 【详情】，在详情页面设置权限。

  4. 在 自定义 Headers 配置项中，单击 【添加 Header】，选择需要设置的参数类型（自定义内容需输入自定义名称），输入对应的值。单击 【保存】 即可。

    img

示例​

在 APPID 为 123456790，创建存储桶名称为 example。存储桶根目录下上传了对象 example.txt。

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

> GET /example.txt HTTP/1.1
> Host: example-1234567890.file.myqcloud.com
> Accept: */*

< HTTP/1.1 200 OK
< Content-Language: zh-CN
< Content-Type: text/plain
< Content-Disposition: attachment; filename*="UTF-8''example.txt"
< Access-Control-Allow-Origin: *
< Last-Modified: Tue, 11 Jul 2017 15:30:35 GMT

添加如下配置：

img

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

> GET /example.txt HTTP/1.1
> Host: example-1234567890.file.myqcloud.com
> Accept: */*

< HTTP/1.1 200 OK
< Content-Language: zh-CN
< 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: Tue, 11 Jul 2017 15:30:35 GMT