查询云服务节点信息（getCloudServiceInfo）#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

读取中心配置的云服务节点列表与推荐节点域名，供设备/采集服务器管理页的「云服务域名」下拉选择与新建表单默认值使用。该端点在匿名放行清单内，App 在未登录引导阶段也可调用，但响应内容完全由服务端部署配置决定。

使用位置#

页面/功能	消费字段
采集设备列表页（请求 + nodes[].domainName 作筛选下拉选项）	nodes[].domainName
采集设备新增页（请求 + recommendNodeDomainName 作表单默认值、下拉选项）	recommendNodeDomainName、nodes[].domainName
采集设备编辑页（请求 + 下拉选项）	nodes[].domainName
采集服务器列表页（请求 + 下拉选项）	nodes[].domainName
采集服务器新增页（请求 + 表单默认值、下拉选项）	recommendNodeDomainName、nodes[].domainName
采集服务器编辑页（请求 + 下拉选项）	nodes[].domainName

对应 inventory operationId：http-get-main-service-main-api-v1-general-configuration-base-getcloudserviceinfo-56daef82（合并交接时由整合票 20 认领并发布本正本）。

端点#

GET /main-service/main-api/v1/general/configuration/base/getCloudServiceInfo — 读取中心配置的云服务节点列表与推荐节点域名，供设备/采集服务器管理页的「云服务域名」下拉选择与新建表单默认值使用。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 configuration · v1-general 通用接口（v1）；业务语义（wire 惯例、限频、租户声明等）见配置业务 · v1-general 通用接口（v1）。

动线与完成判据#

HTTP 响应 status=200 且 data.nodes 可解析即完成。只读配置，无副作用；Web 以 useRequest 请求（设备列表页节流 500ms）。配置缺 cloud-service.nodes 或为空时服务端以部署参数构造单个 master 兜底节点，nodes 至少一项（见业务页）。

错误与边界#

• 无输入校验失败面；匿名可达意味着无法按账号限制读取节点拓扑信息，App 侧不应把本响应当作机密数据缓存或外发。
• 服务端技术异常适用未处理技术异常；认证/权限族出口对本路径不适用（permitAll）。
• recommendNodeDomainName 可为空串/缺失（取决于配置）；Web 直接把空值写入表单，App 应做同样兼容。

调用关系与资源清理#

无订阅、无长连接资源。所选 cloudServiceDomainName 随设备/采集服务器表单提交，由采集服务器保存、设备保存等设备与资产域写正本落库；本页不展开那些写操作。

已知缺口#

1. cloud-service.* 的部署配置样例、节点数与多地域语义未核验（部署侧证据）。
2. 未执行真实 HTTP 联调。