此操作用于获取文件的元数据信息,而不返回数据本身。当只希望获取文件的属性信息时,可以使用此操作。
请求语法
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。 |
x-ctyun-data-location | 获取文件的数据位置。 注意 :香港节点不会返回此项。 类型:枚举。 取值:ChengDu、GuiYang、LaSa、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 |
x-amz-meta-* | 以该前缀开头的用户定义的元数据响应头。每一个都作为一组键值对存储和返回。OOS不验证或解释用户定义的元数据。 类型:字符串。 |
x-ctyun-last-access-time | Object的最后一次访问时间。 如果为Object开启了匹配最后一次访问时间的生命周期规则,会返回该响应头,否则不返回该响应头。 注意:对于一天内多次访问同一个Object(GET操作),仅记录该Object的该天最早一次访问时间。 |
请求示例
HEAD /bucketName/object HTTP/1.1
Host: oos-cn.ctyunapi.cn
Authorization: AWS a8d7da60b5ef1e3e2694:TJw428b5bxU4cTAvQstHcASwiGw=
User-Agent: oos-sdk-java/6.5.0 Windows_10/10.0 Java_HotSpot(TM)_64-Bit_Server_VM/25.241-b07
Date: Mon, 15 Nov 2021 06:39:41 GMT
Content-Type: application/octet-stream
Connection: Keep-Alive
响应示例
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