查詢桶信息
更新時間 2025-06-11 14:55:17
最近更新時間: 2025-06-11 14:55:17
分享文章
接口介紹
查詢桶信息,桶創建后未上傳對象時查詢接口,usage字段為空。
接口約束
支持的線上資源池 :上海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/get-bucket-info
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 存儲桶名 | bucket1 |
| regionID | 是 | String | 區域ID | 332232eb-63aa-465e-9028-52e5123866f0 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見響應示例 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/get-bucket-info?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0
響應示例
{
"returnObj": {
"projectID": "0", //企業項目 ID
"cmkUUID": "wasgdfeb-63aa-465e-9028-52e5123866f0", // kms 加密 ID,若此值為 null,則表示未開啟加密
"storageType": "STANDARD", //存儲類型,可選的值為 STANDARD, STANDARD_IA, GLACIER
"AZPolicy": "single-az", //AZ策略,single-az 或 multi-az
"poolKey": "PREVIOUS", //多pool關鍵字
"bucketQuota": { //桶配額
"enabled": false, //是否開啟
"maxSize": -1, //最大容量,單位byte
"maxObjects": -1, //最大對象數
"checkOnRaw": false,
"maxSizeKb": 0 //最大容量,單位kb
},
"tenant": "",
"ctime": "2023-03-22 02:27:55.288026Z", // create time
"bucketPreviewFlag": 0, //桶是否支持文件預覽
"placementRule": "default-placement", //placement規則名
"mtime": "2023-03-22 02:27:55.387103Z", // modify time
"bucket": "bucket-20230322-1", //桶名
"owner": "6b670413-5ebf-593a-a985-76d598374df7", //所屬用戶uid
"usage": { //使用信息
"sizeKbUtilized": 140, //已使用容量,單位kb
"sizeActual": 143360, //實際使用容量,單位byte
"sizeKbActual": 140, //實際使用容量,單位kb
"sizeKb": 140, //容量,單位kb
"storageTypeIa": { //低頻用量
"sizeKbUtilized": 12, //已使用容量,單位kb
"sizeActual": 12288, //實際使用容量,單位byte
"sizeKbActual": 12, //實際使用容量,單位kb
"numObjects": 3, //對象數量
"sizeUtilized": 12288, //已使用容量,單位byte
"numMultiparts": 0, //碎片數量
"sizeKb": 12, //容量,單位kb
"size": 12288 //容量,單位byte
},
"numObjects": 33, //對象數量
"earlydelGlacierSize": 0, //提前刪除歸檔類型數據量
"storageTypeGlacier": { //歸檔用量
"sizeKbUtilized": 12, //已使用容量,單位kb
"sizeActual": 12288, //實際使用容量,單位byte
"sizeKbActual": 12, //實際使用容量,單位kb
"numObjects": 3, //對象數量
"sizeUtilized": 12288, //已使用容量,單位byte
"numMultiparts": 0, //碎片數量
"sizeKb": 12, //容量,單位kb
"size": 12288 //容量,單位byte
},
"storageTypeStandard": { //標準用量
"sizeKbUtilized": 116, //已使用容量,單位kb
"sizeActual": 118784, //實際使用容量,單位byte
"sizeKbActual": 116, //實際使用容量,單位kb
"numObjects": 27, //對象數量
"sizeUtilized": 118784, //已使用容量,單位byte
"numMultiparts": 0, //碎片數量
"sizeKb": 116, //容量,單位kb
"size": 118784 //容量,單位byte
},
"numMultiparts": 0, //碎片數量
"earlydelIaSize": 0, //提前刪除低頻類型數據量
"sizeUtilized": 143360, //已使用容量,單位byte
"size": 143360 //容量,單位byte
},
"numShards": 0, //分片數量
"indexType": "Normal",
"loggingTargetBucket": false,
"explicitPlacement": {
"dataExtraPool": "",
"dataPool": "",
"indexPool": ""
},
"zonegroup": "34c6f6cb-fd52-4676-b7d2-0e799a644bb7", //zone組
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表