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

HTTP标准属性

OSS将为上传至Bucket中的每个Object保留如下HTTP标准属性。

名称 描述
Content-Type 指定Object的内容类型。内容类型决定浏览器将以什么形式、什么编码读取文件。如果没有指定内容类型,则根据文件的扩展名生成。如果文件没有扩展名,则内容类型的默认值application/octet-stream。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-Language 声明Object内容使用的语言。
Content-Disposition 指定Object的展示形式。取值如下:
  • inline:预览Object。
  • attachment:将Object下载到本地。例如attachment; filename="example.jpg",表示下载Object到本地并以example.jpg文件名进行保存。
注意 在以下情况中通过浏览器访问OSS内的Object,即使Content-Disposition取值为inline,也会直接下载Object:
  • Object为网页文件,未使用Bucket绑定的自定义域名进行访问。
  • Object为图片文件,Object所在的Bucket于2019年09月23日之后创建,且未使用Bucket绑定的自定义域名进行访问。
  • 请求的Object为浏览器不支持预览的类型。
Cache-Control 指定Object的缓存行为。取值如下:
  • no-cache:不可直接使用缓存,而是先到服务端验证Object是否已更新。如果Object已更新,表明缓存已过期,需从服务端重新下载Object;如果Object未更新,表明缓存未过期,此时将使用本地缓存。
  • no-store:所有内容都不会被缓存。
  • public:所有内容都将被缓存。
  • private:所有内容只在客户端缓存。
  • max-age=<seconds>:缓存内容的相对过期时间,单位为秒。此选项仅在HTTP 1.1中可用。
Expires 缓存内容的绝对过期时间,格式是格林威治时间(GMT)。例如2022-10-12T00:00:00.000Z。如果Cache-Control设置了max-age=<seconds>,以max-age=<seconds>为准。
Last-Modified Object的最后修改时间。
Content-Length Object的大小,单位为字节。

用户自定义元数据

您可以在上传Object时,为Object添加自定义元数据(User Meta),用于标识Object的用途或属性等。

  • 一个Object可以有多个自定义元数据,但所有的自定义元数据总大小不能超过8 KB。
  • 自定义元数据是一组键值对,元数据名称必须以x-oss-meta-开头。例如x-oss-meta-last-modified:20210506,可用于记录本地文件最后修改时间为2021年5月6日。
  • 调用GetObject或者HeadObject接口时,将在HTTP头部返回自定义元数据。

操作方式

您可以选用如下任意方式设置、获取以及修改文件元信息。

操作方式 说明
控制台 Web应用程序,直观易用。
图形化工具 ossbrowser 图形化工具,易操作。
命令行工具 ossutil 命令行工具,性能好。
Java SDK 丰富、完整的各类语言 SDK demo。
Python SDK
PHP SDK
Go SDK
C++ SDK
C SDK
.NET SDK
Node.js SDK
Android SDK