接口功能介绍

查询桶统计信息
1. 传bucket参数，表示查询该桶的统计信息
2. 不传bucket参数，表示查询所有桶的统计信息，即该用户所有桶的统计信息
统计项：
 1). 每个小时累计的请求次数
 2). 每个小时累计的公网流出流量
 3). 每个小时累计的数据取回流量，仅在归档、低频存储类型时有此指标，归档的取回指归档对象解冻，低频的取回指低频对象的下载
 4). 每个小时累计的数据取回次数，仅在归档、低频存储类型时有此指标，归档的取回指归档对象解冻，低频的取回指低频对象的下载
 5). 存储容量在每个整点的值
 6). 每个小时累计的跨域复制公网流出流量
计算方法：
 1). 公网流出流量为通过公网调用GetObject接口访问、下载、预览文件或者进行图片处理操作产生的流量总值。
 2). 请求次数为读操作API、写操作API和删除操作API的总值，其中，请求次数为公网请求数加内网请求数的总值。

接口约束

支持所有一类节点资源池。仅支持最近 30 天内的统计信息查询。

URI

GET /v4/oss/get-bucket-statistics

路径参数 无

Query参数

请求参数

请求头header参数 无

请求体body参数 无

响应参数

枚举参数

无

请求示例

请求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

请求头header

无

请求体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"
                    }
                ],
                "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"
                    }
                ]
            }
        },
        "details": "",
        "message": "SUCCESS",
        "description": "成功",
        "statusCode": 800
    }
}

状态码

请参考 状态码

错误码

请参考 错误码