全部產品
Search

搜尋本產品

    Object Storage Service：GetObjectMeta

    文件中心

    Object Storage Service：GetObjectMeta

    更新時間：Oct 23, 2024

    調用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類型的時間。

    說明

    • 如果擷取的轉儲時間距離目前時間超過180天，則提前刪除冷歸檔或者深度冷歸檔Object不會產生儲存不足規定時間長度費用。如果轉儲時間距離目前時間不超過180天，則提前刪除冷歸檔或者深度冷歸檔Object會產生儲存不足規定時間長度費用。

    • 不支援通過該欄位統計Object通過生命週期規則轉儲為低頻或者Archive Storage類型的時間。判斷低頻或者Archive Storage類型是否滿足最低儲存時間長度的要求取決於Last-Modified時間。

    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時間。

    說明

    • 低頻訪問類型最低儲存時間（30天）以Object儲存在OSS的Last Modified時間開始計算。如果擷取到Object的Last-Modified時間距離目前時間超過30天，則提前刪除Object不會產生低頻儲存不足規定時間長度費用。

    • 歸檔類型最低儲存時間（60天）以Object儲存在OSS的Last Modified時間開始計算。如果擷取到Object的Last-Modified時間距離目前時間超過60天，則提前刪除Object不會產生Archive Storage不足規定時間長度費用。

    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

    此介面對應的各語言SDK如下：

    相關文檔

    關於檔案中繼資料的更多資訊，請參見管理檔案中繼資料。

    錯誤碼

    錯誤碼

    HTTP狀態代碼

    描述

    Not Found

    404

    目標Object不存在。