获取对象元数据

versionId

String

否

参数解释：

对象的版本号。

约束限制：

无

取值范围：

长度为32的字符串。

默认取值：

无

Origin

String

否

参数解释：

预请求指定的跨域请求Origin（通常为域名）。

约束限制：

允许多条匹配规则，以回车换行为间隔。每个匹配规则允许使用最多一个“*”通配符。

取值范围：

符合CORS协议的取值范围。

默认取值：

无

Access-Control-Request-Headers

String

否

参数解释：

实际请求可以使用的HTTP头域，可以带多个头域。

约束限制：

允许的头域可设置多个，多个头域之间换行隔开，每行最多可填写一个*符号，不支持&、:、<、空格以及中文字符。

取值范围：

符合CORS协议的取值范围。

默认取值：

无

x-obs-server-side-encryption-customer-algorithm

String

否。当使用SSE-C方式时，必选。

参数解释：

在SSE-C加密方式下使用该头域，该头域表示解密使用的算法。

示例：x-obs-server-side-encryption-customer-algorithm：AES256

约束限制：

需要和x-obs-server-side-encryption-customer-key， x-obs-server-side-encryption-customer-key-MD5一起使用。

取值范围：

AES256

默认取值：

无

x-obs-server-side-encryption-customer-key

String

否。当使用SSE-C方式时，必选。

参数解释：

在SSE-C加密方式下使用该头域，该头域表示解密使用的密钥。

示例：x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=

约束限制：

该头域由256-bit的密钥经过base64-encoded得到，需要和x-obs-server-side-encryption-customer-algorithm，x-obs-server-side-encryption-customer-key-MD5一起使用。

取值范围：

无

默认取值：

无

x-obs-server-side-encryption-customer-key-MD5

String

否。当使用SSE-C方式时，必选。

参数解释：

在SSE-C加密方式下使用该头域，该头域表示解密使用的密钥的MD5值。MD5值用于验证密钥传输过程中没有出错。

示例：x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==

约束限制：

该头域由密钥的128-bit MD5值经过base64-encoded得到，需要和x-obs-server-side-encryption-customer-algorithm，x-obs-server-side-encryption-customer-key一起使用。

取值范围：

密钥ID MD5的base64值。

默认取值：

无

x-obs-expiration

String

参数解释：

对象的详细过期信息。

约束限制：

无

取值范围：

当对象单独设置了对象lifecycle，过期时间以对象lifecycle为准，该消息头用expiry-date描述对象的详细过期信息；如果对象没有设置对象lifecycle，设置了桶级别lifecycle，过期时间以桶级别lifecycle为准，该消息头用expiry-date和rule-id两个键值对描述对象的详细过期信息；否则不显示该头域。

默认取值：

无

x-obs-website-redirect-location

String

参数解释：

当桶设置了Website配置，就可以设置对象元数据的这个属性，Website接入点返回301重定向响应，将获取这个对象的请求重定向到该属性指定的桶内另一个对象或一个外部的URL，该参数指明对象的重定向地址。

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

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

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

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

OBS将这个值从头域中取出，保存在对象的元数据“WebsiteRedirectLocation”中。

约束限制：

• 必须以“/”、“http://”或“https://”开头，长度不超过2KB。
• OBS仅支持为桶根目录下的对象设置重定向，不支持为桶中文件夹下的对象设置重定向。

默认取值：

无

x-obs-version-id

String

参数解释：

对象的版本号。如果该对象无版本号，则响应中不会出现该消息头。

约束限制：

长度为32的字符串。

取值范围：

无

默认取值：

无

Access-Control-Allow-Origin

String

参数解释：

当桶设置了CORS配置，如果请求中的Origin满足服务端的CORS配置，则在响应中包含这个Origin。

约束限制：

无

取值范围：

符合CORS协议的取值范围。

默认取值：

无

Access-Control-Allow-Headers

String

参数解释：

当桶设置了CORS配置，如果请求的headers满足服务端的CORS配置，则在响应中包含这个headers。

约束限制:

最多可填写一个“*”通配符，不支持&、:、<、空格以及中文字符。

取值范围：

符合CORS协议的取值范围。

默认取值：

无

Access-Control-Max-Age

Integer

参数解释：

桶CORS规则中的MaxAgeSeconds。MaxAgeSeconds指请求来源的客户端可以对跨域请求返回结果的缓存时间。

约束限制：

每个CORSRule可以包含至多一个MaxAgeSeconds。

取值范围：

大于等于0的整型数，单位：秒。

默认取值：

3000

Access-Control-Allow-Methods

String

参数解释：

当桶设置了CORS配置，如果请求的Access-Control-Request-Method满足服务端的CORS配置，则在响应中包含这条rule中的Methods。

取值范围：

• GET
• PUT
• HEAD
• POST
• DELETE

Access-Control-Expose-Headers

String

参数解释：

桶CORS规则中的ExposeHeader。ExposeHeader是指CORS规则允许响应中可返回的附加头域，给客户端提供额外的信息。默认情况下浏览器只能访问以下头域：Content-Length、Content-Type，如果需要访问其他头域，需要在附加头域中配置。

约束限制：

不支持*、&、:、<、空格以及中文字符。

取值范围：

无

默认取值：

无

x-obs-server-side-encryption

String

参数解释：

该头域表示服务端的加密方式。

示例：x-obs-server-side-encryption：kms

约束限制：

如果服务端加密是SSE-KMS方式，响应包含该头域。

取值范围：

• kms
• AES256

默认取值：

无

x-obs-server-side-data-encryption

String

参数解释：

如果服务端加密是SSE-KMS方式，且数据加密算法为SM4，响应包含该头域。

示例：x-obs-server-side-data-encryption：SM4

约束限制：

无

取值范围：

SM4：国密SM4算法。

默认取值：

无

x-obs-server-side-encryption-kms-key-id

String

参数描述：

当加密方式为SSE-KMS且使用指定密钥加密时，需输入密钥ID。密钥ID获取方法请参见查看密钥。

约束限制：

当您设置了x-obs-server-side-encryption头域且赋值为“kms”，即选择kms加密方式时，才能使用该头域指定加密密钥。

默认取值：

当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。

x-obs-server-side-encryption-customer-algorithm

String

参数解释：

如果服务端加密是SSE-C方式，响应包含该头域，该头域表示解密使用的算法。

示例：x-obs-server-side-encryption-customer-algorithm：AES256

约束限制：

无

取值范围：

AES256

默认取值：

无

x-obs-server-side-encryption-customer-key-MD5

String

参数解释：

如果服务端加密是SSE-C方式，响应包含该头域，该头域表示解密使用的密钥的MD5值。

示例：x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==

约束限制：

由密钥值经过MD5加密再经过Base64编码后得到，示例：4XvB3tbNTN+tIEVa0/fGaQ==

取值范围：

密钥ID MD5的base64值。

默认取值：

无

x-obs-storage-class

String

参数解释：

对象的存储类型。

约束限制：

仅当对象为非标准存储类型时，会返回此头域。

取值范围：

• WARM
• COLD
• DEEP_ARCHIVE

默认取值：

无

x-obs-restore

String

参数解释：

标识对象的恢复状态。

示例：正在恢复ongoing-request="true"；已恢复 ongoing-request="false", expiry-date="Wed, 7 Nov 2012 00:00:00 GMT"。其中expiry-date表示对象恢复后的失效时间。

约束限制：

仅当对象为归档或深度归档存储类型，并且处于正在恢复或已经恢复时，会返回此头域。

取值范围：

无

默认取值：

无

x-obs-object-type

String

参数解释：

对象的类型。

约束限制：

仅当对象为非Normal对象时，会返回此头域。

取值范围：

Appendable

默认取值：

无

x-obs-next-append-position

Integer

参数解释：

指明下一次请求应该提供的position。

约束限制：

仅当对象为Appendable对象时，会返回此头域。

取值范围：

无

默认取值：

无

x-obs-uploadId

String

参数解释：

表示对应的多段任务ID。

约束限制：

仅当对象由多段上传任务合而来时，会返回此头域。

取值范围：

无

默认取值：

无

x-obs-tagging-count

String

参数解释：

对象关联的标签个数。

示例：x-obs-tagging-count:1

约束限制：

仅当有读取标签权限时返回。

取值范围：

无

默认取值：

无

x-obs-object-lock-mode

String

参数解释：

应用于此对象的WORM模式。

示例：x-obs-object-lock-mode:COMPLIANCE

约束限制：

• 仅当对象有配置过对象级WORM保护策略或应用桶级默认WORM策略时返回该参数。
• 该用户具有GetObjectRetention权限。

取值范围：

目前仅支持COMPLIANCE，即合规模式。

默认取值：

无

x-obs-object-lock-retain-until-date

String

参数解释：

此对象的锁定过期的截止时间。

示例：x-obs-object-lock-retain-until-date:2015-07-01T04:11:15Z

约束限制：

• 格式要求为UTC时间，并符合ISO 8601标准。如：2015-07-01T04:11:15Z。
• 仅当对象有配置过对象级WORM保护策略或应用桶级默认WORM策略时返回该参数。
• 该用户具有GetObjectRetention权限。

取值范围：

设置该值时需要大于当前时间。

默认取值：

无