文件元信息是对文件的属性描述,包括HTTP标准属性(HTTP Header)和用户自定义元数据(User Meta)两种。您可以通过设置文件HTTP头来自定义HTTP请求的策略,例如文件(Object)缓存策略、强制下载策略等。您还可以通过设置用户自定义元数据来标识Object的用途或属性等。

背景信息

使用OSS管理控制台每次可批量设置100个Object的文件元信息。如需为更多Object同时设置文件元信息,请使用ossutil

操作步骤

  1. 登录OSS管理控制台
  2. 单击左侧导航栏的Bucket列表,然后单击目标Bucket。
  3. 单击左侧导航栏的文件管理
  4. 通过以下任意方式打开设置HTTP头面板。
    • 设置批量Object的HTTP头

      选中一个或多个Object,然后选择批量操作 > 设置HTTP头

    • 设置单个Object的HTTP头

      在目标Object右侧选择更多 > 设置HTTP头

  5. 设置HTTP头页面,按以下说明配置各项参数。
    参数 说明
    Content-Type 声明Object的文件类型,浏览器根据文件类型决定Object的默认打开方式。例如GIF类型的图片设置为image/gif

    不同文件类型对应的Content-Type设置,请参见如何设置Content-Type(MIME)?

    Content-Encoding 声明Object的编码方式。您需要按照Object 的实际编码类型填写,否则可能造成客户端(浏览器)解析编码失败或Object下载失败。若Object未编码,请置空此项。取值如下:
    • identity(默认值):表示Object未经过压缩或编码。
    • gzip:表示Object采用Lempel-Ziv(LZ77)压缩算法以及32位CRC校验的编码方式。
    • compress:表示Object采用Lempel-Ziv-Welch(LZW)压缩算法的编码方式。
    • deflate:表示Object采用zlib结构和deflate压缩算法的编码方式。
    • br:表示Object采用Brotli算法的编码方式。

    有关Content-Encoding的更多信息,请参见RFC2616

    注意 如果您希望访问OSS内常见网页静态文件(HTML、Javascript、XML、json)时进行Gzip压缩,您需要置空此项,并在请求中增加Accept-Encoding: gzip
    Content-Language 声明Object内容使用的语言。例如某个Object使用简体中文编写,此项可设置为zh-CN
    Content-Disposition 指定Object的访问形式。取值如下:
    • inline:直接在浏览器中打开Object。

      如需确保通过浏览器访问图片或网页文件时是预览行为,除设置Content-Disposition为inline外,您还必须使用Bucket绑定的自定义域名进行访问。有关绑定自定义域名操作,请参见绑定自定义域名

    • attachment:将Object下载到本地。例如attachment; filename="example.jpg",表示下载Object到本地并以example.jpg文件名进行保存。

    有关Content-Disposition的更多信息,请参见RFC2616

    Cache-Control 指定Object的缓存配置。取值如下:
    • no-cache:Object允许被缓存在客户端或代理服务器的浏览器中,但每次访问时需要向OSS验证缓存是否可用。缓存可用时直接访问缓存,缓存不可用时重新向OSS请求。
    • no-store:所有内容都不会被缓存。
    • public:所有内容都将被缓存。
    • private:所有内容只在客户端缓存。

    有关Cache-Control的更多信息,请参见RFC2616

    Expires 缓存内容的绝对过期时间,格式是格林威治时间(GMT)。例如2022-10-12T00:00:00.000Z。若Cache-Control设置了max-age=<seconds>,以max-age=<seconds>为准。
    用户自定义元数据 用于为Object添加描述信息。您可以添加多条自定义元数据(User Meta),但所有的自定义元数据总大小不能超过8 KB。添加自定义元数据时,要求以x-oss-meta-为前缀,并为参数赋值,例如x-oss-meta-last-modified:20200909u
  6. 单击确定