更新时间:2026-01-12 GMT+08:00

节点替换

功能介绍

该接口用于替换失败节点。

当Elasticsearch集群中的节点发生故障时,可以执行“替换指定节点”任务修复故障节点。

替换指定节点的变更流程:

  1. 将待替换节点的数据迁移到其他可用节点。

  2. 按照原节点的ID、IP地址、规格、节点可用区等信息重建节点。

  3. 将节点重新加入集群,系统自动触发分片重平衡机制,逐步将部分数据分片迁移

至该节点。

由于会迁移数据,因此整个变更过程不会中断业务。

在替换指定节点前,建议备份所有关键数据,以免造成数据丢失。

调用方法

请参见如何调用API

URI

PUT /v1.0/{project_id}/clusters/{cluster_id}/instance/{instance_id}/replace

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

cluster_id

String

参数解释

指定替换集群ID。获取方法请参见获取集群ID

约束限制

不涉及

取值范围

集群ID。

默认取值

不涉及

instance_id

String

参数解释

指定替换节点ID。

约束限制

不涉及

取值范围

节点ID。通过查询集群详情获取instances中的ID属性。

默认取值

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

migrateData

String

参数解释

是否迁移数据。

约束限制

不涉及

取值范围

  • true:迁移数据。

  • false:不迁移数据。

默认取值

true

agency

String

参数解释

委托名称,委托给CSS服务,允许CSS调用您的其他云服务。

约束限制

  • 委托需要有VPC的操作权限:"vpc:subnets:get","vpc:ports:*"。

  • 对接了IAM新平面:该参数必填,对接IAM旧平面时该参数可选。

  • 无法配置含特殊字符和中文字符的委托,允许使用的委托名称仅可包含a-zA-Z0-9-_字符。

取值范围

不涉及

默认取值

不涉及

请求参数

响应参数

状态码:200

请求已成功。

请求示例

节点替换。

PUT https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/instance/43e63449-339c-4280-a6e9-da36b0685995/replace?migrateData=true

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

404

所请求的资源不存在。

建议直接修改该请求,不要重试该请求。

错误码

请参见错误码