查詢對象是否存在
更新時間 2025-06-11 14:55:28
最近更新時間: 2025-06-11 14:55:28
分享文章
接口介紹
查詢對象是否存在。
接口約束
支持的線上資源池 ：上海7、南京3、南京5、杭州2、合肥2、九江、廣州6、武漢4、福州25、廈門3、郴州2、海口2、北京5、雄安2、石家莊20、內蒙6、晉中、遼陽1、西安5、烏魯木齊4、烏魯木齊27、中衛5、蘭州2、西寧2、拉薩3、昆明2、重慶2、成都4、貴州3、上海33、寧波邊緣云、華東1、上海36、南昌5、青島20、武漢41、長沙42、長沙37、南寧23、北京行業云20、華北2、西南1、上海32。
URI
GET /v4/oss/head-object
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| key | 是 | String | 對象名 | obj1 |
| versionID | 否 | String | 版本ID，在開啟多版本時可使用 | USzD.sN0vODAsQ84ncdT20oRiY2lFCD |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| returnObj | Object | 響應對象 | 見下級對象 |
| statusCode | Integer | 返回碼 取值范圍：800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述，一般為中文 | 成功 |
| errorCode | String | 業務細分碼（僅失敗時具有此參數），為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| deleteMarker | Boolean | 指定檢索到的對象是 (true) 還是不是 (false) 刪除標記。如果為 false，則此響應標頭不會出現在響應中 | false |
| acceptRanges | String | 表示指定了一個字節范圍 | bytes |
| expiration | String | 如果配置了對象過期（請參閱 PUT Bucket 生命周期），則響應包含此標頭。它包括提供對象過期信息的過期日期和規則 ID 鍵值對。 rule-id 的值是 URL 編碼的 | string |
| restore | String | 如果對象是存檔對象（其存儲類為 GLACIER 的對象），則如果存檔恢復正在進行（請參閱 RestoreObject 或存檔副本已恢復），則響應將包含此標頭。如果存檔副本已恢復，則標頭值指示對象存儲計劃何時刪除對象副本。 例如：x-amz-restore: concurrent-request="false", expiry-date="Fri, 21 Dec 2012 00:00:00 GMT"。如果對象恢復正在進行中，標頭返回值 concurrent-request="true" |
concurrent-request="true" |
| archiveStatus | String | head 對象的歸檔狀態。可能的值為 ARCHIVE_ACCESS,DEEP_ARCHIVE_ACCESS | DEEP_ARCHIVE_ACCESS |
| lastModified | String | 對象創建日期， ISO8601 格式字符串 | 2022-10-18T02:24:40Z |
| contentLength | Integer | 內容長度 | 3191 |
| ETag | String | ETag | 6805f2cfc46c0f04559748bb039d69ae |
| missingMeta | Integer | 這設置為 x-amz-meta 標頭中未返回的元數據條目數。如果您使用像 SOAP 這樣支持比 REST API 更靈活的元數據的 API 創建元數據，就會發生這種情況。 例如，使用 SOAP，您可以創建其值不是合法 HTTP 標頭的元數據 |
233 |
| versionID | String | 版本ID，在開啟多版本時可使用 | USzD.sN0vODAsQ84ncdT20oRiY2lFCD |
| cacheControl | String | 指定沿請求/響應鏈的緩存行為 | max-age=604800 |
| contentDisposition | String | 指定對象的表示信息 | inline |
| contentEncoding | String | 內容編碼 | gzip |
| contentLanguage | String | 內容語言 | en-US |
| contentType | String | 內容類型，枚舉值可參考HTTP content-type類型 | image/jpeg |
| expires | String | 對象不再可緩存的日期和時間。 ISO8601 格式字符串。 | 2022-10-18T02:24:40Z |
| websiteRedirectLocation | String | 網站重定向位置 | /sdf/sdf |
| serverSideEncryption | String | 服務端加密算法, AES256,aws:kms | AES256 |
| metadata | Object | 與 S3 中的對象一起存儲的元數據映射 | {"key": "value"} |
| SSECustomerAlgorithm | String | 如果請求使用客戶提供的加密密鑰進行服務器端加密，則響應將包含此參數，以確認所使用的加密算法 | AES256 |
| SSECustomerKeyMD5 | String | 如果請求使用客戶提供的加密密鑰進行服務器端加密，則響應將包含此標頭以提供往返消息的完整性驗證 | xcvubyisdebuhert |
| SSEKMSKeyID | String | SSEKMSKeyID | xcvuibshidubert |
| bucketKeyEnabled | Boolean | 指示對象是否通過服務端加密 | true |
| storageClass | String | 存儲類，可能的值有 STANDARD,REDUCED_REDUNDANCY,STANDARD_IA,ONEZONE_IA,INTELLIGENT_TIERING,GLACIER,DEEP_ARCHIVE,OUTPOSTS,GLACIER_IR | STANDARD |
| requestCharged | String | 如果存在，則表明請求者已成功為請求收費 | requester |
| replicationStatus | String | 復制狀態,如COMPLETE,PENDING,FAILED,REPLICA | COMPLETE |
| partsCount | Integer | 此對象擁有的分段數 | 32 |
| objectLockMode | String | 對象鎖定模式，GOVERNANCE,COMPLIANCE | COMPLIANCE |
| objectLockRetainUntilDate | String | 對象鎖定保留期到期的日期和時間。ISO8601 格式字符串 | 2022-10-18T02:24:40Z |
| objectLockLegalHoldStatus | String | 指定此對象的合法保留是否有效, 可能的值是 ON,OFF | ON |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/head-object?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0&key=obj1&versionID=USzD.sN0vODAsQ84ncdT20oRiY2lFCD
響應示例
{
"returnObj": {
"acceptRanges": "bytes",
"contentLength": 3191,
"contentType": "image/jpeg",
"ETag": "6805f2cfc46c0f04559748bb039d69ae",
"lastModified": "2022-10-18T02:24:40Z",
"metadata": {"key": "value"},
"versionID": "USzD.sN0vODAsQ84ncdT20oRiY2lFCD"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示對象無權訪問或不存在或請求失敗，詳情查看返回的 message 參數。 |
錯誤碼
errorCode 枚舉值，見錯誤碼總表
