接口介紹
查詢桶統計信息
- 傳bucket參數,表示查詢該桶的統計信息
- 不傳bucket參數,表示查詢所有桶的統計信息,即該用戶所有桶的統計信息
統計項:
?1). 每個小時累計的請求次數
?2). 每個小時累計的公網流出流量
?3). 每個小時累計的數據取回流量,僅在歸檔、低頻存儲類型時有此指標,歸檔的取回指歸檔對象解凍,低頻的取回指低頻對象的下載
?4). 每個小時累計的數據取回次數,僅在歸檔、低頻存儲類型時有此指標,歸檔的取回指歸檔對象解凍,低頻的取回指低頻對象的下載
?5). 存儲容量在每個整點的值
?6). 每個小時累計的跨域復制公網流出流量
計算方法:
?1). 公網流出流量為通過公網調用GetObject接口訪問、下載、預覽文件或者進行圖片處理操作產生的流量總值。
?2). 請求次數為讀操作API、寫操作API和刪除操作API的總值,其中,請求次數為公網請求數加內網請求數的總值。
接口約束
支持的線上資源池 :上海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。
僅支持最近 30 天內的統計信息查詢。
URI
GET /v4/oss/get-bucket-statistics
Content-Type
application/json
路徑參數
無
Query參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 否 | String | 存儲桶名 | bucket1 |
| regionID | 是 | String | 區域ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| startTime | 是 | String | 日期-小時 格式的時間字符串,時區為 UTC 時區 | 20230213-05 |
| endTime | 是 | String | 日期-小時 格式的時間字符串,時區為 UTC 時區 | 20230213-07 |
請求頭header參數
無
請求體body參數
無
響應參數
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| statusCode | Long | 返回狀態碼(800為成功,900為處理中/失敗) | 800 | |
| message | String | 狀態描述 | SUCCESS | |
| description | String | 狀態描述,一般為中文 | 成功 | |
| returnObj | Object | 響應對象 | returnObj | |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為 product.module.code 三段式碼 | openapi.userPermission.accessFailed | |
| error | String | 業務細分碼(大駝峰形式,僅失敗時具有此參數),為 Product.Module.Code 三段式碼 | Openapi.UserPermission.AccessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| storageTypeGlacier | Object | 歸檔存儲類型數據,若不存在此存儲類型則值為空對象 {} | storageTypeGlacier | |
| storageTypeIa | Object | 低頻存儲類型數據,若不存在此存儲類型則值為空對象 {} | storageTypeIa | |
| storageTypeStandard | Object | 標準存儲類型數據,若不存在此存儲類型則值為空對象 {} | storageTypeStandard |
表 storageTypeGlacier, storageTypeStandard, storageTypeIa
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| opsRequest | Array of Objects | 指定時間范圍內,每個小時累計的請求次數(單位:次) 比如20230213-05表示在20230213-05到20230213-06這個時段的值 |
opsRequest | |
| bytesSend | Array of Objects | 指定時間范圍內,每個小時累計的公網流出流量(單位:字節) 比如20230213-05表示在20230213-05到20230213-06這個時段的值 |
bytesSend | |
| bytesRetrive | Array of Objects | 指定時間范圍內,每個小時累計的數據取回流量(單位:字節) 比如20230213-05表示在20230213-05到20230213-06這個時段的值 僅在歸檔、低頻存儲類型有此指標 歸檔的取回指歸檔對象解凍,低頻的取回指低頻對象的下載 |
bytesRetrive | |
| opsRetrive | Array of Objects | 指定時間范圍內,每個小時累計的數據取回次數(單位:次) 比如20230213-05表示在20230213-05到20230213-06這個時段的值 僅在歸檔、低頻存儲類型有此指標 歸檔的取回指歸檔對象解凍,低頻的取回指低頻對象的下載 |
opsRetrive | |
| bytesCross | Array of Objects | 指定時間范圍內,每個小時累計的跨域復制公網流出流量(單位:字節) 比如20230322-05表示在20230213-05到20230213-06這個時段的值 |
bytesCross |
表 size, opsRequest, bytesSend, bytesRetrive, opsRetrive, bytesCross
| 參數 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|
| value | Long | 值 | 22 | |
| time | String | 日期-小時 格式的時間字符串,時區為 UTC 時區 | 20230213-05 |
枚舉參數
無
請求頭header示例
無
請求url示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/get-bucket-statistics?regionID=332232eb-63aa-465e-9028-52e5123866f0&bucket=bucket1&startTime=20231116-07&endTime=20231116-09
請求體body示例
無
響應示例
{
"httpstatus":200,
"httpresult":{
"returnObj":{
"storageTypeGlacier":{
"bytesCross":[
{
"value":236,
"time":"20231116-07"
},
{
"value":236,
"time":"20231116-08"
}
],
"storageTypeIa":{
"bytesCross":[
{
"value":2581,
"time":"20231116-07"
},
{
"value":2581,
"time":"20231116-08"
}
],
"size":[
{
"value":646,
"time":"20231116-08"
},
{
"value":646,
"time":"20231116-09"
}
],
"bytesRetrive":[
{
"value":2581,
"time":"20231116-07"
},
{
"value":2581,
"time":"20231116-08"
}
],
"opsRetrive":[
{
"value":1,
"time":"20231116-07"
},
{
"value":1,
"time":"20231116-08"
}
]
},
"storageTypeStandard":{
"bytesCross":[
{
"value":2601,
"time":"20231116-07"
},
{
"value":2561,
"time":"20231116-08"
}
],
"opsRequest":[
{
"value":39,
"time":"20231116-07"
},
{
"value":5,
"time":"20231116-08"
}
],
"size":[
{
"value":646,
"time":"20231116-07"
},
{
"value":646,
"time":"20231116-08"
},
{
"value":646,
"time":"20231116-09"
}
]
}
},
"details":"",
"message":"SUCCESS",
"description":"成功",
"statusCode":800
}
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 200 | OK | OK |
| 400 | Bad Request | Bad Request |
| 500 | Internal Server Error | Internal Server Error |
錯誤碼
errorCode 枚舉值,見錯誤碼總表