此操作用于获取文件的元数据信息,而不返回数据本身。当只希望获取文件的属性信息时,可以使用此操作。
请求语法
HEAD /ObjectName HTTP/1.1
Host: BucketName.oos-cn.ctyunapi.cn
Date: date
Authorization: SignatureValue
响应头
变量 描述 x-amz-expiration 如果文件被配置了到期时间,那么OOS返回此响应头。这个响应头包含键值对expiry-date和rule-id。rule-id的值是URL编码的。 x-amz-storage-class 数据存储类型。如果存储类型为STANDARD,不返回此项。
类型:字符串。
取值:STANDARD_IA:低频访问存储。
x-ctyun-metadata-location 文件的索引位置。
注意香港节点不会返回此项。
类型:枚举。
取值:对于对象存储网络,取值为:ChengDu、FuZhou、GuiYang、HangZhou、LaSa、LanZhou、QingDao、ShenYang、ShenZhen、WuHan、WuHu、WuLuMuQi、ZhengZhou、SH2、SuZhou;对于对象存储网络2,取值为:NeiMeng1、HangZhou1。
x-ctyun-data-location 获取文件的数据位置。
注意香港节点不会返回此项。
类型:枚举。
取值:对于对象存储网络,取值为:ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou;对于对象存储网络2,取值为:NeiMeng1、HangZhou1。
x-amz-meta-* 以该前缀开头的用户定义的元数据响应头。每一个都作为一组键值对存储和返回。OOS不验证或解释用户定义的元数据。
类型:字符串。
x-ctyun-last-access-time Object的最后一次访问时间。
如果为Object开启了匹配最后一次访问时间的生命周期规则,会返回该响应头,否则不返回该响应头。
注意对于一天内多次访问同一个Object(GET操作),仅记录该Object的该天最早一次访问时间。
请求示例
HEAD /ObjectName HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 15 Nov 2021 06:39:41 GMT
Content-Type: application/octet-stream
Connection: Keep-Alive
Authorization: SignatureValue
响应示例
HTTP/1.1 200 OK
Content-Length: 1467326
ETag: "5db44ee68a1e577907c2699c8f582107"
Last-Modified: Mon, 15 Nov 2021 06:39:39 GMT
Content-Type: application/x-java-archive
Content-MD5: XbRO5ooeV3kHwmmcj1ghBw==
x-ctyun-metadata-location: ChengDu
x-ctyun-data-location: ZhengZhou
Date: Mon, 15 Nov 2021 06:39:41 GMT
x-amz-request-id: 4ae1a5d637614e3d137f838a928a8c9251535747494b4d4f51
Server: CTYUN