調用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
要求標頭
此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(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通過生命週期規則轉儲為冷歸檔或者深度冷Archive Storage類型的時間。 說明
|
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開啟階層命名空間後通過CreateDirectory建立了目錄,則調用GetObjectMeta介面擷取目錄資訊時,ETag將返回“null”。
當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: AliyunOSS
Bucket已開啟訪問跟蹤
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不存在。 |