元数据是对文件的属性描述,包括系统定义元数据(System Meta)和用户自定义元数据(User Meta)两种。您可以通过编辑元数据来管理文件的属性。
用户可以修改的系统定义元数据
注意系统定义元数据取值请按照HTTP标准进行填写。
字段 描述 Cache-Control 指定文件的缓存行为。
取值:
no-cache:不直接使用缓存,而是先去服务端验证文件是否已更新。如果文件已更新,说明本地缓存已过期,需从服务端重新下载文件;如果文件未更新,表明本地缓存未过期,此时使用本地缓存。
no-store:文件不会被缓存。
public:文件允许被任何中间者(可能是代理服务器、类似于 cdn 网络)缓存。
private:文件只能被获取它的终端缓存。它不允许任何中间者(intermediate)缓存响应的资源。
max-age=
:缓存文件的相对过期时间,单位为秒。此选项仅在HTTP 1.1中可用。 Content-Disposition 指定文件的展示形式。
取值:
Content-Disposition:inline:直接预览文件内容。
Content-Disposition:attachment:以原文件名的形式下载到浏览器指定路径。
Content-Disposition:attachment; filename="FileName":以自定义文件名的形式下载到浏览器指定路径。
FileName:用于自定义下载后的文件名称,例如example.jpg。
将文件下载到浏览器指定路径时:
如果文件名称包含星号(*)、正斜线(/)等特殊字符时,可能会出现特殊字符转义的情况。例如,下载test*.jpg"到本地时,test*.jpg"可能会转义为test .jpg"。若需确保下载名称中包含中文字符的文件到本地指定路径后,文件名称不出现乱码的现象,您需要将名称中包含的中文字符进行URL编码。例如,将“中文.txt”从OOS下载到本地后,需要保留文件名为中文.txt,需按照"attachment;filename="+URLEncoder.encode("中文","UTF-8")+".txt;filename*=UTF-8''"+URLEncoder.encode("中文","UTF-8")+".txt")的格式设置Content-Disposition,即attachment;filename=%E4%B8%AD%E6%96%87.txt;filename*=%E4%B8%AD%E6%96%87.txt。Content-Encoding 指定文件的编码方式。需要按照文件的实际编码类型填写,否则可能造成客户端(浏览器)解析编码失败或文件下载失败。若文件未编码,不增加此项。
取值:
identity:表示文件未经过压缩或编码。
gzip:表示文件采用Lempel-Ziv(LZ77)压缩算法以及32位CRC校验的编码方式。
compress:表示文件采用Lempel-Ziv-Welch(LZW)压缩算法的编码方式。
deflate:表示文件采用zlib结构和deflate压缩算法的编码方式。
br:表示文件采用Brotli算法的编码方式。
默认值为identity。
关于Content-Encoding的更多信息参见RFC2616。
Content-Type 指定文件的内容类型。
用于定义文件的类型和网页的编码。如果没有指定文件类型,则根据文件的扩展名生成。如果文件没有扩展名,则文件类型的默认值application/octet-stream。
Content-Language 声明文件内容使用的语言。例如某个文件使用简体中文编写,则此项可设置为zh-CN。
Expires 缓存内容的绝对过期时间,格式是格林威治时间(GMT)。
例如Wed, 22 Nov 2023 14:18:58 +0800。如果Cache-Control设置了max-age=
,以max-age= 为准。 x-amz-website-redirect-location 将相关联文件的请求重定向到同一存储桶中的其他文件或外部 URL。此值对于每个单独文件都是唯一的,原定设置情况下不会复制该值。更多信息请参考的POST Object。
可以修改的用户定义元数据
字段 | 描述 |
---|---|
x-amz-meta-* | 用户自定义元数据。键(key)必须为ASCII中可打印字符的部分值,不支持的字符详见下表。值(Value)为除(space)外的ISO 8859-1以内的字符。 |
用户定义元数据取值: 95个可打印字符中不可取的值
ASCII十进制 | 图形 | ASCII十进制 | 图形 |
---|---|---|---|
32 | (space) | 61 | = |
34 | " | 62 | > |
40 | ( | 63 | ? |
41 | ) | 64 | @ |
44 | , | 91 | [ |
47 | / | 92 | \ |
58 | : | 93 | ] |
59 | ; | 123 | { |
60 | < | 125 | } |
点击文件列表中的“更多”>“编辑元数据或更多操作”>“编辑元数据”,可以进行对文件的元数据进行编辑。
说明如果同时选择多个文件编辑元数据,则不会显示文件的原有元数据信息。如果文件存在已有元数据的键(key)与本次添加元数据的键(key)相同,则其值(value)会更新为最新的值,该文件其他历史元数据均会保留。
点击“添加元数据”,可以修改文件的系统定义元数据或用户定义元数据。
名称 描述 类型 元数据的类型:
系统定义
用户定义
键 具体元数据名称。
元数据为系统定义时,取值:
Cache-Control
Content-Disposition
Content-Encoding
Content-Type
Content-Language
Expires
x-amz-website-redirect-location
元数据为用户定义时,取值:x-amz-meta-*。
值 对应元数据的具体取值。 操作 点击“删除”按钮,可以删除该元数据。