备案 控制台 登录 注册
文档中心 > HeadObject
HeadObject

最近更新时间：2021-12-24

使用HeadObject接口可以获取到指定的Object的信息，当指定版本时，获取指定版本的Object信息。

需要拥有相应的权限，并且根据需求添加相应的字段。


请求

请求语法

HEAD /{Object}?PartNumber=PartNumber&VersionId=VersionId HTTP/1.1

Host: Bucket.region.unicloudsrv.com

If-Match: IfMatch

If-Modified-Since: IfModifiedSince

If-None-Match: IfNoneMatch

If-Unmodified-Since: IfUnmodifiedSince

Range: Range

x-amz-server-side-encryption-customer-algorithm: SSECustomerAlgorithm

x-amz-server-side-encryption-customer-key: SSECustomerKey

x-amz-server-side-encryption-customer-key-MD5: SSECustomerKeyMD5


请求参数

参数

描述

是否必填

Bucket

包含对象的存储桶的名称。

是

If-Match

仅当其实体标签（ETag）与指定的对象相同时才返回该对象，否则返回412（前提条件失败）。

否

If-Modified-Since

仅在自指定时间以来已对其进行修改的情况下，才返回该对象；否则，返回304（未修改）。

否

If-None-Match

仅当其实体标签（ETag）与指定的实体标签不同时，才返回该对象，否则返回304（未修改）。

否

If-Unmodified-Since

仅在自指定时间以来未对其进行修改的情况下才返回该对象，否则返回412（前提条件失败）。

否

Object

对象名称。

是

PartNumber

所读取对象的分片。它是介于1到10000之间的正整数，具体根据对象实际的分片数决定。

否

VersionId

当查询对象为多版本桶下对象时，可以指定版本号获取对应版本对象信息。

否

Range

下载对象的指定范围字节。

否

x-amz-server-side-encryption-customer-algorithm

指定加密对象时，需要指定相应的加密算法。

否

x-amz-server-side-encryption-customer-key

客户所提供的加密密钥，用于加密数据以进行存储。该值必须配合x-amz-server-side-encryption-customer-algorithm字段一同使用。

否

x-amz-server-side-encryption-customer-key-MD5

根据RFC 1321指定加密密钥的128位MD5摘要，使用此标头进行消息完整性检查，以确保传输加密密钥时不会出错。

否


响应

响应语法

HTTP/1.1 200

x-amz-delete-marker: DeleteMarker

accept-ranges: AcceptRanges

x-amz-expiration: Expiration

x-amz-restore: Restore

Last-Modified: LastModified

Content-Length: ContentLength

ETag: ETag

x-amz-missing-meta: MissingMeta

x-amz-version-id: VersionId

Cache-Control: CacheControl

Content-Disposition: ContentDisposition

Content-Encoding: ContentEncoding

Content-Language: ContentLanguage

Content-Type: ContentType

Expires: Expires

x-amz-website-redirect-location: WebsiteRedirectLocation

x-amz-server-side-encryption: ServerSideEncryption

x-amz-server-side-encryption-customer-algorithm: SSECustomerAlgorithm

x-amz-server-side-encryption-customer-key-MD5: SSECustomerKeyMD5

x-amz-server-side-encryption-aws-kms-key-id: SSEKMSKeyId

x-amz-storage-class: StorageClass

x-amz-request-charged: RequestCharged

x-amz-replication-status: ReplicationStatus

x-amz-mp-parts-count: PartsCount

响应参数

参数

描述

accept-ranges

指示已指定字节范围。

Cache-Control

指定请求/响应上的缓存行为。

Content-Disposition

指定对象的呈现信息。

Content-Encoding

指定对象的文件编码类型

Content-Language

指定对象的语言应用类型

Content-Length

返回体大小

Content-Type

指定对象的数据类型

ETag

ETag是Web服务器分配给URL上特定版本的资源的不透明标识符

Expires

对象的链接内容可访问的过期时间

Last-Modified

对象的最近一次修改时间

x-amz-delete-marker

是否为多版本桶的删除标记

x-amz-expiration

如果配置了对象到期时间（请参阅PUT存储桶生命周期），则响应包括此标头。它包括提供对象到期信息的到期日期和rule-id键值对。

x-amz-mp-parts-count

对象分片数

x-amz-restore

对象的解冻状态，用于归档对象。

x-amz-server-side-encryption

如使用加密算法，则包含设置的加密头及使用加密算法使用的值

x-amz-server-side-encryption-aws-kms-key-id

如果存在，则指定用于对象的对称客户管理的客户主密钥的ID

x-amz-server-side-encryption-customer-algorithm

如果请求使用客户提供的加密密钥进行服务器端加密，则响应将包括此标头，以确认所使用的加密算法。

x-amz-server-side-encryption-customer-key-MD5

如果请求使用客户提供的加密密钥进行服务器端加密，则响应将包含此标头，以提供客户提供的加密密钥的往返消息完整性验证。

x-amz-storage-class

提供对象的存储类信息。

x-amz-version-id

对象的版本

x-amz-website-redirect-location

如果将存储桶配置为网站，则将对此对象的请求重定向到同一存储桶中的另一个对象或外部URL


示例

请求示例

HEAD /testObject HTTP/1.1

Host: testBucket.region.unicloudsrv.com

Accept-Encoding: identity

Content-Length: 0

x-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

Authorization: AWS4-HMAC-SHA256 Credential=DrjUiXNcQXih3R5n/20200623/HD1-SHMY/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=700f9a85d324811f33989feadae7400002ac188496eb96e28d56d769002a74fd

x-amz-date: 20200623T064355Z

返回示例

HTTP/1.1 200 OK

Accept-Ranges: bytes

Cache-Control: no-store

Content-Length: 1985757

Content-Type: application/x-gzip

Date: Tue, 23 Jun 2020 06:43:51 GMT

Etag: "1885f1c67281d566a1fd126e19cfb25d"

Last-Modified: Mon, 22 Jun 2020 06:16:03 GMT

Md5sum:

Server: Caddy

Vary: Origin

X-Amz-Meta-S3cmd-Attrs: atime:1592791528/ctime:1588932574/gid:0/gname:root/md5:1885f1c67281d566a1fd126e19cfb25d/mode:33188/mtime:1584025701/uid:0/uname:root

X-Amz-Object-Type: Normal

X-Amz-Restore: ongoing-request='false'

X-Amz-Storage-Class: GLACIER

X-Amz-Version-Id: 16853937509753818668