接口介绍
根据指定区域或指定桶查询各类请求的次数。
接口约束
无
请求URI
GET /v1/bucket/http
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionCode | 是 | String | 区域编码。 | 0001 | |
| buckets | 否 | String | 存储桶名。1. 支持同时查询多个桶，如果请求中指定桶名查询，则返回具体存储桶各类请求的次数。2. 不指定则返回该存储区域各类请求的总数。 | buckets=bt1，bt2 | |
| startTime | 是 | Long | 查询起始时间，时间戳，ms单位。 | 1683684845051 | |
| endTime | 是 | Long | 查询结束时间，时间戳，ms单位。 | 1683684845051 |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 本次请求的结果码。 | 0 | |
| error | 是 | String | 错误码，创建成功时，不返回该字段。 | ||
| message | 是 | String | 错误文本信息，创建成功时，为空字符串。 | ||
| returnObj | 是 | String | 返回结果。 | returnObj |
表 returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | String | 业务响应码，0表示成功。 | 0 | |
| message | 是 | String | 响应信息，失败时为具体失败信息。 | ||
| data | 是 | Array of Objects | 接口返回具体数据集。 | data |
表 data
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| get | 是 | Long | get请求次数。 | 123 | |
| post | 是 | Long | post请求次数。 | 908 | |
| delete | 是 | Long | delete请求次数。 | 34256 | |
| put | 是 | Long | put请求次数。 | 78965 | |
| other | 是 | Long | 其他请求次数。 | 43 |
请求示例
GET /v1/bucket/http?regionCode=0001&buckets=bt1,bt2&startTime=1683684845051&endTime=1683684845051
请求头
无
请求体body
无
响应示例
{
"statusCode": "0",
"message": "",
"returnObj": {
"code": "0",
"message": "",
"data": {
"get": 123,
"post": 908,
"delete": 34256,
"put": 78965,
"other": 43
}
}
}
业务状态码
| 状态码 | 描述 |
|---|---|
| 0 | 表示业务成功 |
| 400 | 入参有误 |
| 403 | 用户无权操作 |
| 404 | 请求资源不存在 |
| 500 | 系统错误 |
