文档 & 帮助中心
Head Object
2023-02-19 21:07:32
Head Object
拥有对象读权限的用户可以执行HEAD操作命令获取对象元数据，返回信息包含对象的元数据信息。
请求语法
HEAD /Key+ HTTP/1.1
Host: Bucket.s3-us-east-1.ossfiles.com
URI 请求参数
该请求没有URI请求参数。
| 名称 | 描述 | 类型 |
|---|---|---|
| Bucket | 存储桶名称 | 字符串 |
| Key | 对象名称 | 字符串 |
请求消息头
该请求没有请求消息头。
请求正文
该请求没有请求正文。
请求元素
该请求没有请求元素。
响应语法
该请求没有响应正文。
响应元素
该请求没有响应元素。
响应消息头
| 名称 | 描述 | 类型 |
|---|---|---|
| Bucket | 存储桶名称 | 字符串 |
| Cache-Control | 通过指定指令来实现缓存机制。 | 字符串 |
| Content-Disposition | 响应头指示回复的内容该以何种形式展示。 | 字符串 |
| Content-Encoding | 编码类型 | 字符串 |
| Content-Language | 用来说明访问者希望采用的语言或语言组合 | 字符串 |
| Content-Length | 内容字节数 | 整数型 |
| Last-Modified | 最近修改时间 | 时间 |
| Content-Type | 实体头部用于指示资源的 MIME 类型 | 字符串 |
| Expires | 响应头包含日期/时间，即在此时候之后，响应过期 | 字符串 |
| x-amz-* | 字符串 |
示例
请求示例
HEAD /deleteObject_test HTTP/1.1
Authorization: AWS4-HMAC-SHA256 Credential=2421a691b4ed625de19f6f92677b6459/20230117/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=551830e7c68afa5d4027ba46ee1ac9fb4834ae95170727238033373d6fb0718c
Content-length: 0
Host: bucket.s3-us-east-1.ossfiles.com
X-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-amz-date: 20230117T115608Z
返回示例
HTTP/1.1 200 OK
Accept-ranges: bytes
Content-length: 3
Content-type: application/octet-stream
Date: Tue, 17 Jan 2023 11:56:09 GMT
Etag: "202cb962ac59075b964b07152d234b70"
Last-modified: Tue, 17 Jan 2023 03:56:42 GMT
x-amz-id-2: 6f5ac2fa65db49408db71d44c5ebdc6c
x-amz-request-id: d8df70a58dae40dda5ca5e91948dd9df