獲取對象元數據
更新時間 2024-04-28 17:56:34
最近更新時間: 2024-04-28 17:56:34
分享文章
接口介紹
此接口用于獲取對象的信息。
接口約束
無
請求URI
HEAD /v1/{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 |
此接口涉及的其他公共請求頭，例如Host、Date等的更多信息，請參見公共HTTP頭。
請求體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 /v1/testbucket/test HTTP/1.1
請求頭header
Host: gdoss.xstore.daliqc.cn
Date: Wed, 28 Oct 2023 09:32:00 GMT
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 | 操作成功。 |
| 403 | 用戶沒有權限執行操作。 |
| 404 | 操作指定的桶不存在或者key對應的對象不存在。 |
