接口功能介绍
根据指定区域或指定桶查询请求各类响应码返回次数。
接口约束
无
URI
GET /v1/bucket/http/status
路径参数
无
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 | |
| data | 是 | Object | 返回数据。 | item | |
| message | 是 | String | 返回消息。 | OK |
表 item
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| 200 | 是 | Integer | 200求响应码个数。 | 123 | |
| 300 | 是 | Integer | 300求响应码个数。 | 123 | |
| 400 | 是 | Integer | 400求响应码个数。 | 123 | |
| 500 | 是 | Integer | 500求响应码个数。 | 0 | |
| 502 | 是 | Integer | 502求响应码个数。 | 0 | |
| 204 | 是 | Integer | 300求响应码个数。 | 0 | |
| 403 | 是 | Integer | 400求响应码个数。 | 0 | |
| 404 | 是 | Integer | 500求响应码个数。 | 0 | |
| 409 | 是 | Integer | 502求响应码个数。 | 0 |
请求示例
GET /v1/bucket/http/status?regionCode=0001&buckets=bt1,bt2&startTime=1683684845051&endTime=1683684845051
请求头header
无
请求体body
无
响应示例
{
"statusCode": "0",
"message": "",
"returnObj": {
"code": "0",
"message": "",
"data": {
"200": 123,
"300": 908,
"400": 34256,
"500": 78965,
"502": 43
}
}
}
状态码
| 状态码 | 描述 |
|---|---|
| 0 | 表示业务成功。 |
| 400 | 请求参数有误。 |
| 403 | 用户鉴权失败，用户无操作权限。 |
| 404 | 请求的资源不存在，输入作物的URL。 |
| 500 | 业务执行异常。 |
