HeadObject只返回某個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。
  • x-oss-storage-class展示Object的儲存類型：Standard，IA，Archive。
  • 如果Bucket類型為Archive，且用戶已經提交Restore請求，則回應標頭中會以x-oss-restore返回該Object的Restore狀態，分如下幾種情況：
    • 如果沒有提交Restore或者Restore已經逾時，則不返回該欄位。
    • 如果已經提交Restore，且Restore沒有時完成，則返回的x-oss-restore值為: ongoing-request=”true”。
    • 如果已經提交Restore，且Restore已經完成，則返回的x-oss-restore值為: ongoing-request=”false”, expiry-date=”Sun, 16 Apr 2017 08:12:33 GMT”。

樣本

請求樣本：

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
x-oss-storage-class: Archive
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

提交Restore請求但restore沒有完成時的請求樣本

HEAD /oss.jpg HTTP/1.1
Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
Date: Sat, 15 Apr 2017 07:32:52 GMT
Authorization: OSS e1Unnbm1rgdnpI:KKxkdNrUBu2t1kqlDh0MLbDb99I=

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 58F71A164529F18D7F000045
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-restore: ongoing-request="true"
Date: Sat, 15 Apr 2017 07:32:52 GMT
Last-Modified: Sat, 15 Apr 2017 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a39863328"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

提交Restore請求且restore已經完成時的請求樣本

HEAD /oss.jpg HTTP/1.1
Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
Date: Sat, 15 Apr 2017 09:35:51 GMT
Authorization: OSS e1Unnbm1rgdnpI:21qtGJ+ykDVmdu6O6FMJnn+WuBw=

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 58F725344529F18D7F000055
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-restore: ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT"
Date: Sat, 15 Apr 2017 09:35:51 GMT
Last-Modified: Sat, 15 Apr 2017 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a39863328"
Content-Length: 344606