調用GetObjectMeta接口獲取一個文件（Object）的元數據信息，包括該Object的ETag、Size、LastModified信息，并且不返回該Object的內容。
注意事項
如果Object類型為軟鏈接，則返回軟鏈接信息。
當Bucket未啟用版本控制時，要獲取文件的元數據信息，您必須有oss:GetObject權限。當Bucket已啟用版本控制時，要獲取文件指定版本（請求中攜帶了x-oss-version-id請求頭）的元數據信息，您必須有oss:GetObjectVersion權限。具體操作，請參見為RAM用戶授權自定義的權限策略。
版本控制
GetObjectMeta操作默認獲取Object當前版本的元數據信息。如果Object的當前版本為刪除標記，則返回404 Not Found。請求參數中指定versionId則返回指定版本Object的元數據信息。
請求語法
HEAD /ObjectName?objectMeta HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue當您在OSS ON云盒中調用該接口時，您需要將Host替換為云盒Endpoint。更多信息，請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息，請參見公共請求頭（Common Request Headers）。
響應頭
響應頭 | 類型 | 示例值 | 描述 |
Content-Length | 字符串 | 344606 | Object的文件大小，單位為字節。 |
ETag | 字符串 | 5B3C1A2E053D763E1B002CC607C5**** | Object生成時會創建ETag（entity tag），ETag用于標識一個Object的內容。 對于通過PutObject請求創建的Object，ETag值是其內容的MD5值；對于其他方式創建的Object，ETag值是基于一定計算規則生成的唯一值，但不是其內容的MD5值。ETag值可以用于檢查Object內容是否發生變化。不建議用戶使用ETag作為Object內容的MD5校驗來驗證數據完整性。 默認值：無 |
x-oss-transition-time | 字符串 | Tue, 23 Apr 2024 07:21:42 GMT | Object通過生命周期規則轉儲為冷歸檔或者深度冷歸檔存儲類型的時間。 說明
|
x-oss-last-access-time | 字符串 | Tue, 30 Mar 2021 06:07:48 GMT | Object的最后一次訪問時間。時間格式為HTTP 1.1協議中規定的GMT時間。開啟訪問跟蹤時，該字段的值會隨著文件被訪問的時間持續更新。如果開啟后關閉了訪問跟蹤，該字段的值保留為上一次最后更新的值。 重要 Object的最后一次訪問時間是異步更新的，OSS會保證在24小時內完成Object最后一次訪問時間的更新。對于24小時內多次訪問同一個Object，OSS僅更新該Object的最早一次訪問時間。 |
Last-Modified | 字符串 | Fri, 24 Feb 2012 06:07:48 GMT | Object最后一次修改時間。時間格式為HTTP 1.1協議中規定的GMT時間。 說明
|
x-oss-version-id | 字符串 | CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** | Object的版本ID。只有查看Object指定版本的元數據信息時才顯示該字段。 |
此接口還需要包含公共響應頭。更多信息，請參見公共響應頭（Common Response Headers）。
示例
未開啟版本控制
請求示例
HEAD /oss.jpg?objectMeta HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Wed, 29 Apr 2015 05:21:12 GMT Authorization: OSS qn6q**************:77Dv****************返回示例
當Bucket未開啟訪問跟蹤
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A6448**** Date: Wed, 29 Apr 2015 05:21:12 GMT ETag: "5B3C1A2E053D763E1B002CC607C5****" Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT Content-Length: 344606 Connection: keep-alive Server: AliyunOSSBucket已開啟訪問跟蹤
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A6448**** Date: Wed, 29 Apr 2015 05:21:12 GMT ETag: "5B3C1A2E053D763E1B002CC607C5****" x-oss-transition-time: Tue, 23 Apr 2024 07:21:42 GMT x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT Content-Length: 344606 Connection: keep-alive Server: AliyunOSS
已開啟版本控制
請求示例
GET /example?objectMeta&versionId=CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** HTTP/1.1 Host: versioning-test.oss-cn-hangzhou.aliyuncs.com Date: Tue, 09 Apr 2019 06:24:00 GMT Authorization: OSS qn6q**************:77Dv****************返回示例
當Bucket未開啟訪問跟蹤
HTTP/1.1 200 OK x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** x-oss-request-id: 5CAC3A80B7AEADE0170005F6 Date: Tue, 09 Apr 2019 06:24:00 GMT ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****" Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT Content-Length: 119914 Connection: keep-alive Server: AliyunOSS當Bucket已開啟訪問跟蹤
HTTP/1.1 200 OK x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** x-oss-request-id: 5CAC3A80B7AEADE0170005F6 Date: Tue, 09 Apr 2019 06:24:00 GMT ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****" x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT Content-Length: 119914 Connection: keep-alive Server: AliyunOSS
SDK
相關文檔
關于文件元數據的更多信息，請參見管理文件元數據。
錯誤碼
錯誤碼 | HTTP狀態碼 | 描述 |
Not Found | 404 | 目標Object不存在。 |