獲取對象元信息
更新時間 2023-12-07 21:34:26
最近更新時間: 2023-12-07 21:34:26
分享文章
接口功能
此接口用于獲取對象的元數據信息，包括該Object的ETag、Size、LastModified信息，并且不返回該Object的內容。
接口約束
無
請求URI
HEAD /v1/{bucket}/{objectName}
路徑參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名稱。 | testBucket |
| objectName | 是 | String | 對象名稱。 | test |
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| get-metadata | 是 | String | 固定參數。 | get-metadata |
請求參數
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| Last-Modified | String | 對象最新修改時間。 | Mon, 02 Jan 2006 15:04:05 GMT | |
| X-Amz-Storage-Class | String | 對象存儲類型。 | STANDARD | |
| x-amz-version-id | String | Object的版本ID。只有查看Object指定版本的元數據信息時才顯示該字段。 | dfafdsa21******** | |
| x-gw-object-atime | String | Object的最后一次訪問時間。時間格式為HTTP 1.1協議中規定的GMT時間。開啟訪問追蹤時，該字段的值會隨著文件被訪問的時間持續更新。注意： Object的最后一次訪問時間是異步更新的，會保證在24小時內完成Object最后一次訪問時間的更新。對于24小時內多次訪問同一個Object，僅更新該Object的最早一次訪問時間。 | Mon, 02 Jan 2006 15:04:05 GMT | |
| x-amz-bucket-owner | String | 桶的擁有者。 | test | |
| ETag | String | Object生成時會創建ETag (entity tag)，ETag用于標識一個Object的內容。 | tx00000000000000000**** |
請求示例
HEAD /v1/testbucket/test?get-metadata HTTP/1.1
請求頭header
無
請求體body
無
響應示例
HTTP/1.1 200 OK
x-amz-request-id: tx00000000000000000****
x-amz-bucket-owner: test
Date: Thu, 15 Sep 2022 08:36:33 GMT
Last-Modified: Mon, 02 Jan 2006 15:04:05 GMT
ETag："a6ba847a297266fc647c263b9xxxx"
Content-Length: 344606
Connection: keep-alive
x-amz-storage-class: STANDARD
狀態碼
| 狀態碼 | 錯誤碼 | 描述 |
|---|---|---|
| 200 | 操作成功。 | |
| 403 | AccessDenied | 用戶沒有權限執行操作。 |
| 404 | NoSuchBucket | 操作指定的桶不存在。 |
| 404 | NoSuchKey | key對應的對象不存在。 |
