请求地址
由用户创建 Webhook 时提供
请求方式
POST
请求头
字段 | 说明 |
Content-Type | 参考值 application/json,固定为 JSON 格式 |
Authentication | 由用户创建 Webhook 时填写,会通过 Base64 加密后回传,可选项 |
请求参数
4.1. 公共参数
字段 | 类型 | 说明 |
SubId | uint64 | 订阅记录 ID |
SubName | string | 订阅名称 |
AppId | string | 客户 AppID |
Uin | string | 客户 UIN |
ReportType | int | 报告类型枚举:0=日常巡检报告、1=架构巡检报告、2=架构负载报告、6=架构负载多维报告。决定 ReportData 结构 |
ReportTaskId | string | 报告任务 UUID,每次触发订阅任务自动生成 |
ReportCreatedAt | int64 | 报告生成时间,Unix 时间戳(秒) |
ReportData | object | 报告数据块 |
示例:
{"SubId": 10086,"SubName": "容量监测订阅","AppId": "1234567890","Uin": "10000022222","ReportType": 2,"ReportTaskId": "efee6359-13a9-11f1-897e-5254004e4c3a","ReportCreatedAt": 17828449423,"ReportData": {// 具体格式详见报告数据说明"Files": [{ "Type": "json", "Url": "https://cos.example.com/detail.json?sign=xxx" },{ "Type": "pdf", "Url": "https://cos.example.com/report.pdf?sign=xxx" },{ "Type": "excel", "Url": "https://cos.example.com/data.xlsx?sign=xxx" }]}}
4.2. 报告数据说明
不同报告中,ReportData 数据格式有差异,每个字段的类型和说明如下。
4.2.1 日常巡检报告
ReportType=0 时,ReportData 结构如下
字段 | 类型 | 说明 |
Url | string | 跳转地址,仅架构报告分支有数据,账号报告此处为空 |
UrlConsole | string | 控制台跳转地址,仅账号报告有数据 |
UrlInspection | string | 巡检页跳转地址,仅账号日常巡检报告有数据 |
Image | string | 报告截图图片的 COS 签名地址 |
WebhookContent | AggregateMailData | Webhook 消费端使用的聚合数据 |
Files | ReportFile[] | 报告关联的附件文件列表(pdf/excel/html 等) |
AggregateMailData 账号报告聚合数据
字段 | 类型 | 说明 |
AppId | int64 | 客户 AppID |
EvaluationTime | string | 评估时间 |
TplName | string | 模板名称 |
OverallRiskTrend | OverallRiskTrend | 整体风险(高/中风险项与实例对比) |
RecentRiskTrends | RecentRiskTrends | 近期风险趋势(高/中风险分组趋势) |
RecommendAttention | RecommendAttention | 推荐关注的巡检项列表 |
RiskList | RiskList[] | 风险列表(按产品维度) |
OverallRiskTrend
字段 | 类型 | 说明 |
RiskInfoList | RiskInfoList[] | 风险对比项(高风险项、高风险实例、中风险项、中风险实例) |
RiskInfoList
字段 | 类型 | 说明 |
RiskName | string | 名称 |
Total | int64 | 总数 |
ComparedYesterdayNumber | int64 | 对比昨天数量(可正可负) 注意:9223372036854775807的时候,表示第一天的数据,对应- |
ComparedLastWeek | int64 | 对比上周数量 注意:9223372036854775807的时候,表示第一个周的数据,对应- |
RecentRiskTrends 近期风险趋势
字段 | 类型 | 说明 |
GroupHighRiskTrendList | GroupRiskTrend | 高风险分组趋势 |
GroupMiddleRiskTrendList | GroupRiskTrend | 中风险分组趋势 |
GroupRiskTrend 风险组数量
字段 | 类型 | 说明 |
Time | string[] | 时间,格式 yyyy-mm-dd |
SecurityRiskItem | float64[] | 安全组风险项数量 |
ReliableRiskItem | float64[] | 可靠组风险项数量 |
ServiceLimitRiskItem | float64[] | 服务限制组风险项数量 |
CostRiskItem | float64[] | 成本组风险项数量 |
PerformanceRiskItem | float64[] | 性能组风险项数量 |
RecommendAttention 推荐关注
字段 | 类型 | 说明 |
StrategyInfoList | StrategyInfo[] | 推荐关注的巡检项信息列表 |
RiskList 风险列表
字段 | 类型 | 说明 |
ProductName | string | 产品中文名称 |
ComparedLastWeekHighRiskItem | int64 | 同比上周高风险项数量 |
ComparedLastWeekMiddleRiskItem | int64 | 同比上周中风险项数量 |
StrategyInfoList | StrategyInfo[] | 该产品下的巡检项信息列表 |
StrategyInfo 风险项信息
字段 | 类型 | 说明 |
StrategyName | string | 巡检项名称 |
StrategyDesc | string | 巡检项描述 |
StrategyScore | int64 | 分数,用于排序 |
RiskInstanceCount | int64 | 风险实例数量 |
ComparedLastWeekRiskInstance | int64 | 同比上周该风险项风险实例数量 |
RiskLevel | int64 | 风险项等级 |
RiskRepair | string | 风险项建议 |
RiskNotice | string | 风险项 notice |
ReportFile 报告文件
字段 | 类型 | 说明 |
Type | string | 文件类型:JSON PDF Excel |
Url | string | 预签名 URL,有效期24小时;无该类型文件时 Url 为空字符串 |
Files 中包含三种类型文件:json(明细数据 JSON)、pdf(报告 PDF)、excel(报告 Excel),每种类型的 Url 均有值。
示例:
{"Url": "","UrlConsole": "https://console.cloud.tencent.com/advisor/assess?pluginParam=from-inspection-email-1","UrlInspection": "https://console.cloud.tencent.com/advisor?archId=arch-22odf7tb\\\\u0026plugin=cloud-inspection-sdk\\\\u0026pluginParam=from-inspection-email-2","Image": "https://advisor-scan-pre-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/AdvisorExcel/__INLINE__5388f3b1-8da3-4d90-be4c-879963c58d52__1781689381.jpg?q-sign-algorithm=sha1\\\\u0026q-ak=AK***********************************4KnANN9\\\\u0026q-sign-time=1781689323;1876297383\\\\u0026q-key-time=1781689323;1876297383\\\\u0026q-header-list=host\\\\u0026q-url-param-list=\\\\u0026q-signature=dd23bd034531c51a72505cc1be6317ea01971c6d\\\\u0026x-cos-security-token=\\\\u0026imageMogr2/strip/format/jpg/size-limit/150k!","Files": [{"Type": "excel","Url": "https://advisor-scan-pre-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/AdvisorExcel/腾讯云智能顾问评估结果_cloudchaos@tencent.com_1312346585(2026-06-17 17_43_02).xlsx?q-sign-algorithm=sha1\\\\u0026q-ak=AK***********************************4KnANN9\\\\u0026q-sign-time=1781689323;1876297383\\\\u0026q-key-time=1781689323;1876297383\\\\u0026q-header-list=host\\\\u0026q-url-param-list=\\\\u0026q-signature=1a6d655b86cc7d42f90dd50486ba26f95bf33ce4\\\\u0026x-cos-security-token="},{"Type": "pdf","Url": "https://advisor-scan-pre-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/AdvisorExcel/腾讯云智能顾问评估结果_cloudchaos@tencent.com_1312346585(2026-06-17 17_43_02).pdf?q-sign-algorithm=sha1\\\\u0026q-ak=AK***********************************4KnANN9\\\\u0026q-sign-time=1781689323;1876297383\\\\u0026q-key-time=1781689323;1876297383\\\\u0026q-header-list=host\\\\u0026q-url-param-list=\\\\u0026q-signature=356bb2936bd44309e16cc4ff38f69399971699c5\\\\u0026x-cos-security-token="}],"WebhookContent": {"AppId": 1312346585,"EvaluationTime": "2026-06-17 16:02:12","TplName": "","OverallRiskTrend": {"RiskInfoList": [{"RiskName": "高风险项","Total": 0,"ComparedYesterdayNumber": 9223372036854775807,"ComparedLastWeek": -1},{"RiskName": "高风险实例","Total": 0,"ComparedYesterdayNumber": 9223372036854775807,"ComparedLastWeek": -1},{"RiskName": "中风险项","Total": 1,"ComparedYesterdayNumber": 9223372036854775807,"ComparedLastWeek": -4},{"RiskName": "中风险实例","Total": 2,"ComparedYesterdayNumber": 9223372036854775807,"ComparedLastWeek": -146}]},"RecentRiskTrends": {"GroupHighRiskTrendList": {"Time": ["2026-06-11","2026-06-13","2026-06-13","2026-06-14","2026-06-15","2026-06-17","2026-06-17"],"SecurityRiskItem": [0,1,1,0,1],"ReliableRiskItem": [0,4,4,4,0,4,0],"ServiceLimitRiskItem": [0,0,0,0,0,0,0],"CostRiskItem": [0,0,0,0,0],"PerformanceRiskItem": [1,3,3,1,0,0]},"GroupMiddleRiskTrendList": {"Time": ["2026-06-11","2026-06-13","2026-06-13","2026-06-14","2026-06-15","2026-06-17","2026-06-17"],"SecurityRiskItem": [1,2,2,0,2],"ReliableRiskItem": [1,5,5,4,2,6,0],"ServiceLimitRiskItem": [0,1,1,1,0,1,0],"CostRiskItem": [5,5,4,4,0],"PerformanceRiskItem": [1,1,1,1,0,0]}},"RecommendAttention": {"StrategyInfoList": [{"StrategyName": "EdgeOne 域名配置的 “自适应频控”、“智能客户端过滤”的处置方式为“拦截”或者“JavaScript 挑战”","StrategyDesc": "","StrategyScore": 0,"RiskInstanceCount": 2,"ComparedLastWeekRiskInstance": 0,"RiskLevel": 2,"RiskRepair": "","RiskNotice": "%d 个站点存在风险"}]},"RiskList": [{"ProduceName": "","ComparedLastWeekHighRiskItem": -1,"ComparedLastWeekMiddleRiskItem": -4,"StrategyInfoList": []},{"ProduceName": "边缘安全加速平台(EdgeOne)","ComparedLastWeekHighRiskItem": 9223372036854775807,"ComparedLastWeekMiddleRiskItem": 9223372036854775807,"StrategyInfoList": [{"StrategyName": "","StrategyDesc": "EdgeOne 新增域名时,站点级防护策略默认是开启自适应频控、智能客户端过滤,处置方式是“JavaScript 挑战”,这2个策略是通过基线学习,直接开启可能会出现请求被误拦截的风险","StrategyScore": 0,"RiskInstanceCount": 2,"ComparedLastWeekRiskInstance": 9223372036854775807,"RiskLevel": 2,"RiskRepair": "","RiskNotice": "%d 个站点存在风险"}]}]}}
4.2.2 架构巡检报告
ReportType=1 时,ReportSubType=0 时 ReportData 结构如下
字段 | 类型 | 说明 |
Url | string | 架构图巡检详情的跳转地址 |
UrlConsole | string | 控制台跳转地址,架构报告固定为空 |
UrlInspection | string | 巡检页跳转地址,架构报告固定为空 |
Image | string | 报告截图图片的 COS 签名地址 |
WebhookContent | ArchEmailReportContent | Webhook 消费端使用的聚合数据 |
Files | ReportFile[] | 报告关联的附件文件列表(pdf/excel/html 等),omitempty |
WebhookContent(ArchEmailReportContent)架构报告聚合数据
字段 | 类型 | 说明 |
ArchRiskTrendInfo | ArchRiskTrendInfoData | DescribeArchRiskTrendInfo 接口响应 |
ArchScanOverviewInfo | ArchScanOverviewInfoData | DescribeArchScanOverviewInfo 接口响应 |
ArchStrategyList | ArchStrategyListData | DescribeArchStrategyList 接口响应 |
ArchRiskTrendInfoData 风险趋势相关图表数据
字段 | 类型 | 说明 |
ArchId | string | 架构图 ID |
ArchName | string | 架构图名称 |
ArchRiskChartInfos | ArchScanChartInfo[] | 风险图表列表,长度固定为 3,下标语义见下表 |
ArchRiskChartInfos 下标固定语义
下标 | 含义 |
0 | 巡检整体风险趋势 |
1 | 产品风险概览 |
2 | 产品风险趋势 |
ArchScanOverviewInfoData 架构图巡检概览信息
字段 | 类型 | 说明 |
CustomerName | string | 客户名称 |
ArchId | string | 架构图 ID |
ArchName | string | 架构图名称 |
AppId | int64 | 客户 AppID |
FinishTime | string | 巡检完成时间,格式 yyyy-MM-dd HH:mm:ss |
ResultId | string | 报告结果 ID |
ReportDate | string | 报告日期,格式 yyyy-MM-dd |
ReportArchiveStatus | bool | 报告是否已归档 |
ArchScanSourceInfo | ArchScanResourceInfo | 巡检资源概览 |
CurrentStrategySummaryInfo | ArchStrategySummaryInfo | 本期策略汇总 |
LastWeekStrategySummaryInfo | ArchStrategySummaryInfo | 上一期/上周策略汇总 |
ArchScanScoreTrendInfo | ArchScanChartInfo | 巡检得分趋势图表数据 |
CurrentScanScore | int64 | 本次巡检得分 |
ArchScanGroupScoreInfo | ArchScanChartInfo | 巡检分组得分图表数据 |
ArchStrategyListData 有风险的策略列表
字段 | 类型 | 说明 |
ArchStrategyList | ArchStrategyInfo[] | 有风险的策略条目列表,已按产品/等级/风险数排序 |
嵌套类型
ArchScanResourceInfo 巡检资源概览
字段 | 类型 | 说明 |
ScanStrategyCount | int64 | 巡检策略数 |
ScanProductCount | int64 | 巡检产品数 |
ScanResourceCount | int64 | 已巡检资源数 |
ScanResourcePercent | string | 资源覆盖率(百分比字符串) |
UnScanResourceCount | int64 | 未巡检资源数 |
UnBindResourceCount | int64 | 未绑定资源数 |
ArchStrategySummaryInfo 策略汇总
字段 | 类型 | 说明 |
ScanCount | string | 巡检项总数 |
HighRiskCount | string | 高风险项数 |
MediumRiskCount | string | 中风险项数 |
NoRiskCount | string | 健康项数 |
ArchStrategyInfo 策略条目
字段 | 类型 | 说明 |
GroupName | string | 策略所属分组名(按语言本地化) |
ProductName | string | 产品名 |
StrategyName | string | 巡检策略名(按语言本地化) |
Level | string | 风险等级文案:高风险/中风险(zh-CN)或 High risk/Medium risk(en-US) |
Condition | string[] | 命中条件描述,多条目时按风险等级倒序,每行格式 <等级文案>: <条件描述> |
Notice | string | 风险说明,由策略 Notice + Ignore 模板拼接 |
Repair | string | 修复建议 |
ArchScanChartInfo 图表数据
字段 | 类型 | 说明 |
Name | string | 图表名 |
ExtraInfo | string | 额外信息 |
ChartInfoSet | ChartInfo[] | 图表条目列表 |
ChartInfo 图表条目
字段 | 类型 | 说明 |
TitleName | string | 子图标题 |
ChartType | string | 图表类型,例如 line / bar |
DisplayStatus | int | 展示状态 |
ChartDataInfoSet | ChartDataInfo[] | 数据集合 |
ChartDataInfo 图表数据集合
字段 | 类型 | 说明 |
DataName | string | 数据系列名 |
KeyValueSet | ChartKeyValue[] | 键值数据 |
ChartKeyValue 图表键值数据
字段 | 类型 | 说明 |
Key | string | 键 |
KeyCNName | string | 键中文名 |
Value | float64 | 值 |
ReportFile 附件文件
字段 | 类型 | 说明 |
Type | string | 附件类型:PDF Excel HTML 等 |
Url | string | 附件下载地址 |
示例:
{"Url": "https://console.cloud.tencent.com/advisor?archId=arch-gun93ijo\\\\u0026plugin=cloud-inspection-sdk","UrlConsole": "","UrlInspection": "","Image": "https://advisor-scan-pre-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/AdvisorExcel/__INLINE__7e522aa6-6a37-11f1-98c4-525400eed455.jpg?q-sign-algorithm=sha1\\\\u0026q-ak=AK***********************************4KnANN9\\\\u0026q-sign-time=1781692172;1876300232\\\\u0026q-key-time=1781692172;1876300232\\\\u0026q-header-list=host\\\\u0026q-url-param-list=\\\\u0026q-signature=0fe080c346664c8b85a476e3dce9358a653b1dfb\\\\u0026x-cos-security-token=\\\\u0026imageMogr2/strip/format/jpg/size-limit/150k!","Files": [{"Type": "excel","Url": "https://advisor-scan-pre-1258344699.cos-internal.ap-guangzhou.tencentcos.cn/AdvisorExcel/腾讯云智能顾问评估结果__1312346585_(2026-06-17 18_30_03).xlsx?q-sign-algorithm=sha1\\\\u0026q-ak=AK***********************************4KnANN9\\\\u0026q-sign-time=1781692172;1876300232\\\\u0026q-key-time=1781692172;1876300232\\\\u0026q-header-list=host\\\\u0026q-url-param-list=\\\\u0026q-signature=13ca169236c4a4dd77457f0e1827424a19240a01\\\\u0026x-cos-security-token="}],"WebhookContent": {"ArchRiskTrendInfo": {"ArchId": "arch-gun93ijo","ArchName": "某电商护航大屏Demo","ArchRiskChartInfos": [{"Name": "架构图风险趋势","ExtraInfo": "","ChartInfoSet": [{"TitleName": "架构图风险趋势","ChartType": "Line","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "高风险数量","KeyValueSet": [{"Key": "11月","KeyCNName": "","Value": 6},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 5},{"Key": "2月","KeyCNName": "","Value": 5},{"Key": "3月","KeyCNName": "","Value": 5},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 4},{"Key": "6月","KeyCNName": "","Value": 1}]},{"DataName": "中风险数量","KeyValueSet": [{"Key": "11月","KeyCNName": "","Value": 14},{"Key": "12月","KeyCNName": "","Value": 13},{"Key": "1月","KeyCNName": "","Value": 13},{"Key": "2月","KeyCNName": "","Value": 16},{"Key": "3月","KeyCNName": "","Value": 18},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 14},{"Key": "6月","KeyCNName": "","Value": 17}]}]}]},{"Name": "当前架构图覆盖产品风险 Top15","ExtraInfo": "","ChartInfoSet": [{"TitleName": "当前架构图覆盖产品风险 Top15","ChartType": "Bar","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "私有网络(VPC)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 0},{"Key": "健康项数量","KeyCNName": "","Value": 1}]},{"DataName": "云联网","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 0},{"Key": "健康项数量","KeyCNName": "","Value": 1}]},{"DataName": "NAT","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 0},{"Key": "健康项数量","KeyCNName": "","Value": 3}]},{"DataName": "弹性公网 IP(EIP)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 0},{"Key": "健康项数量","KeyCNName": "","Value": 6}]},{"DataName": "云安全中心(CSC)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 0},{"Key": "健康项数量","KeyCNName": "","Value": 8}]},{"DataName": "消息队列(Ckafka)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 0},{"Key": "健康项数量","KeyCNName": "","Value": 8}]},{"DataName": "容器服务(TKE)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 0},{"Key": "健康项数量","KeyCNName": "","Value": 24}]},{"DataName": "云硬盘(CBS)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 1},{"Key": "健康项数量","KeyCNName": "","Value": 4}]},{"DataName": "云服务器(CVM)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 2},{"Key": "健康项数量","KeyCNName": "","Value": 14}]},{"DataName": "云数据库(Redis)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 3},{"Key": "健康项数量","KeyCNName": "","Value": 10}]},{"DataName": "负载均衡(CLB)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 4},{"Key": "健康项数量","KeyCNName": "","Value": 16}]},{"DataName": "内容分发网络(CDN)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 0},{"Key": "中风险项数量","KeyCNName": "","Value": 5},{"Key": "健康项数量","KeyCNName": "","Value": 7}]},{"DataName": "云数据库(MySQL)","KeyValueSet": [{"Key": "高风险项数量","KeyCNName": "","Value": 1},{"Key": "中风险项数量","KeyCNName": "","Value": 2},{"Key": "健康项数量","KeyCNName": "","Value": 16}]}]}]},{"Name": "ProductRiskTrend:云数据库(MySQL)","ExtraInfo": "","ChartInfoSet": [{"TitleName": "安全","ChartType": "Line","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "高风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 1},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 1},{"Key": "2月","KeyCNName": "","Value": 1},{"Key": "3月","KeyCNName": "","Value": 1},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 1}]},{"DataName": "中风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 0},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 0},{"Key": "2月","KeyCNName": "","Value": 0},{"Key": "3月","KeyCNName": "","Value": 0},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 0}]}]},{"TitleName": "可靠","ChartType": "Line","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "高风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 0},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 0},{"Key": "2月","KeyCNName": "","Value": 0},{"Key": "3月","KeyCNName": "","Value": 0},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 0}]},{"DataName": "中风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 1},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 1},{"Key": "2月","KeyCNName": "","Value": 1},{"Key": "3月","KeyCNName": "","Value": 1},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 1}]}]},{"TitleName": "性能","ChartType": "Line","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "高风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 0},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 0},{"Key": "2月","KeyCNName": "","Value": 0},{"Key": "3月","KeyCNName": "","Value": 0},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 0}]},{"DataName": "中风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 0},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 0},{"Key": "2月","KeyCNName": "","Value": 0},{"Key": "3月","KeyCNName": "","Value": 0},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 0}]}]},{"TitleName": "成本","ChartType": "Line","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "高风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 0},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 0},{"Key": "2月","KeyCNName": "","Value": 0},{"Key": "3月","KeyCNName": "","Value": 0},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 0}]},{"DataName": "中风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 1},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 1},{"Key": "2月","KeyCNName": "","Value": 1},{"Key": "3月","KeyCNName": "","Value": 1},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 1}]}]},{"TitleName": "服务限制","ChartType": "Line","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "高风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 0},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 0},{"Key": "2月","KeyCNName": "","Value": 0},{"Key": "3月","KeyCNName": "","Value": 0},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 0}]},{"DataName": "中风险数量","KeyValueSet": [{"Key": "7月","KeyCNName": "","Value": 0},{"Key": "8月","KeyCNName": "","Value": 0},{"Key": "9月","KeyCNName": "","Value": 0},{"Key": "10月","KeyCNName": "","Value": 0},{"Key": "11月","KeyCNName": "","Value": 0},{"Key": "12月","KeyCNName": "","Value": 0},{"Key": "1月","KeyCNName": "","Value": 0},{"Key": "2月","KeyCNName": "","Value": 0},{"Key": "3月","KeyCNName": "","Value": 0},{"Key": "4月","KeyCNName": "","Value": 0},{"Key": "5月","KeyCNName": "","Value": 0},{"Key": "6月","KeyCNName": "","Value": 0}]}]}]}]},"ArchScanOverviewInfo": {"CustomerName": "深圳市腾讯计算机系统有限公司","ArchId": "arch-gun93ijo","ArchName": "某电商护航大屏Demo","AppId": 1312346585,"FinishTime": "2026-06-17 10:35:22","ResultId": "mapTaskType#3955aec7-b771-42ce-a04d-f3bd2b64cb30#zh-CN#public#1781692200","ReportDate": "2026-06-17","ReportArchiveStatus": false,"ArchScanSourceInfo": {"ScanStrategyCount": 136,"ScanProductCount": 20,"ScanResourceCount": 53,"ScanResourcePercent": "0","UnScanResourceCount": 6,"UnBindResourceCount": 0},"CurrentStrategySummaryInfo": {"ScanCount": "136","HighRiskCount": "1","MediumRiskCount": "17","NoRiskCount": "118"},"LastWeekStrategySummaryInfo": {"ScanCount": "--","HighRiskCount": "--","MediumRiskCount": "--","NoRiskCount": "--"},"ArchScanScoreTrendInfo": {"Name": "巡检得分","ExtraInfo": "","ChartInfoSet": [{"TitleName": "近 7 日架构实例资源数及巡检得分变化趋势","ChartType": "Line","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "资源数","KeyValueSet": [{"Key": "06.11","KeyCNName": "","Value": 1785},{"Key": "06.12","KeyCNName": "","Value": 1785},{"Key": "06.13","KeyCNName": "","Value": 1785},{"Key": "06.14","KeyCNName": "","Value": 1785},{"Key": "06.15","KeyCNName": "","Value": 1785},{"Key": "06.16","KeyCNName": "","Value": 1785},{"Key": "06.17","KeyCNName": "","Value": 59}]},{"DataName": "巡检得分","KeyValueSet": [{"Key": "06.11","KeyCNName": "","Value": 95},{"Key": "06.12","KeyCNName": "","Value": 95},{"Key": "06.13","KeyCNName": "","Value": 95},{"Key": "06.14","KeyCNName": "","Value": 95},{"Key": "06.15","KeyCNName": "","Value": 95},{"Key": "06.16","KeyCNName": "","Value": 95},{"Key": "06.17","KeyCNName": "","Value": 96}]}]}]},"CurrentScanScore": 96,"ArchScanGroupScoreInfo": {"Name": "分数构成","ExtraInfo": "","ChartInfoSet": [{"TitleName": "","ChartType": "Bar","DisplayStatus": 1,"ChartDataInfoSet": [{"DataName": "","KeyValueSet": [{"Key": "服务限制","KeyCNName": "","Value": 100},{"Key": "成本","KeyCNName": "","Value": 96},{"Key": "性能","KeyCNName": "","Value": 98},{"Key": "可靠","KeyCNName": "","Value": 93},{"Key": "安全","KeyCNName": "","Value": 94}]}]}]}},"ArchStrategyList": {"ArchStrategyList": [{"GroupName": "可靠","ProductName": "云硬盘(CBS)","StrategyName": "云硬盘(CBS)未创建快照","Level": "中风险","Condition": ["中风险: CBS 未创建快照"],"Notice": "5块云硬盘没有快照。 5块云硬盘被忽略。","Repair": "建议[创建快照](https://cloud.tencent.com/document/product/362/5755),或[创建定期快照策略](https://cloud.tencent.com/document/product/362/8191),以提高数据安全性,实现业务的低成本高容灾"},{"GroupName": "可靠","ProductName": "内容分发网络(CDN)","StrategyName": "内容分发网络(CDN)备用源站未配置","Level": "中风险","Condition": ["中风险: 无备用源站"],"Notice": "1个 CDN 实例未配置备用源站。 0个实例被忽略。","Repair": "建议配置备源,注意备源需要和主源服务保持一致,确保主备容灾切换有效。请查看[最佳实践](https://cloud.tencent.com/developer/article/1978812)"},{"GroupName": "安全","ProductName": "内容分发网络(CDN)","StrategyName": "内容分发网络(CDN)未开启HTTPS巡检","Level": "中风险","Condition": ["中风险: HTTPS 配置未开启"],"Notice": "1个 CDN 没有开启HTTPS。 0个域名被忽略。","Repair": "建议开启HTTPS,同时给出未开启的HTTPS域名列表"},{"GroupName": "安全","ProductName": "内容分发网络(CDN)","StrategyName": "内容分发网络(CDN)域名未开启任何URL鉴权","Level": "中风险","Condition": ["中风险: 未配置鉴权配置"],"Notice": "1个 CDN 域名未开启任何URL鉴权。 0个域名被忽略。","Repair": "建议采用URL鉴权方式保护源站资源,以提高业务安全性,防止站点资源被恶意下载盗用"},{"GroupName": "安全","ProductName": "内容分发网络(CDN)","StrategyName": "内容分发网络(CDN)IP 访问限频未开启","Level": "中风险","Condition": ["中风险: 未配置 IP 访问限频"],"Notice": "1个 CDN 实例未开启 IP 限频。 0个实例被忽略。","Repair": "可在控制台上打开开关。 对单机IP访问进行限频,抵御相关高频访问。该收益需视业务情况优化。请查看[最佳实践](https://cloud.tencent.com/developer/article/1969968)"},{"GroupName": "性能","ProductName": "内容分发网络(CDN)","StrategyName": "内容分发网络(CDN)单链接下行限速未开启","Level": "中风险","Condition": ["中风险: 配置了单链接下行限速"],"Notice": "1个 CDN 实例未关闭单链接下行限速配置。 0个实例被忽略。","Repair": "可在控制台上开启设置, 可控制峰值带宽,关闭后访问体验及 CDN 加速效果受影响,需要视业务情况评估。请查看[最佳实践](https://cloud.tencent.com/developer/article/1971417)"},{"GroupName": "可靠","ProductName": "负载均衡(CLB)","StrategyName": "负载均衡(CLB)后端服务单点风险","Level": "中风险","Condition": ["中风险: CLB 监听器或转发规则只绑定了一个后端服务实例"],"Notice": "2个实例监听器或转发规则绑定的实例单点。 2个实例被忽略。","Repair": "建议 CLB 监听器或转发规则绑定两个及以上的后端服务实例,避免单点故障"},{"GroupName": "可靠","ProductName": "负载均衡(CLB)","StrategyName": "负载均衡(CLB)后端存在串流风险","Level": "中风险","Condition": ["中风险: 同一个地域,如果多个内网 CLB 绑定了同一组后端服务的 IP:PORT,则提示风险"],"Notice": "1个实例在某个地域出现串流。 2个实例被忽略。","Repair": "建议修改绑定的后端服务策略,尽量避免多个负载均衡绑定同一后端服务器的同一端口,详情可参考:https://cloud.tencent.com/document/product/214/5411#19。"},{"GroupName": "可靠","ProductName": "负载均衡(CLB)","StrategyName": "负载均衡(CLB)实例未升级域名化","Level": "中风险","Condition": ["中风险: 存在非域名化负载均衡实例"],"Notice": "1个 CLB 实例存在风险。 0个实例被忽略。","Repair": "域名化负载均衡可用性更强,SLA 从 99.95% 提升至 99.99%,自动替换故障 VIP,降低对业务的影响;弹性更佳,VIP 随业务请求动态变化,横向灵活扩展,规格更大。建议您根据业务实际需求,评估升级域名化负载均衡,升级指引详见[域名化负载均衡升级指南](https://cloud.tencent.com/document/product/214/86440)(请注意升级限制说明)。 升级后负载均衡将以域名的方式提供服务,产品控制台将不再展示 VIP 信息"},{"GroupName": "成本","ProductName": "负载均衡(CLB)","StrategyName": "负载均衡(CLB)实例闲置","Level": "中风险","Condition": ["中风险: CLB 未创建监听器"],"Notice": "1个 CLB 实例被闲置。 1个实例被忽略。","Repair": "检测到您的 CLB 实例未绑定后端服务。如需继续使用该实例,请[配置监听器](https://cloud.tencent.com/document/product/214/6151),并[绑定后端服务](https://cloud.tencent.com/document/product/214/6095),如当前无使用场景,建议删除实例,避免产生额外的成本。"},{"GroupName": "成本","ProductName": "云服务器(CVM)","StrategyName": "云服务器(CVM)计费模式不合理","Level": "中风险","Condition": ["中风险: CVM 实例超过2个月处于按量计费模式"],"Notice": "3个 CVM 实例长期处于按量计费模式。 0个实例被忽略。","Repair": "建议实例[计费模式转为包年包月](https://cloud.tencent.com/document/product/213/2762),以节约成本"},{"GroupName": "安全","ProductName": "云服务器(CVM)","StrategyName": "云服务器(CVM)系统盘未创建快照","Level": "中风险","Condition": ["中风险: 系统盘和数据盘近30天未创建快照"],"Notice": "1 个实例存在风险。 0 个实例被忽略。","Repair": "请评估业务需求,尽快创建快照进行数据备份。参考文档: https://cloud.tencent.com/document/product/362/5755"},{"GroupName": "安全","ProductName": "云数据库(MySQL)","StrategyName": "云数据库(MySQL)root 账号安全风险","Level": "高风险","Condition": ["高风险: MySQL 实例只设置了 root 账号"],"Notice": "1个 MySQL 实例只设置了 root 账号。 2个实例被忽略。","Repair": "建议依据最小化权限原则,根据不同的业务需求[创建不同的账号](https://cloud.tencent.com/document/product/236/35794),并分配适当的权限,提升数据隔离性和安全性,也便于管理。请查看[最佳实践](https://cloud.tencent.com/developer/article/1972601)"},{"GroupName": "成本","ProductName": "云数据库(MySQL)","StrategyName": "云数据库(MySQL)利用率不足","Level": "中风险","Condition": ["中风险: 连续 7 天CPU 使用率的 ${maxPercent} 分位值小于 5%,且连续 7 天内存使用率的 ${maxPercent} 分位值小于 70%","中风险: 连续 7 天峰值 QPS的 ${maxPercent} 分位值小于 10次/秒,且连续 7 天内存使用率的 ${maxPercent} 分位值小于 70%"],"Notice": "2个 MySQL 实例长时间处于低利用率状态。 6个实例被忽略。","Repair": "当业务判断短期没有增长计划,建议可以适当[调整实例规格](https://cloud.tencent.com/document/product/236/19707),进行实例缩容,降低成本。请查看[最佳实践](https://cloud.tencent.com/developer/article/1973036)"},{"GroupName": "可靠","ProductName": "云数据库(MySQL)","StrategyName": "云数据库(MySQL)未配置跨可用区部署","Level": "中风险","Condition": ["中风险: 未跨可用区部署"],"Notice": "1个 MySQL 实例未跨可用区部署。 2个实例被忽略。","Repair": "如果业务上对 1ms 的网络延迟不敏感,建议采用主从跨可用区部署,提高数据库的可用性。请查看[最佳实践](https://cloud.tencent.com/developer/article/1956902)"},{"GroupName": "成本","ProductName": "云数据库(Redis)","StrategyName": "云数据库(Redis)利用率不足","Level": "中风险","Condition": ["中风险: 连续 7 天 CPU 使用率小于 5% 且内存使用率小于 5%","中风险: 连续 7 天 QPS 小于 100 且内存使用率小于 40次/秒"],"Notice": "1个 Redis 实例长时间处于低利用率状态。 0个实例被忽略。","Repair": "当业务判断短期没有增长计划,建议可以适当[调整实例规格](https://cloud.tencent.com/document/product/239/30895),进行实例缩容,降低成本。请查看[最佳实践](https://cloud.tencent.com/developer/article/1985140)"},{"GroupName": "安全","ProductName": "云数据库(Redis)","StrategyName": "云数据库(Redis)未禁用高危命令","Level": "中风险","Condition": ["中风险: Redis 未禁用任何高危命令"],"Notice": "1个 Redis 实例未禁用高危命令。 0个实例被忽略。","Repair": "建议禁用flushall、flushdb、keys,其中flushall、flushdb是避免业务误操作清空数据库,keys是避免业务全表扫引发大量执行慢查询;请参考[禁用命令](https://cloud.tencent.com/document/product/239/36758),为实例配置禁用命令,提升实例的安全性和伸缩性"},{"GroupName": "性能","ProductName": "云数据库(Redis)","StrategyName": "云数据库(Redis)未升级为集群版","Level": "中风险","Condition": ["中风险: 未升级为集群版"],"Notice": "1个 Redis 实例非集群版。 0 个实例被忽略。","Repair": "建议[升级实例架构](https://cloud.tencent.com/document/product/239/46458)成集群版,当 cpu、流量、连接数、内存等使用不够时可以随时横向变配,具备较强的抗风险能力"}]}}}
当 ReportType=1,并且 ReportSubType 为1 时,ReportData 结构如下
字段 | 类型 | 说明 |
AppId | int64 | 客户 AppID |
Uin | string | 客户 UIN |
SubscriptionTopic | string | 订阅主题名称 |
SubscriptionDesc | string | 订阅主题描述 |
SubjectTopicId | int64 | 风险主题 ID |
ArchId | string | 架构图 ID |
Date | string | 报告日期 |
ArchName | string | 架构图名称 |
AdvisorTaskFinishTime | string | 巡检完成时间 |
TotalRiskCount | int | 实例维度的风险总数 |
HighRiskCount | int | 实例维度的高风险总数 |
MediumRiskCount | int | 实例维度的中风险总数 |
RiskProductCountList | RiskProductCount[] | 按产品维度的风险数量与占比列表 |
RiskProductCount 产品维度风险概览
字段 | 类型 | 说明 |
ProductName | string | 产品名称 |
Count | int | 该产品下的风险实例数量 |
Rate | string | 该产品风险数量在总风险中的占比(百分比字符串,如 "66.67%") |
示例:
{"AppId": 1312346585,"Uin": "100025928155","SubscriptionTopic": "111","SubscriptionDesc": "11111","SubjectTopicId": 783,"ArchId": "arch-gun93ijo","Date": "","ArchName": "某电商护航大屏Demo","AdvisorTaskFinishTime": "2026-06-17 10:35:22","TotalRiskCount": 2,"HighRiskCount": 0,"MediumRiskCount": 2,"RiskProductCountList": [{"ProductName": "clb","Count": 2,"Rate": "100.0"}]}
4.2.3 架构负载报告
ReportType=2 时,ReportData 结构如下
字段 | 类型 | 说明 |
TaskId | string | 报告任务 ID |
AppId | string | 客户 AppID |
Uin | string | 客户 UIN |
ArchId | string | 架构图 UUID |
ArchName | string | 架构图名称 |
CreateTime | string | 报告创建时间,格式 yyyy-MM-dd HH:mm:ss |
TotalInstanceCount | int | 实例总数 |
HighRiskCount | int | 高风险实例数 |
MediumRiskCount | int | 中风险实例数 |
LowUsedCount | int | 低使用率实例数 |
LowRiskCount | int | 低风险实例数 |
InstanceItems | InstanceItem[] | 产品实例概览列表(最多展示8个产品,超出合并为 other) |
RiskItems | RiskItem[] | 风险指标汇总列表,按高风险数降序排列 |
Files | ReportFile[] | 报告文件预签名 URL 列表 |
InstanceItem 产品实例概览
字段 | 类型 | 说明 |
Product | string | 产品代号,如 cvm、cbs |
ProductName | string | 产品中文名,如 云服务器 |
TotalCount | int | 该产品实例总数 |
Rate | float32 | 该产品实例占比(百分比,如 66.67 表示 66.67%) |
RiskItem 风险指标汇总
字段 | 类型 | 说明 |
Product | string | 产品代号 |
ProductName | string | 产品中文名 |
MetricItems | RiskMetricItem[] | 该产品的风险指标明细 |
RiskMetricItem 风险指标明细
字段 | 类型 | 说明 |
Metric | string | 指标英文代号,如 CPUUsage |
MetricName | string | 指标中文名,如 CPU 利用率 |
HighCount | int | 高风险实例数 |
MediumCount | int | 中风险实例数 |
ReportFile 报告文件
字段 | 类型 | 说明 |
Type | string | 文件类型:JSON PDF Excel |
Url | string | 预签名 URL,有效期24小时;无该类型文件时 Url 为空字符串 |
Files 中包含三种类型文件:json(明细数据 JSON)、pdf(报告 PDF)、excel(报告 Excel),每种类型的 Url 均有值。
示例:
{"TaskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890","AppId": "1234567890","Uin": "1000098765","ArchId": "arch-uuid-001","ArchName": "生产环境架构图","CreateTime": "2026-06-17 10:00:00","TotalInstanceCount": 120,"HighRiskCount": 5,"MediumRiskCount": 12,"LowUsedCount": 8,"LowRiskCount": 95,"InstanceItems": [{"Product": "cvm","ProductName": "云服务器","TotalCount": 80,"Rate": 66.67},{"Product": "cbs","ProductName": "云硬盘","TotalCount": 40,"Rate": 33.33}],"RiskItems": [{"Product": "cvm","ProductName": "云服务器","MetricItems": [{"Metric": "CPUUsage","MetricName": "CPU利用率","HighCount": 3,"MediumCount": 5},{"Metric": "MemUsage","MetricName": "内存利用率","HighCount": 2,"MediumCount": 4}]}],"Files": [{ "Type": "json", "Url": "https://cos.example.com/detail.json?sign=xxx" },{ "Type": "pdf", "Url": "https://cos.example.com/report.pdf?sign=xxx" },{ "Type": "excel", "Url": "https://cos.example.com/data.xlsx?sign=xxx" }]}
明细数据 JSON 文件(Files 中 Type=json 对应的文件内容)结构
字段 | 类型 | 说明 |
taskId | string | 报告任务 ID |
appId | string | 客户 AppID |
uin | string | 客户 UIN |
archId | string | 架构图 UUID |
archName | string | 架构图名称 |
createTime | string | 报告创建时间 |
reportType | int | 内部报告类型:1=标准报告 |
totalInstanceCount | int | 实例总数 |
highRiskCount | int | 高风险实例数 |
mediumRiskCount | int | 中风险实例数 |
lowUsedCount | int | 低使用率实例数 |
lowRiskCount | int | 低风险实例数 |
products | Product[] | 产品维度明细列表 |
Product 产品维度明细
字段 | 类型 | 说明 |
product | string | 产品代号 |
productName | string | 产品中文名 |
nodes | Node[] | 节点列表 |
Node 节点维度明细
字段 | 类型 | 说明 |
nodeName | string | 节点名称 |
nodeId | string | 节点 UUID |
instances | Instance[] | 实例列表 |
Instance 实例维度明细
字段 | 类型 | 说明 |
instanceId | string | 实例 ID |
instanceName | string | 实例名称 |
instanceType | string | 实例规格 |
metrics | Metric[] | 指标列表 |
Metric 指标明细
字段 | 类型 | 说明 |
metricName | string | 指标名称(如 CPU 利用率) |
period | int | 监控周期(天),与架构图配置一致 |
algorithmType | int | 算法类型编码 |
algorithmName | string | 算法名称(如 均值) |
value | string | 指标值,无数据时为 "-" |
rate | string | 环比变化率,无数据时为 "-" |
riskLevel | int | 风险等级:0=低风险,1=低使用率,2=中风险,3=高风险,-1=不支持评估 |
标准报告中,每个指标固定使用架构图配置的监控周期和算法,每个指标对应一条记录。
明细数据 JSON 示例:
{"taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890","appId": "1234567890","uin": "1000098765","archId": "arch-uuid-001","archName": "生产环境架构图","createTime": "2026-06-17 10:00:00","reportType": 1,"totalInstanceCount": 5,"highRiskCount": 1,"mediumRiskCount": 2,"lowUsedCount": 0,"lowRiskCount": 2,"products": [{"product": "cvm","productName": "云服务器","nodes": [{"nodeName": "Web服务集群","nodeId": "node-uuid-001","instances": [{"instanceId": "ins-abc123","instanceName": "web-server-01","instanceType": "S5.MEDIUM4","metrics": [{"metricName": "CPU利用率","period": 14,"algorithmType": 1,"algorithmName": "均值","value": "85.6","rate": "12.3%","riskLevel": 3},{"metricName": "内存利用率","period": 14,"algorithmType": 1,"algorithmName": "均值","value": "72.1","rate": "5.1%","riskLevel": 2}]}]}]}]}
4.2.4 架构负载多维报告
ReportType=6 时,ReportData 结构如下
字段 | 类型 | 说明 |
TaskId | string | 报告任务 ID |
AppId | string | 客户 AppID |
Uin | string | 客户 UIN |
ArchId | string | 架构图 UUID |
ArchName | string | 架构图名称 |
CreateTime | string | 报告创建时间,格式 yyyy-MM-dd HH:mm:ss |
TotalInstanceCount | int | 实例总数 |
HighRiskCount | int | 高风险实例数 |
MediumRiskCount | int | 中风险实例数 |
LowUsedCount | int | 低使用率实例数 |
LowRiskCount | int | 低风险实例数 |
InstanceItems | InstanceItem[] | 产品实例概览列表(最多展示8个产品,超出合并为 other) |
RiskItems | RiskItem[] | 风险指标汇总列表,按高风险数降序排列 |
Files | ReportFile[] | 报告文件预签名 URL 列表 |
InstanceItem 产品实例概览
字段 | 类型 | 说明 |
Product | string | 产品代号,如 cvm、cbs |
ProductName | string | 产品中文名,如 云服务器 |
TotalCount | int | 该产品实例总数 |
Rate | float32 | 该产品实例占比(百分比,如 66.67 表示 66.67%) |
RiskItem 风险指标汇总
字段 | 类型 | 说明 |
Product | string | 产品代号 |
ProductName | string | 产品中文名 |
MetricItems | RiskMetricItem[] | 该产品的风险指标明细 |
RiskMetricItem 风险指标明细
字段 | 类型 | 说明 |
Metric | string | 指标英文代号,如 CPUUsage |
MetricName | string | 指标中文名,如 CPU 利用率 |
HighCount | int | 高风险实例数 |
MediumCount | int | 中风险实例数 |
ReportFile 报告文件
字段 | 类型 | 说明 |
Type | string | 文件类型:JSON PDF Excel |
Url | string | 预签名 URL,有效期24小时;无该类型文件时 Url 为空字符串 |
多维报告不生成 PDF 文件,Files 中 Type=pdf 的 Url 为空字符串,仅包含 json(明细数据)和 excel 两种文件。
示例:
{"TaskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890","AppId": "1234567890","Uin": "1000098765","ArchId": "arch-uuid-001","ArchName": "生产环境架构图","CreateTime": "2026-06-17 10:00:00","TotalInstanceCount": 120,"HighRiskCount": 5,"MediumRiskCount": 12,"LowUsedCount": 8,"LowRiskCount": 95,"InstanceItems": [{"Product": "cvm","ProductName": "云服务器","TotalCount": 80,"Rate": 66.67},{"Product": "cbs","ProductName": "云硬盘","TotalCount": 40,"Rate": 33.33}],"RiskItems": [{"Product": "cvm","ProductName": "云服务器","MetricItems": [{"Metric": "CPUUsage","MetricName": "CPU利用率","HighCount": 3,"MediumCount": 5},{"Metric": "MemUsage","MetricName": "内存利用率","HighCount": 2,"MediumCount": 4}]}],"Files": [{ "Type": "json", "Url": "https://cos.example.com/detail.json?sign=xxx" },{ "Type": "pdf", "Url": "" },{ "Type": "excel", "Url": "https://cos.example.com/data.xlsx?sign=xxx" }]}
明细数据 JSON 文件(Files 中 Type=json 对应的文件内容)结构
字段 | 类型 | 说明 |
taskId | string | 报告任务 ID |
appId | string | 客户 AppID |
uin | string | 客户 UIN |
archId | string | 架构图 UUID |
archName | string | 架构图名称 |
createTime | string | 报告创建时间 |
reportType | int | 内部报告类型:2=多维报告 |
totalInstanceCount | int | 实例总数 |
highRiskCount | int | 高风险实例数 |
mediumRiskCount | int | 中风险实例数 |
lowUsedCount | int | 低使用率实例数 |
lowRiskCount | int | 低风险实例数 |
products | Product[] | 产品维度明细列表 |
Product 产品维度明细
字段 | 类型 | 说明 |
product | string | 产品代号 |
productName | string | 产品中文名 |
nodes | Node[] | 节点列表 |
Node 节点维度明细
字段 | 类型 | 说明 |
nodeName | string | 节点名称 |
nodeId | string | 节点 UUID |
instances | Instance[] | 实例列表 |
Instance 实例维度明细
字段 | 类型 | 说明 |
instanceId | string | 实例 ID |
instanceName | string | 实例名称 |
instanceType | string | 实例规格 |
metrics | Metric[] | 指标列表 |
Metric 指标明细
字段 | 类型 | 说明 |
metricName | string | 指标名称(如 CPU 利用率) |
period | int | 监控周期(天),如 7、14、30,按用户创建报告时选择的周期展开 |
algorithmType | int | 算法类型编码 |
algorithmName | string | 算法名称(如 P95、均值、最大值),按用户创建报告时选择的算法展开 |
value | string | 指标值,无数据时为 "-" |
rate | string | 环比变化率,无数据时为 "-" |
riskLevel | int | 风险等级:0=低风险,1=低使用率,2=中风险,3=高风险,-1=不支持评估 |
多维报告中,每个指标按用户选择的周期×算法组合展开为多条记录。例如用户选择了3个周期(7天、14天、30天)和1种算法(P95),则该指标会产生3条 Metric 记录,分别对应不同周期的 P95 值。
明细数据 JSON 示例:
{"taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890","appId": "1234567890","uin": "1000098765","archId": "arch-uuid-001","archName": "生产环境架构图","createTime": "2026-06-17 10:00:00","reportType": 2,"totalInstanceCount": 5,"highRiskCount": 1,"mediumRiskCount": 2,"lowUsedCount": 0,"lowRiskCount": 2,"products": [{"product": "cvm","productName": "云服务器","nodes": [{"nodeName": "Web服务集群","nodeId": "node-uuid-001","instances": [{"instanceId": "ins-abc123","instanceName": "web-server-01","instanceType": "S5.MEDIUM4","metrics": [{"metricName": "CPU利用率","period": 7,"algorithmType": 5,"algorithmName": "P95","value": "85.6","rate": "12.3%","riskLevel": 3},{"metricName": "CPU利用率","period": 14,"algorithmType": 5,"algorithmName": "P95","value": "78.2","rate": "5.1%","riskLevel": 2},{"metricName": "CPU利用率","period": 30,"algorithmType": 5,"algorithmName": "P95","value": "72.0","rate": "-2.4%","riskLevel": 0}]}]}]}]}
响应说明
HTTP 200 视为投递成功
非 2xx 或网络错误视为投递失败,5xx/429/网络错误会自动重试(最多3次),4xx 不重试
投递日志记录在 webhook_push_log 表中,content 列包含完整的 Header/Request/Response 快照