文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 安全运营/ 查询集群的安全体检报告信息 - ShowSecurityCheckClusterReport
更新时间:2025-10-31 GMT+08:00
分享

查询集群的安全体检报告信息 - ShowSecurityCheckClusterReport

功能介绍

查询集群的安全体检报告信息

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/security-check/containers/cluster-reports/{report_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

report_id

String

参数解释

集群的安全体检报告ID

约束限制

不涉及

取值范围

字符长度1-64位

默认取值

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

参数解释:

企业项目ID,用于过滤不同企业项目下的资产。获取方式请参见获取企业项目ID

如需查询所有企业项目下的资产请传参“all_granted_eps”。

约束限制:

开通企业项目功能后才需要配置企业项目ID参数。

取值范围:

字符长度1-256位

默认取值:

0,表示默认企业项目(default)。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

x-language

String

language

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

scan_time

Long

参数解释

体检时间

取值范围

不涉及

cluster_id

String

参数解释

集群ID

取值范围

不涉及

cluster_name

String

参数解释

集群名称

取值范围

不涉及

cluster_category

String

参数解释

集群类型

取值范围

  • CCE:CCE Standard集群

  • Turbo:CCE Turbo集群

local_image_vul_num

Integer

参数解释

本地镜像漏洞风险数量

取值范围

不涉及

risk_config_num

Integer

参数解释

基线风险数量

取值范围

不涉及

privileged_container_num

Integer

参数解释

特权容器数量

取值范围

不涉及

pod_num

Integer

参数解释

pod数量

取值范围

不涉及

host_num

Integer

参数解释

节点数量

取值范围

不涉及

container_num

Integer

参数解释

容器数量

取值范围

不涉及

port_num

Integer

参数解释

端口数量

取值范围

不涉及

process_num

Integer

参数解释

进程数量

取值范围

不涉及

app_num

Integer

参数解释

软件数量

取值范围

不涉及

local_image_vul_list

Array of ClusterSecurityCheckLocalImageVulInfo objects

参数解释

本地镜像漏洞列表

取值范围

不涉及

baseline_detection_list

Array of ClusterSecurityCheckBaseLineDetectionInfo objects

参数解释

基线检测列表

取值范围

不涉及

privileged_container_list

Array of ClusterSecurityCheckPrivilegedContainerInfo objects

参数解释

特权容器列表

取值范围

不涉及

port_list

Array of ClusterSecurityCheckPortInfo objects

参数解释

端口列表

取值范围

不涉及

app_list

Array of ClusterSecurityCheckAppInfo objects

参数解释

软件列表

取值范围

不涉及

process_list

Array of ClusterSecurityCheckProcessInfo objects

参数解释

进程列表

取值范围

不涉及

表5 ClusterSecurityCheckLocalImageVulInfo

参数

参数类型

描述

local_image_name

String

参数解释

本地镜像名称

取值范围

不涉及

local_image_version

String

参数解释

本地镜像版本

取值范围

不涉及

local_image_size

Long

参数解释

本地镜像大小

取值范围

不涉及

vul_name

String

参数解释

漏洞名称

取值范围

不涉及

app_name

String

参数解释

软件名称

取值范围

不涉及

app_version

String

参数解释

软件版本

取值范围

不涉及

severity_level

String

参数解释

漏洞危险程度

取值范围

  • High:高危漏洞

  • Medium:中危漏洞

  • Low:低危漏洞

solution

String

参数解释

漏洞解决方案

取值范围

不涉及

vul_description

String

参数解释

漏洞描述

取值范围

不涉及

表6 ClusterSecurityCheckBaseLineDetectionInfo

参数

参数类型

描述

severity

String

参数解释

基线风险级别

取值范围

  • High:高危基线

  • Medium:中危基线

  • Low:低危基线

check_name

String

参数解释

基线名称

取值范围

不涉及

check_type

String

参数解释

基线类型

取值范围

不涉及

standard

String

参数解释

标准类型

取值范围

  • hw_standard:云安全实践

  • cn_standard:等保合规

  • cis_standard:通用安全标准

check_rule_num

Integer

参数解释

检查项数量

取值范围

不涉及

failed_rule_num

Integer

参数解释

风险项数量

取值范围

不涉及

check_type_desc

String

参数解释

基线描述信息

取值范围

不涉及

baseline_item_list

Array of ClusterSecurityCheckBaselineItemInfo objects

参数解释

基线检测列表

取值范围

不涉及

表7 ClusterSecurityCheckBaselineItemInfo

参数

参数类型

描述

severity

String

参数解释

检查项风险等级

取值范围

  • High:高危

  • Medium:中危

  • Low:低危

check_item

String

参数解释

检查项

取值范围

不涉及

check_description

String

参数解释

检查描述

取值范围

不涉及

check_remediation

String

参数解释

修复建议

取值范围

不涉及

表8 ClusterSecurityCheckPrivilegedContainerInfo

参数

参数类型

描述

container_name

String

参数解释

容器名称

取值范围

不涉及

container_id

String

参数解释

容器ID

取值范围

不涉及

container_status

String

参数解释

容器状态

取值范围

  • running:运行中

  • terminated:已结束

pod_name

String

参数解释

pod名称

取值范围

不涉及

host_name

String

参数解释

节点名称

取值范围

不涉及

private_ip

String

参数解释

私有IP地址

取值范围

不涉及

public_ip

String

参数解释

公有IP地址

取值范围

不涉及

event_abstract

String

参数解释

事件摘要

取值范围

不涉及

表9 ClusterSecurityCheckPortInfo

参数

参数类型

描述

port

Integer

参数解释

端口号

取值范围

不涉及

container_id

String

参数解释

容器ID

取值范围

不涉及

container_name

String

参数解释

容器名称

取值范围

不涉及

pod_name

String

参数解释

pod名称

取值范围

不涉及

host_name

String

参数解释

节点名称

取值范围

不涉及

private_ip

String

参数解释

私有IP地址

取值范围

不涉及

public_ip

String

参数解释

公有IP地址

取值范围

不涉及

path

String

参数解释

程序文件

取值范围

不涉及

pid

Integer

参数解释

进程PID

取值范围

不涉及

laddr

String

参数解释

监听IP

取值范围

不涉及

表10 ClusterSecurityCheckAppInfo

参数

参数类型

描述

app_name

String

参数解释

软件名称

取值范围

不涉及

app_version

String

参数解释

软件版本

取值范围

不涉及

container_id

String

参数解释

容器ID

取值范围

不涉及

container_name

String

参数解释

容器名称

取值范围

不涉及

host_name

String

参数解释

节点名称

取值范围

不涉及

private_ip

String

参数解释

私有IP地址

取值范围

不涉及

public_ip

String

参数解释

公有IP地址

取值范围

不涉及

update_time

Long

参数解释

更新时间

取值范围

不涉及

recent_scan_time

Long

参数解释

最近扫描时间

取值范围

不涉及

表11 ClusterSecurityCheckProcessInfo

参数

参数类型

描述

container_id

String

参数解释

容器ID

取值范围

不涉及

container_name

String

参数解释

容器名称

取值范围

不涉及

host_name

String

参数解释

节点名称

取值范围

不涉及

private_ip

String

参数解释

私有IP地址

取值范围

不涉及

public_ip

String

参数解释

公有IP地址

取值范围

不涉及

start_time

Long

参数解释

启动时间

取值范围

不涉及

pid

Integer

参数解释

进程PID

取值范围

不涉及

permission

String

参数解释

文件权限

取值范围

不涉及

user_name

String

参数解释

运行用户

取值范围

不涉及

launch_params

String

参数解释

启动参数

取值范围

不涉及

hash

String

参数解释

文件hash

取值范围

不涉及

请求示例

响应示例

状态码:200

请求已成功

{
  "scan_time" : 1745051197000,
  "cluster_id" : "27716-6331ef-02c62-11958-f55d39",
  "cluster_name" : "test-cluster",
  "cluster_category" : "CCE",
  "local_image_vul_num" : 1,
  "risk_config_num" : 1,
  "privileged_container_num" : 1,
  "pod_num" : 1,
  "host_num" : 1,
  "container_num" : 1,
  "port_num" : 1,
  "process_num" : 1,
  "app_num" : 1,
  "local_image_vul_list" : {
    "local_image_name" : "test-image",
    "local_image_version" : "1.0.0",
    "local_image_size" : 10,
    "vul_name" : "test-vul",
    "app_name" : "test-app",
    "app_version" : "1.0.0",
    "severity_level" : "Low",
    "solution" : "solution",
    "vul_description" : "description"
  },
  "baseline_detection_list" : [ ],
  "privileged_container_list" : [ ],
  "port_list" : [ ],
  "app_list" : [ ],
  "process_list" : [ ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档