查詢請求響應碼返回情況
更新時間 2024-01-02 11:21:26
最近更新時間: 2024-01-02 11:21:26
分享文章
接口功能介紹
根據指定區域或指定桶查詢請求各類響應碼返回次數。
接口約束
無
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 | 業務執行異常。 |
