修改对象元数据-九游平台

versionid

string

否

参数解释：

对象的版本号。

约束限制：

无

取值范围：

长度为32的字符串。

默认取值：

无

x-obs-metadata-directive

string

是

参数解释：

元数据操作指示符。

约束限制：

如果您想要通过修改对象元数据的方式修改对象存储类别，x-obs-metadata-directive必须使用replace_new。

取值范围：

• replace_new：表示对于已经存在值的元数据进行替换，不存在值的元数据进行赋值，未指定的元数据保持不变（自定义头域作替换处理）。
• replace：表示使用当前请求中携带的头域完整替换，未指定的元数据（本表中除x-obs-storage-class的其它元数据）会被删除。

默认取值：

无

cache-control

string

否

参数解释：

指定对象被下载时的网页的缓存行为。

约束限制：

无

取值范围：

参见http标准头域cache-control的取值。

默认取值：

无

content-disposition

string

否

参数解释：

指定对象被下载时的名称。

约束限制：

无

取值范围：

参见http标准头域content-disposition的取值。

默认取值：

无

content-encoding

string

否

参数解释：

指定对象被下载时的内容编码格式。

约束限制：

无

取值范围：

参见http标准头域content-encoding的取值。

默认取值：

无

content-language

string

否

参数解释：

指定对象被下载时的内容语言格式。

约束限制：

无

取值范围：

参见http标准头域content-language的取值。

默认取值：

无

content-type

string

否

参数解释：

指定对象被下载时的文件类型。

约束限制：

无

取值范围：

参见http标准头域content-type的取值。

默认取值：

无

expires

string

否

参数解释：

指定对象被下载时的网页的缓存过期时间。

约束限制：

无

取值范围：

参见http标准头域expires的取值。

默认取值：

无

x-obs-website-redirect-location

string

否

参数解释：

当桶设置了website配置，可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的url。

例如，重定向请求到桶内另一对象：

x-obs-website-redirect-location:/anotherpage.html

或重定向请求到一个外部url：

x-obs-website-redirect-location:http://www.example.com/

约束限制：

必须以“/”、“http://”或“https://”开头，长度不超过2kb。

取值范围：

无

默认取值：

无

x-obs-storage-class

string

否

参数解释：

指定对象的存储类型。

示例：x-obs-storage-class: standard

约束限制：

指定对象的存储类型时请注意大小写敏感。

取值范围：

• standard
• warm
• cold
• deep_archive

默认取值：

无

x-obs-meta-*

string

否

参数解释：

对象的自定义元数据。obs支持用户使用以“x-obs-meta-”开头的消息头来加入自定义的元数据，以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回的消息头中出现。

示例：x-obs-meta-test: test metadata

约束限制：

• 所有自定义元数据大小的总和不超过8k。单个自定义元数据大小的计算方式为：每个键和值的utf-8 编码中的字节总数。
• 自定义元数据的key值不区分大小写，obs统一转为小写进行存储。value值区分大小写。
• 自定义元数据key-value对都必须符合us-ascii。如果一定要使用非ascii码或不可识别字符，需要客户端自行做编解码处理，可以采用url编码或者base64编码，服务端不会做解码处理。例如x-obs-meta-中文：中文经url编码后发送，“中文”的url编码为：中文，则响应为x-obs-meta-中文: 中文

取值范围：

无

默认取值：

无

x-obs-expires

integer

否

参数解释：

指定对象过期时间，单位是天。过期之后对象会被自动删除。

示例：x-obs-expires:3

约束限制：

设置的天数计算出的过期时间不能早于当前时间，如10天前上传的对象，不能设置小于10的值。

取值范围：

大于0的整数值。

默认取值：

无

x-obs-tagging

string

否

参数解释：

以键值对（key-value）的形式指定对象的标签信息，可同时设置多个标签。

示例：x-obs-tagging:taga=a&tagb&tagc

约束限制：

• key或value包含特殊字符以及“=”、中文字符时，需要进行url编码处理。
• 如果某项没有“=”，则看作value为空字符串。

取值范围：

无

默认取值：

无

x-obs-metadata-directive

string

参数解释：

元数据操作指示符。

取值范围：

• replace_new：表示对于已经存在值的元数据进行替换，不存在值的元数据进行赋值，未指定的元数据保持不变（自定义头域作替换处理）。
• replace：表示使用当前请求中携带的头域完整替换，未指定的元数据（本表中除x-obs-storage-class的其它元数据）会被删除。

默认取值：

无

cache-control

string

参数解释：

指定对象被下载时的网页的缓存行为。

约束限制：

如果请求携带了此头域，那么响应的消息中应该包含此消息头。

取值范围：

参见http标准头域cache-control的取值。

默认取值：

无

content-disposition

string

参数解释：

指定对象被下载时的名称。

约束限制：

如果请求携带了此头域，那么响应的消息中应该包含此消息头。

取值范围：

参见http标准头域content-disposition的取值。

默认取值：

无

content-encoding

string

参数解释：

指定对象被下载时的内容编码格式。

约束限制：

如果请求携带了此头域，那么响应的消息中应该包含此消息头。

取值范围：

参见http标准头域content-encoding的取值。

默认取值：

无

content-language

string

参数解释：

指定对象被下载时的内容语言格式。

约束限制：

如果请求携带了此头域，那么响应的消息中应该包含此消息头。

取值范围：

参见http标准头域content-language的取值。

默认取值：

无

expires

string

参数解释：

指定对象被下载时的网页的缓存过期时间。

约束限制：

如果请求携带了此头域，那么响应的消息中应该包含此消息头。

取值范围：

参见http标准头域expires的取值。

默认取值：

无

x-obs-website-redirect-location

string

参数解释：

当桶设置了website配置，可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的url。

例如，重定向请求到桶内另一对象：

x-obs-website-redirect-location:/anotherpage.html

或重定向请求到一个外部url：

x-obs-website-redirect-location:http://www.example.com/

约束限制：

• 如果请求携带了此头域，那么响应的消息中应该包含此消息头。
• 必须以“/”、“http://”或“https://”开头，长度不超过2kb。

取值范围：

无

默认取值：

无

x-obs-storage-class

string

参数解释：

指定对象的存储类型。

约束限制：

• 如果请求携带了此头域，那么响应的消息中应该包含此消息头。
• 指定对象的存储类型时请注意大小写敏感。

取值范围：

• standard
• warm
• cold
• deep_archive

默认取值：

无

x-obs-meta-*

string

参数解释：

对象的自定义元数据。obs支持用户使用以“x-obs-meta-”开头的消息头来加入自定义的元数据，以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回的消息头中出现。

约束限制：

• 如果请求携带了此头域，那么响应的消息中应该包含此消息头。
• 所有自定义元数据大小的总和不超过8k。单个自定义元数据大小的计算方式为：每个键和值的utf-8 编码中的字节总数。
• 自定义元数据的key值不区分大小写，obs统一转为小写进行存储。value值区分大小写。
• 自定义元数据key-value对都必须符合us-ascii。如果一定要使用非ascii码或不可识别字符，需要客户端自行做编解码处理，可以采用url编码或者base64编码，服务端不会做解码处理。例如x-obs-meta-中文：中文经url编码后发送，“中文”的url编码为：中文，则响应为x-obs-meta-中文: 中文

取值范围：

无

默认取值：

无

x-obs-expires

integer

参数解释：

对象过期时间，单位是天。

约束限制：

• 设置的天数计算出的过期时间不能早于当前时间，如10天前上传的对象，不能设置小于10的值。
• 如果请求携带了此头域，那么响应的消息中应该包含此消息头。

取值范围：

大于0的整数值。

默认取值：

无