HeadObject
更新时间 2026-04-10 20:11:10
最近更新时间: 2026-04-10 20:11:10
功能说明
HeadObject请求获取指定的对象的元数据信息。
请求消息样式
HEAD /{Bucket}/{Key}?versionId=VersionId HTTP/1.1
Host: xxx.zos.ctyun.cn
X-Amz-Content-Sha256: Content-SHA256
X-Amz-Date: Date
Authorization: Auth String
If-Match: Etag
If-Modified-Since: Date
If-None-Match: Etag
If-Unmodified-Since: Date请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： Bucket的名称。 | String | 是 |
| Key | 参数解释： 对象的Key。 | String | 是 |
| versionId | 参数解释： 对象的版本号。 | String | 否 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。可以带附加消息头，附加请求消息头如下表所示：
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| If-Match | 参数解释： 仅当对象的Etag和提供的Etag匹配时返回元数据，否则返回412。 | String | 否 |
| If-Modified-Since | 参数解释： 仅当对象在提供的时间后修改过时返回元数据，否则返回304。 | Date | 否 |
| If-None-Match | 参数解释： 仅当对象的Etag和提供的Etag不匹配时返回元数据，否则返回304。 | String | 否 |
| If-Unmodified-Since | 参数解释： 仅当对象在提供的时间后未修改过时返回元数据，否则返回412。 | Date | 否 |
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-delete-marker: DeleteMarker
x-amz-expiration: Expiration
Last-Modified: LastModified
Content-Length: ContentLength
ETag: ETag
x-amz-version-id: VersionId
x-amz-website-redirect-location: WebsiteRedirectLocation
x-amz-storage-class: StorageClass
x-amz-tagging-count: TagCount
x-amz-object-lock-mode: ObjectLockMode
x-amz-object-lock-retain-until-date: ObjectLockRetainUntilDate
x-amz-object-lock-legal-hold: ObjectLockLegalHoldStatus
x-amz-metadata-*: Metadata响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。 除公共响应消息头之外，还可能返回如下的消息头：
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| x-amz-delete-marker | 参数解释： 指明对象是否是DeleteMarker。 | String |
| x-amz-expiration | 参数解释： 对象的过期时间。如果配置了对象过期（请参阅 PUT Bucket Lifecycle），则响应包含此标头。它包括提供对象过期信息的过期日期和规则ID键值对。 | String |
| Content-Length | 参数解释： Body的长度。 | Long |
| ETag | 参数解释： 对象的Etag。 | String |
| x-amz-version-id | 参数解释： 对象的VersionId。 | String |
| x-amz-website-redirect-location | 参数解释： 如果开启了website配置，重定向到指定的URL。 | String |
| x-amz-storage-class | 参数解释： 对象的存储级别。 | String |
| x-amz-tagging-count | 参数解释： 对象的tag数。 | Long |
| x-amz-object-lock-mode | 参数解释： 对象的Lock模式。 | String |
| x-amz-object-lock-retain-until-date | 参数解释： 对象Lock到期的时间。 | Date |
| x-amz-object-lock-legal-hold | 参数解释： 对象Legal hold是否开启。 | String |
| x-amz-metadata | 参数解释： 用户指定的元数据信息。 | String |
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。
