接口功能介紹

查詢桶的基礎信息和用量數據。

接口約束

支持所有一類節點資源池。

URI

GET /v4/oss/get-bucket-info

路徑參數 無

Query參數

請求參數

請求頭header參數 無

請求體body參數 無

響應參數

枚舉參數

無

請求示例

請求url

GET //zos-global.ctapi.daliqc.cn/v4/oss/get-bucket-info?regionID=332232eb-63aa-465e-9028-52e5123866f0&bucket=bucket1

請求頭header

無

請求體body

無

響應示例

{
    "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
            "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,                 //分片數量
            "tagMap":{                      //桶標簽
                "hello":"world",
                "weare":"ctyun"
            },
            "indexType": "Normal",
            "explicitPlacement": {
                "dataExtraPool": "",
                "dataPool": "",
                "indexPool": ""
            },
            "zonegroup": "34c6f6cb-fd52-4676-b7d2-0e799a644bb7",    //zone組
    }, 
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}

狀態碼

請參考

錯誤碼

請參考