- 最新动态
- 功能总览
- 服务公告
- 技术画册
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
-
API参考
- 使用前必读
- 如何调用API
-
API说明
-
资产管理
- 统计资产信息,账号、端口、进程等
- 查询账号信息列表
- 查询开放端口统计信息
- 呈现某一端口详细信息
- 查询进程列表
- 查询软件列表
- 查询自启动项信息
- 查询账号的服务器列表
- 查询单服务器的开放端口列表
- 查询软件的服务器列表
- 查询自启动项的服务列表
- 获取账户变动历史信息
- 获取软件信息的历史变动记录
- 获取自启动项的历史变动记录
- 资产指纹-进程-服务器列表
- 资产指纹-端口-服务器列表
- 查询指定中间件的服务器列表
- 查询中间件列表
- 查询资产全局扫描任务状态
- 创建全局资产扫描任务
- 资产管理-资产指纹-内核模块的服务器列表
- 资产管理-资产指纹-Web框架的服务器列表
- 资产管理-资产指纹-Web站点的服务器列表
- 查询单主机资产指纹采集状态
- 采集单主机资产指纹
- 资产管理-资产指纹-内核模块左侧树
- 资产管理-资产指纹-Web框架左侧树
- 资产管理-资产指纹-Web站点左侧树
- 资产管理-资产指纹-左侧WebAppAndService名称树信息
- 资产管理-资产指纹-右侧WebAppAndService资产信息
- 勒索防护
- 基线检查
- 基线策略
- 配额管理
- 容器管理
- 事件管理
- 入侵检测
- 主机管理
- 容器镜像
- 策略管理
- 网页防篡改
- 标签管理
- 病毒查杀
- 应用防护
- 白名单管理
- 容器安装与配置
- 动态端口蜜罐
- 安装配置
- 集群管理
- 集群风险
- 主机安装与配置
- 公共模块
- IAC风险
- 通用任务模块
- 安全运营
- 漏洞管理
- 基线管理
- 集群防护
- 容器网络隔离信息
- 容器资产
- ProjectConfigs
-
资产管理
- 附录
- SDK参考
- 场景代码示例
-
常见问题
- 产品咨询
-
Agent相关
- 购买HSS会自动安装Agent吗?
- Agent是否和其他安全软件有冲突?
- 如何卸载Agent?
- Agent安装失败应如何处理?
- Agent状态异常应如何处理?
- Agent的默认安装路径是什么?
- Agent运行时占用多少CPU、内存和磁盘资源?
- 购买不同版本HSS,可以共用同一Agent吗?
- 如何查看未安装Agent的主机?
- 企业主机安全升级失败怎么处理?
- 服务器安装Agent后会访问哪些资源?
- 如何使用镜像批量安装Agent?
- 无法访问Windows或Linux版本Agent下载链接?
- 升级Agent失败,提示“替换文件失败”
- 批量安装Agent失败,提示“网络不通”
- 如何验证主机与HSS服务端的网络是否打通成功?
- 防护相关
- 漏洞管理
- 检测与响应
- 异常登录
- 账户暴力破解
- 基线检查
- 网页防篡改
- 容器安全
- 勒索防护
- 区域和可用区
- 安全配置
- 防护配额
- 其他
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
查询容器Kubernetes集群列表
功能介绍
查询容器Kubernetes集群列表
调用方法
请参见如何调用API。
URI
GET /v5/{project_id}/kubernetes/clusters
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID,可通过我的凭证,项目id获取 约束限制: 不涉及 取值范围: 字符长度1-256位 默认取值: 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
enterprise_project_id |
否 |
String |
参数解释: 主机所属的企业项目ID。 企业项目ID默认取值为“0”,表示默认企业项目。如果需要查询所有企业项目下的主机,请传参“all_granted_eps”。如果您只有某个企业项目的权限,则需要传递该企业项目ID,查询该企业项目下的主机,否则会因权限不足而报错。 约束限制: 开通企业项目功能后才需要配置企业项目。 取值范围: 字符长度1-256位 默认取值: 0 |
offset |
否 |
Integer |
偏移量:指定返回记录的开始位置,必须为数字,取值范围为大于或等于0,默认0 |
limit |
否 |
Integer |
参数解释: 每页显示个数 约束限制: 不涉及 取值范围: 取值10-200 默认取值: 10 |
cluster_name |
否 |
String |
集群名称 |
load_agent_info |
否 |
Boolean |
是否加载agent相关信息,默认false |
scene |
否 |
String |
查询场景类型,包含如下: -cluster_risk : 集群风险场景 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
last_update_time |
Long |
最近更新时间 |
total_num |
Integer |
集群总数 |
cluster_info_list |
Array of KubernetesClusterInfo objects |
集群列表 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
id |
cluster_name |
String |
集群名称 |
cluster_id |
String |
集群ID |
cluster_type |
String |
集群类型 |
status |
String |
集群状态,包含如下11种。
|
version |
String |
集群版本 |
total_nodes_number |
Integer |
节点总数 |
active_nodes_number |
Integer |
正常节点数 |
creation_timestamp |
Long |
创建时间戳 |
agent_installed_num |
Integer |
集群下已安装agent节点数 |
agent_install_failed_num |
Integer |
集群下安装失败节点数 |
agent_not_install_num |
Integer |
集群下未安装agent节点数 |
agent_ds_install_status |
String |
集群下agent-ds安装状态,关联agent相关信息时则需同时考虑last_operate_time时间,包含如下2种。
|
agent_ds_failed_reason |
String |
操作失败原因 |
last_operate_timestamp |
Long |
最近操作时间戳,daemonset脚本安装操作时间,间隔10分钟以内时,agent仍处于安装中 |
last_scan_time |
Long |
集群最近一次扫描时间戳 |
sys_vul_num |
Integer |
集群下系统漏洞个数 |
app_vul_num |
Integer |
集群下应用漏洞个数 |
emg_vul_num |
Integer |
集群下应急漏洞个数 |
risk_assess_num |
Integer |
集群下风险评估问题个数 |
sec_comp_num |
Integer |
集群下安全合规问题个数 |
请求示例
无
响应示例
状态码:200
请求已成功
{
"total_num" : 21,
"last_update_time" : 1744311874662,
"cluster_info_list" : [ {
"id" : "1aee3ca1-69f0-4390-a7e5-adcf90e4728f",
"cluster_name" : "yescrypt",
"cluster_id" : "1aee3ca1-69f0-4390-a7e5-adcf90e4728f",
"cluster_type" : "self_built_hw",
"status" : "Available",
"total_nodes_number" : 0,
"active_nodes_number" : 0,
"reation_timestamp" : 1743575464217
} ]
}
状态码
状态码 |
描述 |
---|---|
200 |
请求已成功 |
错误码
请参见错误码。