接口介绍
此接口用于获取对象的信息。
接口约束
无
请求URI
HEAD /v1/{bucket}/{objectName}
路径参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名称 | testBucket |
| objectName | 是 | String | 对象名称 | test |
Query参数
无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| If-Match | 否 | String | 如果传入期望的ETag和Object的 ETag匹配，则返回200 OK和Object Meta；否则返回412 precondition failed。 | 3858f6**********12c11f-9 | |
| If-None-Match | 否 | String | 如果传入期望的ETag值和Object的ETag不匹配，则返回200 OK和Object Meta；否则返回304 Not Modified。 | 3858f6**********12c11f-9 | |
| If- Modified-Since | 否 | String | 如果传入参数中的时间早于实际修改时间，则返回200 OK和Object Meta；否则返回304 not modified。 | Thu, 15 Sep 2022 08:36:33 GMT | |
| If-Unmodified-Since | 否 | String | 如果传入参数中的时间等于或者晚于文件实际修改时间，则返回200 OK和Object Meta；否则返回412 precondition failed。 | Thu, 15 Sep 2022 08:36:33 GMT |
此接口涉及的其他公共请求头，例如Host、Date等的更多信息，请参见公共HTTP头。
请求体body参数
无
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| x-amz-meta- | 是 | String | 以x-amz-meta-为前缀的参数作为用户自定义meta header。当用户在PostObject时设置了以x-amz-meta-为前缀的自定义meta，则响应中会包含这些自定义meta。 | test | |
| Last-Modified | 是 | String | 对象最新修改时间。 | Thu, 15 Sep 2022 08:36:33 GMT | |
| X-Amz-Storage-Class | 是 | String | 对象的存储类型。 | STANDARD | |
| x-rgw-object-type | 是 | String | 对象Object的类型。如果是通过PutObject上传的Object类型为Normal，如果是appendObject上传的，那么类型为Appendable。如果对象为软连接，那么类型为 Symlink。 | Normal | |
| x-rgw-next-append-position | 是 | Integer | 对于Appendable类型的Object会返回此Header，指明下一次请求应当提供的position。 | 1 | |
| x-amz-next-append-position | 是 | Integer | 同x-rgw-next-append-position。 | 1 | |
| x-amz-version-id | 是 | String | Object的版本ID。只有查看Object指定版本的元数据信息时才显示该字段。 | 1dfasf*********** | |
| x-rgw-object-atime | 是 | String | Object的最后一次访问时间。时间格式为HTTP 1.1协议中规定的GMT时间。开启访问追踪时，该字段的值会随着文件被访问的时间持续更新。如果开启后关闭了访问追踪，该字段的值保留为上一次最后更新的值。Object的最后一次访问时间是异步更新的，会保证在24小时内完成Object最后一次访问时间的更新。对于24小时内多次访问同一个Object，仅更新该Object的最早一次访问时间。 | Thu, 15 Sep 2022 08:36:33 GMT | |
| x-amz-bucket-owner | 是 | String | 桶的拥有者。 | test | |
| x-amz-tagging-count | 是 | String | 对象关联的标签个数。仅当用户有读取标签权限时才会返回。 | 2 |
请求示例
HEAD /v1/testbucket/test HTTP/1.1
请求头header
Host: gdoss.xstore.ctyun.cn
Date: Wed, 28 Oct 2023 09:32:00 GMT
Authorization: authorization string
请求体body
无
响应示例
HTTP/1.1 200 OK
x-amz-request-id: tx00000000000000000****
x-rgw-object-type: Normal
x-amz-bucket-owner: test
Date: Thu, 15 Sep 2022 08:36:33 GMT
Last-Modified: Mon, 02 Jan 2006 15:04:05 GMT
Content-Length: 344606
Connection: keep-alive
X-Amz-Storage-Class: STANDARD
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 操作成功。 |
| 403 | 用户没有权限执行操作。 |
| 404 | 操作指定的桶不存在或者key对应的对象不存在。 |
