接口功能介绍
展示近7天、近14天、近30天服务器总台数、未防护台数、离线台数、风险台数、防护关闭台数统计趋势，默认为近7天。总台数：包括全部服务器。未防护台数：防护状态为“未防护”的服务器。离线台数：防护状态“已离线”的服务器。风险台数：风险状态为“风险”的全部服务器。防护关闭台数：防护状态“已关闭”的服务器。
接口约束
此功能为收费功能。确认已经购买服务器配额，并且开启服务器防护。如果没有购买配额，可按照页面提示进行购买。如果没有开启防护，请在服务器列表页开启机器防护。
URI
POST /v1/index/hostTrend
路径参数
无
Query参数
无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionid | 是 | String | 资源池id | 100054c0416811e9a6690242ac110002 | |
| urlType | 是 | String | 请求地址类型。CTAPI | CTAPI | |
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| type | 否 | Integer | 1：一周前；2：两周前，3：30天前 | 2 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | String | 状态码 200-成功 | ||
| error | String | 返回码 CTCSSCN_000000：成功 CTCSSCN_000001：失败 CTCSSCN_000003：用户未签署协议，安全卫士系统无法正常使用 CTCSSCN_000004：鉴权错误 CTCSSCN_000005：用户没有付费版配额，功能不可用 |
CTCSSCN_000000 | |
| message | String | 返回信息 | 成功 | |
| returnObj | Object | 返回对象 | list |
表 list
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| day | String | 日期 | 0 | |
| total | Integer | 主机总台数 | 0 | |
| onLine | Integer | 在线主机数 | 0 | |
| offLine | Integer | 离线主机数 | 0 | |
| risk | Integer | 风险主机数 | 0 | |
| closed | Integer | 防护关闭数 | 0 | |
| unguarded | Integer | 未防护数 | 0 |
枚举参数
无
请求示例
请求url
无
请求头header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
请求体body
{"type": 1}
响应示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "查询成功!","returnObj":[{"day": "2022-10-11","total": 359,"onLine": 0,"offLine": 0,"risk": 0,"unguarded": 0,"closed": 0},{"day": "2022-10-12","total": 359,"onLine": 0,"offLine": 0,"risk": 0,"unguarded": 0,"closed": 0},{"day": "2022-10-13","total": 359,"onLine": 0,"offLine": 0,"risk": 0,"unguarded": 0,"closed": 0},{"day": "2022-10-14","total": 359,"onLine": 0,"offLine": 0,"risk": 0,"unguarded": 0,"closed": 0},{"day": "2022-10-15","total": 359,"onLine": 0,"offLine": 0,"risk": 0,"unguarded": 0,"closed": 0},{"day": "2022-10-16","total": 359,"onLine": 0,"offLine": 0,"risk": 0,"unguarded": 0,"closed": 0},{"day": "2022-10-17","total": 359,"onLine": 0,"offLine": 0,"risk": 0,"unguarded": 0,"closed": 0}],}
状态码
请参考 状态码
错误码
请参考 错误码
