文件元信息是对文件的属性描述,包括HTTP标准属性(HTTP Header)和用户自定义元数据(User Meta)两种。您可以通过设置文件HTTP头来自定义HTTP请求的策略,例如文件(Object)缓存策略、强制下载策略等。您还可以通过设置用户自定义元数据来标识Object的用途或属性等。
HTTP标准属性
OSS将为上传至Bucket中的每个Object保留如下HTTP标准属性。
| 名称 | 描述 |
|---|---|
| Content-Type | 指定Object的内容类型。内容类型决定浏览器将以什么形式、什么编码读取文件。如果没有指定内容类型,则根据文件的扩展名生成。如果文件没有扩展名,则内容类型的默认值application/octet-stream。Content-Type的常见设置请参见OSS如何设置Content-Type(MIME)? |
| Content-Encoding | 声明Object的编码方式。您需要按照Object 的实际编码类型填写,否则可能造成客户端(浏览器)解析编码失败或Object下载失败。若Object未编码,请置空此项。取值如下:
|
| Content-Language | 声明Object内容使用的语言。 |
| Content-Disposition | 指定Object的展示形式。取值如下:
注意 在以下情况中通过浏览器访问OSS内的Object,即使Content-Disposition取值为inline,也会直接下载Object:
|
| Cache-Control | 指定Object的缓存行为。取值如下:
|
| 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 |