接口功能介绍

报表管理-预览报表

接口约束

无

URI

POST /v1/safetyReport/event/preView

路径参数 无

Query参数 无

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例	下级对象
Content-Type	是	String	Content-Type	application/json

请求体body参数

参数	是否必填	参数类型	说明	示例	下级对象
id	否	String	报表id	SR10001

响应参数

参数	参数类型	说明	示例	下级对象
error	String	返回码
CTCSSCN_000000：成功
CTCSSCN_000001：失败
CTCSSCN_000003：用户未签署协议，安全卫士系统无法正常使用
CTCSSCN_000004：鉴权错误
CTCSSCN_000005：用户没有付费版配额，功能不可用	0
message	String	返回信息	success
returnObj	Object	返回对象		returnObj
traceId	String	traceId	asaadasd11111
statusCode	String	状态码 200-成功	200
表 returnObj

参数	参数类型	说明	示例	下级对象
type	String	类型
statisticalPeriod	String	统计周期	2025-11-12 00:00:00-23:59:59
createTime	String	基础信息-生成时间	2025-11-12 00:00:00
userAccount	String	用户账号	test-account
hostRange	Object	主机范围		hostRange
module	String	报表统计功能模块，多个空格分割 BASE_LINE-基线检测 VUL_SCAN-漏洞扫描 WEB_TAMPER-网页防篡改 VIRUS-病毒检测 INTRUSION_DETECTION-入侵检测	BASE_LINE INTRUSION_DETECTION VUL_SCAN WEB_TAMPER VIRUS
digestHostsCount	Integer	主机总数	100
digestRiskCount	Integer	发现风险总数	100
digestAlarmCount	Integer	入侵告警总数	100
agentChart	Array of Objects	agent状态分布	[{"count":100,"name":"ONLINE","percent":50.1,"nameCode":1},{"count":100,"name":"OFFLINE","percent":50.1,"nameCode":2},{"count":100,"name":"UNACTIVATED","percent":50.1,"nameCode":3},{"count":100,"name":"ERROR","percent":50.1,"nameCode":4}]	agentChart
offlineAgentList	Array of Objects	离线主机列表最多展示10条		offlineAgentList
riskDiscoverInfo	Object	风险数据统计		riskDiscoverInfo
vulRiskInfo	Object	漏洞扫描风险信息		vulRiskInfo
baseRiskInfo	Object	基线扫描风险信息		baseRiskInfo
weakPwRiskInfo	Object	弱口令风险		weakPwRiskInfo
severityEvent	Object	安全事件		severityEvent
表 severityEvent

参数	参数类型	说明	示例	下级对象
type	String	类型
totalEvents	Integer	总事件数	100
hostNum	Integer	影响服务器数	100
severityChart	Array of Objects	安全事件按威胁等级分布占比 LOW-低危 MEDIUM-中危 HIGH-高危	[{name: "LOW", count: 4, percent: 3.88}, {name: "MEDIUM", count: 32, percent: 31.07},…]	severityChart_0
eventChart	Array of Objects	安全事件按事件类型分布占比 VIRUS-病毒 WEB_TAMPER-网页防篡改 1-进程异常行为 2-恶意软件 3-用户异常行为 4-恶意网络连接 5-其他	[{name: "VIRUS", count: 79, percent: 76.7}, {name: "3", count: 15, percent: 14.56},…]	eventChart
affectedHostsTop5	Array of Objects	影响服务器 Top5	[{agentGuid: "1-1-1-1", agentIp: "192.168.1.1", publicIp: "192.168.1.1", eventCount: 100, events: ["1", "2", "3", "4", "5"]},…]	affectedHostsTop5
表 affectedHostsTop5

参数	参数类型	说明	示例
custName	String	受影响服务器-主机名称	test-hostname
agentGuid	String	受影响服务器-guid	test-guid
agentIp	String	内网Ip	192.168.1.1
publicIp	String	公网Ip	192.168.1.1
eventCount	String	总事件数 Integer	100
events	Array of Strings	事件类型 VIRUS-病毒 WEB_TAMPER-网页防篡改 1-进程异常行为 2-恶意软件 3-用户异常行为 4-恶意网络连接 5-其他	["1","2","3"]
表 eventChart

参数	参数类型	说明	示例
name	String	名称安全事件按威胁等级分布占比[LOW-低危 MEDIUM-中危 HIGH-高危] 安全事件按事件类型分布占比[VIRUS-病毒 WEB_TAMPER-网页防篡改 1-进程异常行为 2-恶意软件 3-用户异常行为 4-恶意网络连接 5-其他]	LOW
count	Integer	总数	100
percent	String	占比	50.1
表 severityChart_0

参数	参数类型	说明	示例
name	String	名称安全事件按威胁等级分布占比[LOW-低危 MEDIUM-中危 HIGH-高危] 安全事件按事件类型分布占比[VIRUS-病毒 WEB_TAMPER-网页防篡改 1-进程异常行为 2-恶意软件 3-用户异常行为 4-恶意网络连接 5-其他]	LOW
count	Integer	总数	100
percent	String	占比	50.1
表 weakPwRiskInfo

参数	参数类型	说明	示例	下级对象
type	String	类型
hostNum	Integer	弱口令风险服务器数量	100
risk	Integer	弱口令风险数量	100
sysRisk	Integer	系统弱口令风险数量	100
appRisk	Integer	应用弱口令风险数量	100
lastScanTime	String	上次扫描时间	2025-11-12 00:00:00
lastScanRisks	Integer	上次检查风险数量	100
scheduledTaskIsOpen	Boolean	是否开启定时扫描 true-开启 false-关闭	true
scheduledTaskConf	Object	弱口令定时任务配置		scheduledTaskConf_0_1
表 scheduledTaskConf_0_1

参数	参数类型	说明	示例
status	Integer	状态 1-开启其他关闭	1
day	Integer	间隔天数	1
hour	Integer	扫描时间-小时，1-代表每间隔day天的凌晨1点minute分开始	1
minute	Integer	扫描时间-分钟，0-代表每间隔day天的hour点的0分开始	0
checkType	String	扫描类型，多个逗号分割 1：系统弱口令:2：应用弱口令	1,2
scope	String	生效范围 OPTIONAL-自选机器 ALL-所有机器	OPTIONAL
表 baseRiskInfo

参数	参数类型	说明	示例	下级对象
type	String	类型
riskHosts	Integer	基线风险服务器数量	100
checkItems	Integer	基线检查项数量	100
checkHosts	Integer	基线检查服务器数量	100
risks	Integer	基线风险数量	100
lastScanTime	String	上次扫描时间	2025-11-12 00:00:00
lastScanRisks	Integer	上次检查基线风险数量	100
scheduledTaskIsOpen	Boolean	是否开启定时扫描 true-开启 false-关闭	true
scheduledTaskConf	Object	基线定时扫描配置		scheduledTaskConf_0
表 scheduledTaskConf_0

参数	参数类型	说明	示例
id	Integer	基线策略id	1
name	String	基线策略名称	策略1
checkfrequency	Integer	间隔天数	1
checktime	String	扫描时间,01:00-02:00代表再每checkfrequency天01:00-02:00之间进行扫描	01:00-02:00
ruleStatus	Boolean	状态 true-开启 false-关闭	true
description	String	描述	描述
createtime	String	创建时间	2020-01-01 00:00:00
isDefault	Boolean	是否默认策略 true-默认策略 false-非默认策略	true
scope	String	生效范围 OPTIONAL-自选机器 ALL-所有机器	OPTIONAL
day	Integer	间隔天数	1
hour	Integer	扫描时间-小时，1-代表每间隔day天的凌晨1点minute分开始	1
minute	Integer	扫描时间-分钟，0-代表每间隔day天的hour点的0分开始	0
表 vulRiskInfo

参数	参数类型	说明	示例	下级对象
lastScanTime	String	上一次漏洞扫描时间	2023-12-12 17:32:00
lastScanVul	Integer	上一次漏洞扫描发现的漏洞数	100
scheduledTaskIsOpen	Boolean	漏洞扫描定时任务是否开启	true
scheduledTaskConf	Object	漏洞扫描配置		scheduledTaskConf
emergenVul	Integer	需紧急修复的漏洞数	100
unHandleVul	Integer	未处理的漏洞数	100
hostNumVul	Integer	存在的漏洞的服务器数	100
severityChart	Array of Objects	漏洞修复优先级分布	[{"count":100,"name":"HIGH_LVL","percent":50.1,"nameCode":1},{"count":100,"name":"LOW_LVL","percent":50.1,"nameCode":2},{"count":100,"name":"MEDIUM_LVL","percent":50.1,"nameCode":3}]	severityChart
emergenVulTop	Array of Objects	需要紧急修复的漏洞top10		emergenVulTop
表 emergenVulTop

参数	参数类型	说明	示例
title	String	漏洞名称	Red Hat libxml2代码执行漏洞(CVE-2025-6021)
severity	String	漏洞修复优先级 HIGH-高 LOW-低 MEDIUM-中	HIGH
count	Integer	影响服务器数量	100
cve	String	CVE编号	CVE-2025-6021
severityCode	Integer	漏洞等级Code 1-低 2-中 3-高	1
表 severityChart

参数	参数类型	说明	示例
count	Integer	数量	1
name	String	名称 agent状态[ONLINE-在线 OFFLINE-离线 UNACTIVATED-未激活 ERROR-错误] 漏洞修复优先级[HIGH_LVL-高 LOW_LVL-低 MEDIUM_LVL-中]	ONLINE
percent	String	百分比，如50.1% 此处的值时50.1	50.1
表 scheduledTaskConf

参数	参数类型	说明	示例
status	Integer	状态 1-开启其他关闭	1
day	Integer	间隔天数	1
hour	Integer	扫描时间-小时，1-代表每间隔day天的凌晨1点minute分开始	1
minute	Integer	扫描时间-分钟，0-代表每间隔day天的hour点的0分开始	0
severity	String	漏洞修复优先级,多个逗号分割，1-低 2-中 3-高	1,2,3
timeout	Integer	超时时间，单位分钟	60
scopeType	String	生效范围 OPTIONAL-自选机器 ALL-所有机器	OPTIONAL
vulScanType	String	漏洞扫描类型，多个逗号分割 LINUX-Linux漏洞 WINDOWS-Windows漏洞 WEB_CMS-WEB漏洞 APPLICATION-应用漏洞 EMERGENCY_VUL-紧急漏洞	LINUX,WEB_CMS,APPLICATION,EMERGENCY_VUL
vulType	Array of Strings	漏洞扫描类型，多个逗号分割 LINUX-Linux漏洞 WINDOWS-Windows漏洞 WEB_CMS-WEB漏洞 APPLICATION-应用漏洞 EMERGENCY_VUL-紧急漏洞	["LINUX", "WINDOWS", "APPLICATION", "WEB_CMS", "EMERGENCY_VUL"]
表 riskDiscoverInfo

参数	参数类型	说明	示例
type	String	类型
totalRisk	Integer	总风险项	100
vulRisk	Integer	漏洞风险	100
baseRisk	Integer	基线风险	100
weakPwRisk	Integer	弱口令风险	100
表 offlineAgentList

参数	参数类型	说明	示例
number	Integer	序号	1
custName	String	主机名称	test-host
agentIp	String	内网Ip	192.168.1.1
publicIp	String	公网Ip	192.168.1.1
osType	String	操作系统 Linux/Windows	Windows
regionName	String	资源池	华东1
表 agentChart

参数	参数类型	说明	示例
count	Integer	数量	1
name	String	名称 agent状态[ONLINE-在线 OFFLINE-离线 UNACTIVATED-未激活 ERROR-错误] 漏洞修复优先级[HIGH_LVL-高 LOW_LVL-低 MEDIUM_LVL-中]	ONLINE
percent	String	百分比，如50.1% 此处的值时50.1	50.1
表 hostRange

参数	参数类型	说明	示例	下级对象
windows	Integer	windows主机数量
linux	Integer	linux 主机数量

枚举参数

无

请求示例

请求url

无

请求头header

{"Content-Type": "application/json"}

请求体body

{"id": "SR10001"}

响应示例

{"message": "success", "traceId": "asaadasd11111", "statusCode": "200", "error": "0", "returnObj": {"type": "", "statisticalPeriod": "2025-11-12 00:00:00-23:59:59", "createTime": "2025-11-12 00:00:00", "userAccount": "test-account", "hostRange": {"windows": "", "linux": ""}, "module": "BASE_LINE INTRUSION_DETECTION VUL_SCAN WEB_TAMPER VIRUS", "digestHostsCount": 100, "digestRiskCount": 100, "digestAlarmCount": 100, "agentChart": [{"count": 1, "name": "ONLINE", "percent": 50.1}], "offlineAgentList": [{"number": 1, "custName": "test-host", "agentIp": "192.168.1.1", "publicIp": "192.168.1.1", "osType": "Windows", "regionName": "华东1"}], "riskDiscoverInfo": {"type": "", "totalRisk": 100, "vulRisk": 100, "baseRisk": 100, "weakPwRisk": 100}, "vulRiskInfo": {"lastScanTime": "2023-12-12 17:32:00", "lastScanVul": 100, "scheduledTaskIsOpen": "true", "scheduledTaskConf": {"status": 1, "day": 1, "hour": 1, "minute": 0, "severity": "1,2,3", "timeout": 60, "scopeType": "OPTIONAL", "vulScanType": "LINUX,WEB_CMS,APPLICATION,EMERGENCY_VUL", "vulType": ["LINUX", "WINDOWS", "APPLICATION", "WEB_CMS", "EMERGENCY_VUL"]}, "emergenVul": 100, "unHandleVul": 100, "hostNumVul": 100, "severityChart": [{"count": 1, "name": "ONLINE", "percent": 50.1}], "emergenVulTop": [{"title": "Red Hat libxml2代码执行漏洞(CVE-2025-6021)", "severity": "HIGH", "count": 100, "cve": "CVE-2025-6021", "severityCode": 1}]}, "baseRiskInfo": {"type": "", "riskHosts": 100, "checkItems": 100, "checkHosts": 100, "risks": 100, "lastScanTime": "2025-11-12 00:00:00", "lastScanRisks": 100, "scheduledTaskIsOpen": "true", "scheduledTaskConf": {"id": 1, "name": "策略1", "checkfrequency": 1, "checktime": "01:00-02:00", "ruleStatus": "true", "description": "描述", "createtime": "2020-01-01 00:00:00", "isDefault": "true", "scope": "OPTIONAL", "day": 1, "hour": 1, "minute": 0}}, "weakPwRiskInfo": {"type": "", "hostNum": 100, "risk": 100, "sysRisk": 100, "appRisk": 100, "lastScanTime": "2025-11-12 00:00:00", "lastScanRisks": 100, "scheduledTaskIsOpen": "true", "scheduledTaskConf": {"status": 1, "day": 1, "hour": 1, "minute": 0, "checkType": "1,2", "scope": "OPTIONAL"}}, "severityEvent": {"type": "", "totalEvents": 100, "hostNum": 100, "severityChart": [{"name": "LOW", "count": 100, "percent": 50.1}], "eventChart": [{"name": "LOW", "count": 100, "percent": 50.1}], "affectedHostsTop5": [{"custName": "test-hostname", "agentGuid": "test-guid", "agentIp": "192.168.1.1", "publicIp": "192.168.1.1", "eventCount": "100", "events": ["1", "2", "3"]}]}}}

状态码

请参考状态码

错误码

请参考错误码

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

服务器安全卫士（原生版）

服务器安全卫士（原生版）

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

服务器安全卫士（原生版）

服务器安全卫士（原生版）

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码