获取安装器状态
获取当前安装器状态机器状态向导进度。
调试可用性
在线调试
使用当前认证信息和示例参数提交 Mock 请求。
请求参数
此接口无需请求参数。
响应状态
该 API 成功时返回以下响应结构。
versionInteger版本号。
示例： 1
stateString当前状态。
示例： configuring
currentStepInteger当前步骤。
示例： 2
depotConnectedBoolean软件仓库连接成功建立。
示例： true
depotConnectedAtString软件仓库已连接时间。
示例： 2026-01-15T08:00:00Z
wizardConfigObject向导配置信息。
selectedComponentsList已选择组件。
示例： item1,item2
instanceNameString显示名称ZCF安装实例。
示例： my-zcf
deployModeString部署拓扑模式安装。
示例： single
dnsListDNS。
示例： item1,item2
ntpListNTP。
示例： item1,item2
depotModeString软件包源模式安装。
示例： online
depotBaseUrlString软件仓库基础地址。
示例： https://depot.example.com
depotTokenString认证令牌上游软件仓库。
示例： ****
postgresqlObject资源。
nodeObject节点。
roleString角色信息。
示例： primary
fqdnString完全限定域名称节点。
示例： node01.example.com
usernameString用户名。
示例： root
passwordString密码。
示例： ****
sshKeyPathStringSSH键路径。
示例： /root/.ssh/id_rsa
sshPortInteger连接。
示例： 22
portInteger端口号。
示例： 5432
passwordString密码。
示例： ****
imageString容器镜像引用postgre SQL部署。
示例： postgres:14-alpine
dataDirString主机目录postgre SQL数据持久化。
示例： /var/lib/postgresql/data
lifecycleObject资源。
applianceSizeString设备规格。
示例： medium
nodesList资源。
示例： (nested array)
roleString角色信息。
示例： primary
fqdnString完全限定域名称节点。
示例： node01.example.com
usernameString用户名。
示例： root
passwordString密码。
示例： ****
sshKeyPathStringSSH键路径。
示例： /root/.ssh/id_rsa
sshPortInteger连接。
示例： 22
vipStringVIP。
示例： 192.168.1.100
adminPasswordString管理员账户密码敏感。
示例： ****
idpObjectIdP。
applianceSizeString设备资源剖析IdP实例。
示例： small
nodesList资源。
示例： (nested array)
roleString角色信息。
示例： primary
fqdnString完全限定域名称节点。
示例： node01.example.com
usernameString用户名。
示例： root
passwordString密码。
示例： ****
sshKeyPathStringSSH键路径。
示例： /root/.ssh/id_rsa
sshPortInteger连接。
示例： 22
vipString虚拟IP地址HA IdP访问。
示例： 192.168.1.101
adminPasswordStringIdP管理员账户密码敏感。
示例： ****
rootPasswordStringIdP根账户密码敏感。
示例： ****
extensionsList扩展配置条目。
示例： (nested array)
componentTypeString标识符扩展。
示例： monitoring
versionString版本号。
示例： 1.2.0
applianceSizeString设备资源剖析扩展。
示例： small
nodesList资源。
示例： (nested array)
roleString角色信息。
示例： primary
fqdnString完全限定域名称节点。
示例： node01.example.com
usernameString用户名。
示例： root
passwordString密码。
示例： ****
sshKeyPathStringSSH键路径。
示例： /root/.ssh/id_rsa
sshPortInteger连接。
示例： 22
vipString虚拟IP HA扩展访问。
示例： 192.168.1.102
adminPasswordString扩展敏感。
示例： ****
cloudObject资源。
nodeIpStringIP地址云管理节点。
示例： 192.168.1.50
usernameString用户名。
示例： admin
passwordString密码。
示例： ****
envLinkedHashMap环境配置。
示例： (nested object)
versionPinsList资源。
示例： (nested array)
productString资源。
示例： value
versionString版本号。
示例： value
releaseString资源。
示例： value
downloadsLinkedHashMap下载次数。
示例： (nested object)
*Object键值映射对象。
precheckObject资源。
idString资源ID。
示例： precheck-a1b2c3d4
statusString状态信息。
示例： passed
resultsList结果列表。
示例： (nested array)
nameString资源名称。
示例： agent-connectivity
passedBoolean检查条目已通过。
示例： true
messageString错误返回消息。
示例： All agents are reachable
fixString修复。
示例： Ensure all agents have active heartbeats before proceeding
deployObject资源。
idString资源ID。
示例： deploy-a1b2c3d4
statusString状态信息。
示例： running
progressInteger整体部署进度百分比0 100。
示例： 55
currentPhaseString名称当前执行中部署阶段。
示例： installing-postgresql
currentComponentString名称组件当前已部署。
示例： postgresql
startedAtString开始时间。
示例： 2026-01-15T08:00:00Z
completedAtString完成时间。
示例： 2026-01-15T08:00:00Z
logsList日志。
示例： (nested array)
timeString时间。
示例： 2026-04-16T10:00:00Z
levelString级别。
示例： INFO
messageString错误返回消息。
示例： PostgreSQL installation complete
registrationsList资源。
示例： (nested array)
nameString资源名称。
示例： postgresql
endpointString接收端地址。
示例： 192.168.1.10:5432
statusString状态信息。
示例： registered
registeredAtString注册时间。
示例： 2026-01-15T08:00:00Z
errorString错误码。操作成功时为 null，失败时返回具体错误信息。
示例： connection timeout
errorString错误码。操作成功时为 null，失败时返回具体错误信息。
示例： SSH connection refused
updatedAtString更新时间。
示例： 2026-01-15T08:00:00Z
请求地址
GET/api/v1/installer/state
/api/v1/installer/state
请求示例
curl -X GET '{host}/api/v1/installer/state' -H 'Authorization: Bearer {token}'
响应示例
200{
"version": 1,
"state": "configuring",
"currentStep": 2,
"depotConnected": true,
"depotConnectedAt": "example",
"wizardConfig": {},
"downloads": null,
"precheck": {}
}变更历史
此 API 暂无变更历史记录。