租户端 存储 对象存储（COS） 控制台指南

自定义 Headers

最近更新时间: 2024-06-12 15:06:00

简介

对象的 HTTP 头部（Header ）是服务器以 HTTP 协议传送 HTML 资料到浏览器前所送出的字串。通过修改 HTTP 头部（Header ），可以改变页面的响应形式，或者传达配置信息，例如修改缓存时间。修改对象的 HTTP 头部不会修改对象本身。 例如：修改了 Header 中的 Content-Encoding 为 gzip，但是文件本身没有提前用 gz 压缩过，会出现解码错误。

操作步骤

  1. 登录对象存储桶控制台。

  2. 选择左侧菜单栏【存储桶列表】，进入存储桶列表页面。

  3. 单击对象所在的存储桶，进入存储桶文件列表。

  4. 找到需要设置头部的对象，单击对象右侧的【详情】。

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

    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 文件的编码格式 UTF-8
    Expires 用来控制缓存的失效日期 Wed, 21 Oct 2015 07:28:00 GMT
    x-cos-meta-[自定义内容] 自定义内容 自定义内容
  1. 配置完成后，单击【保存】。

示例

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

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

请求

GET /exampleobject.txt HTTP/1.1
Host: examplebucket-1250000000.file.myqcloud.com
Accept: */*

响应

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

添加如下配置：

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

请求

GET /exampleobject.txt HTTP/1.1
Host: examplebucket-1250000000.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