接口介绍

查询桶统计信息

1. 传bucket参数，表示查询该桶的统计信息
2. 不传bucket参数，表示查询所有桶的统计信息，即该用户所有桶的统计信息

统计项：
 1). 每个小时累计的请求次数
 2). 每个小时累计的公网流出流量
 3). 每个小时累计的数据取回流量，仅在归档、低频存储类型时有此指标，归档的取回指归档对象解冻，低频的取回指低频对象的下载
 4). 每个小时累计的数据取回次数，仅在归档、低频存储类型时有此指标，归档的取回指归档对象解冻，低频的取回指低频对象的下载
 5). 存储容量在每个整点的值
 6). 每个小时累计的跨域复制公网流出流量
计算方法：
 1). 请求次数、公网流出流量为读API加写API的总值：
  读API：'list_buckets', 'list_bucket', 'stat_bucket', 'get_obj', 'get_acls', 'get_cors', 'list_bucket_multiparts', 'list_multipart'
  写API：'create_bucket', 'delete_bucket', 'put_obj', 'put_acls', 'put_cors', 'delete_cors', 'delete_obj', 'init_multipart', 'put_obj', 'complete_multipart', 'abort_multipart'
  其中，请求次数为公网请求数加内网请求数的总值。

接口约束

支持的线上资源池 ：上海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。

startTime与endTime之间时间隔建议不超过30天。

接口是否审批

否

URI

GET /v4/oss/get-bucket-statistics

Content-Type

application/json

路径参数

无

Query参数

Query参数

请求头header参数

无

请求体body参数

无

响应参数

响应参数

表 returnObj

表 storageTypeGlacier, storageTypeStandard, storageTypeIa

表 size, opsRequest, bytesSend, bytesRetrive, opsRetrive, bytesCross

枚举参数

无

请求头header示例

无

请求url示例

GET https://zos-global.ctapi.ctyun.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"
                    }
                ],
                "size":[
                    {
                        "value":646,
                        "time":"20231116-08"
                    },
                    {
                        "value":646,
                        "time":"20231116-09"
                    }
                ]
            },
            "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
    }
}

状态码

错误码

errorCode 枚举值，见错误码总表