跳转到主要内容
API Explorer|API Explorer
基础设施相关接口/安装器
POSTInstaller起始版本 1.0同步需要认证新增

重置安装器集群

在明确确认后从目标节点重置已有的 ZCF 集群。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • targetObject必填

    目标对象。

    • localBoolean

      目标本地安装器节点。

      示例： true

    • nodesList

      远程ZCF节点探测重置。

      示例： (nested array)

      • roleString

        角色。

        示例： primary

      • fqdnString

        完全限定域名称节点。

        示例： node01.example.com

      • usernameString

        用户名。

        示例： root

      • passwordString

        密码。

        示例： ****

      • sshKeyPathString

        SSH密钥路径。

        示例： /root/.ssh/id_rsa

      • sshPortInteger

        连接。

        示例： 22

    • vipString

      VIP。

      示例： 192.168.1.100

    • vipInterfaceString

      网络接口拥有VIP。

      示例： ens192

    • cloudList

      云。

      示例： (nested array)

      • addressString必填

        地址。

        示例： 192.168.1.50

      • portInteger

        端口号。

        示例： 22

      • userString必填

        按用户过滤。

        示例： root

      • passwordString

        密码。

        示例： ****

  • confirmationString必填

    必需确认短语破坏性执行。

    示例： yes-i-really-mean-it

  • dryRunBoolean必填

    是否仅模拟执行而不实际应用变更。

    示例： true

  • planHashString必填

    计划哈希。

    示例： sha256:abc123

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • statusString

    状态信息。

    示例： planned

  • planString

    人类可读重置计划。

    示例： Reset plan:

  • resetPlanObject

    结构化重置计划。

    • targetsList

      目标列表。

      示例： (nested array)

      • targetString

        目标对象。

        示例： 192.168.1.10

      • localBoolean

        本地。

        示例： false

      • commandsList

        执行目标。

        示例： item1,item2

      • vipCleanupSkippedBoolean

        VIP清理已跳过。

        示例： false

    • cloudList

      UI清理计划。

      示例： (nested array)

      • addressString

        云管理节点地址。

        示例： 192.168.1.50

  • planHashString

    哈希精确重置计划。

    示例： sha256:abc123

  • resultsList

    结果列表。

    示例： (nested array)

    • targetString

      目标对象。

      示例： 192.168.1.10

    • statusString

      状态信息。

      示例： completed

    • errorString

      错误码。操作成功时为 null，失败时返回具体错误信息。

      示例： SSH connect failed

请求地址

POST/api/v1/installer/cluster/reset

/api/v1/installer/cluster/reset

操作 ID

ResetInstallerCluster

永久链接

请求示例

curl -X POST '{host}/api/v1/installer/cluster/reset' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"dryRun":true,"target":{"local":true,"vip":"192.0.2.100","vipInterface":"ens192"}}'

响应示例

200
{
  "status": "planned",
  "plan": "Reset plan:",
  "resetPlan": {}
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史