HeadObject__關於Object操作_API 參考_對象存儲 OSS-阿裏雲

Head Object隻返回某個Object的meta信息，不返回文件內容。

請求語法

HEAD /ObjectName HTTP/1.1
Host: BucketName/oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

請求Header

名稱	描述
If-Modified-Since	如果指定的時間早於實際修改時間，則返回200 OK和Object Meta；否則返回304 not modified 類型：字符串默認值：無
If-Unmodified-Since	如果傳入參數中的時間等於或者晚於文件實際修改時間，則返回200 OK和Object Meta；否則返回412 precondition failed錯誤類型：字符串默認值：無
If-Match	如果傳入期望的ETag和object的 ETag匹配，則返回200 OK和Object Meta；否則返回412 precondition failed錯誤類型：字符串默認值：無
If-None-Match	如果傳入的ETag值和Object的ETag不匹配，則返回200 OK和Object Meta；否則返回304 Not Modified 類型：字符串默認值：無

細節分析

不論正常返回200 OK還是非正常返回，Head Object都不返回消息體。
HeadObject支持在頭中設定If-Modified-Since, If-Unmodified-Since, If-Match，If-None-Match的查詢條件。具體規則請參見GetObject中對應的選項。如果沒有修改，返回304 Not Modified。
如果用戶在PutObject的時候傳入以x-oss-meta-為開頭的user meta，比如x-oss-meta-location，返回消息時，返回這些user meta。
如果文件不存在返回404 Not Found錯誤。
若該Object為進行服務器端熵編碼加密存儲的，則在Head請求響應頭中，會返回x-oss-server-side-encryption，其值表明該Object的服務器端加密算法。
如果文件類型為符號鏈接，響應頭中Content-Length、ETag、Content-Md5 均為目標文件的元信息；Last-Modified是目標文件和符號鏈接的最大值；其他均為符號鏈接元信息。
如果文件類型為符號鏈接，並且目標文件不存在，返回404 Not Found錯誤。錯誤碼：SymlinkTargetNotExist。
如果文件類型為符號鏈接，並且目標文件類型是符號鏈接，返回400 Bad request錯誤。錯誤碼：InvalidTargetType。

示例

請求示例：

HEAD /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 24 Feb 2012 07:32:52 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:JbzF2LxZUtanlJ5dLA092wpDC/E=

返回示例：

HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
x-oss-object-type: Normal
Date: Fri, 24 Feb 2012 07:32:52 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a39863328"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

最後更新：2016-11-23 17:16:08

HeadObject__關於Object操作_API 參考_對象存儲 OSS-阿裏雲

請求語法

請求Header

細節分析

示例

上一篇： DeleteMultipleObjects__關於Object操作_API 參考_對象存儲 OSS-阿裏雲

下一篇： GetObjectMeta__關於Object操作_API 參考_對象存儲 OSS-阿裏雲

相關內容

熱門內容

最新內容