獲取對象元數據
更新時間 2024-08-20 11:16:33
最近更新時間: 2024-08-20 11:16:33
分享文章
此接口用于獲取對象的信息。
接口功能介紹
此接口用于獲取對象的信息。
接口約束
無
URI
HEAD /{bucket}/{objectName}
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱 | testBucket |
| objectName | 是 | String | 對象名稱 | test |
Query參數
無
請求參數
請求頭header參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| If-Match | 否 | String | 如果傳入期望的ETag和Object的 ETag匹配，則返回200 OK和Object Meta；否則返回412 precondition failed | 3858f6**********12c11f-9 | |
| If-None-Match | 否 | String | 如果傳入期望的ETag值和Object的ETag不匹配，則返回200 OK和Object Meta；否則返回304 Not Modified | 3858f6**********12c11f-9 | |
| If- Modified-Since | 否 | String | 如果傳入參數中的時間早于實際修改時間，則返回200 OK和Object Meta；否則返回304 not modified | Thu, 15 Sep 2022 08:36:33 GMT | |
| If-Unmodified-Since | 否 | String | 如果傳入參數中的時間等于或者晚于文件實際修改時間，則返回200 OK和Object Meta；否則返回412 precondition failed | Thu, 15 Sep 2022 08:36:33 GMT | |
| Authorization | 是 | String | 用于驗證請求合法性的認證信息 |
請求體body參數
無
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| x-amz-meta- | 是 | String | 以x-amz-meta-為前綴的參數作為用戶自定義meta header。當用戶在PostObject時設置了以x-amz-meta-為前綴的自定義meta，則響應中會包含這些自定義meta | test | |
| Last-Modified | 是 | String | 對象最新修改時間 | Thu, 15 Sep 2022 08:36:33 GMT | |
| x-amz-storage-class | 是 | String | 對象的存儲類型 | STANDARD | |
| x-rgw-object-type | 是 | String | 對象Object的類型。如果是通過PutObject上傳的Object類型為Normal，如果是appendObject上傳的，那么類型為Appendable。如果對象為軟連接，那么類型為 Symlink | Normal | |
| x-rgw-next-append-position | 是 | Integer | 對于Appendable類型的Object會返回此Header，指明下一次請求應當提供的position | 1 | |
| x-amz-next-append-position | 是 | Integer | 同x-rgw-next-append-position | 1 | |
| x-amz-version-id | 是 | String | Object的版本ID。只有查看Object指定版本的元數據信息時才顯示該字段 | 1dfasf*********** | |
| x-rgw-object-atime | 是 | String | Object的最后一次訪問時間。時間格式為HTTP 1.1協議中規定的GMT時間。開啟訪問追蹤時，該字段的值會隨著文件被訪問的時間持續更新。如果開啟后關閉了訪問追蹤，該字段的值保留為上一次最后更新的值。Object的最后一次訪問時間是異步更新的，會保證在24小時內完成Object最后一次訪問時間的更新。對于24小時內多次訪問同一個Object，僅更新該Object的最早一次訪問時間 | Thu, 15 Sep 2022 08:36:33 GMT | |
| x-amz-bucket-owner | 是 | String | 桶的擁有者 | test | |
| x-amz-tagging-count | 是 | String | 對象關聯的標簽個數。僅當用戶有讀取標簽權限時才會返回 | 2 |
請求示例
HEAD /testbucket/test HTTP/1.1
請求頭header
Authorization: authorization string
請求體body
無
響應示例
HTTP/1.1 200 OK
x-amz-request-id: tx00000000000000000****
x-rgw-object-type: Normal
x-amz-bucket-owner: test
Date: Thu, 15 Sep 2022 08:36:33 GMT
Last-Modified: Mon, 02 Jan 2006 15:04:05 GMT
Content-Length: 344606
Connection: keep-alive
x-amz-storage-class: STANDARD
狀態碼
| 狀態碼 | 錯誤碼 | 描述 |
|---|---|---|
| 200 | 操作成功 | |
| 304 | NotModified | 返回該錯誤的可能原因如下：如果指定了If-Modified-Since請求頭，但源Object在指定的時間后沒被修改過。如果指定了If-None-Match請求頭，且源Object的ETag值和您提供的ETag相等 |
| 403 | AccessDenied | 用戶沒有權限執行操作 |
| 404 | NoSuchBucket | 操作指定的桶不存在 |
| 412 | PreconditionFailed | 返回該錯誤的可能原因如下：如果指定了If-Unmodified-Since，但指定的時間早于Object實際修改時間。如果指定了If-Match，但源Object的ETag值和您提供的ETag不相等 |
錯誤碼
請參考 請求錯誤碼（原生接口）。
