Head Object

2022-09-24 21:19:29

Head Object 用于获取某个 Object 的 meta 信息,不返回文件内容。

请求语法

HEAD /bucket-name/object HTTP/1.1
Host: s3-us-east-1.ossfiles.com
Date: GMT Date
Authorization: SignatureValue

响应头部

名称 描述
x-amz-meta-* 用户自定义变量,其中一个用处是:用户客户端加密时,秘钥对相关信息基于该字段返回。 类型: 字符串

细节分析

  1. 不论正常返回 200 OK 还是非正常返回,Head Object 都不返回消息体。
  2. 如果用户在 PutObject 的时候传入以 x-amz-meta- 为开头的 user meta,比如 x-amz-meta-s3cmd-attrs,返回消息时,返回这些 user meta。
  3. 如果文件不存在,返回 404 key not found。

示例

请求示例:

HEAD /test212/1.txt HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=6a19c6de088ff32ff663287eec8f3b85/20220420/us-east-1/s3/aws4_request,SignedHeaders=host;user-agent;x-amz-content-sha256;x-amz-date, Signature=480c0968fd3476a36fac71f22ec8a075e1a77e577c4484a134fb6bc7df8c8346
x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date: 20220420T090350Z
Host: s3-us-east-1.ossfiles.com

返回示例:

HTTP/1.1 200 OK
Date: Wed, 20 Apr 2022 09:03:48 GMT
Content-Type: text/plain
Content-Length: 12
Connection: keep-alive
ETag: "a2f83d96f9f0cfda99af9567f3a5c4e0"
Last-Modified: Wed, 20 Apr 2022 16:59:21 GMT
x-amz-meta-s3b-last-modified: 20220402T184749Z
x-amz-meta-sha256: 6c04ba2bd676da32897cde0308d3deb662034760212f77c8401ccb248a78698a