全部產品
Search
文件中心

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不存在。