# 滚动重启（已废弃） - RollingRestart #### 功能介绍 该接口用于Elasticsearch/Opensearch集群滚动重启指定类型的节点。 #### 接口约束 - 仅当集群的节点数量（含Master节点、Client节点和冷数据节点）大于3时，才支持滚动重启。当集群处于可用状态时，确认集群已停止处理业务数据（如导入数据、搜索数据），否则重启集群时可能导致数据丢失等。滚动重启过程中，需要等待已重启的节点加入集群且索引变为Green状态，在索引数量比较多的情况下耗时较长。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-css/css_03_0077.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-css/css_03_0096.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | css:cluster:rollingReboot | Write | cluster \* | - g:EnterpriseProjectId - g:ResourceTag/\ | css:cluster:rollingRestart | - | #### URI POST /v2.0/{project_id}/clusters/{cluster_id}/rolling_restart 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-css/css_03_0071.html)。 **约束限制**： 不涉及 **取值范围**： 账号的项目ID，长度为32个字符，由小写字母和数字组成。 **默认取值**： 不涉及 | | cluster_id | 是 | String | **参数解释**： 指定重启集群ID。获取方法请参见[获取集群ID](https://support.huaweicloud.com/api-css/css_03_0101.html)。 **约束限制**： UUID格式，36个字符。 **取值范围**： 集群ID。 **默认取值**： 不涉及 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | type | 是 | String | **参数解释**： 滚动重启操作类型，仅支持role。 **约束限制**： 不涉及 **取值范围**： role: 表示按照角色重启。 **默认取值**： 不涉及 | | value | 是 | String | **参数解释**： 角色类型，多个类型使用英文逗号隔开。 **约束限制**： ess，ess-cold，all至少选择一个节点类型。 **取值范围**： - ess：数据节点。 - ess-cold：冷数据节点。 - ess-client：Client节点。 - ess-master：Master节点。 - all：所有节点。 **默认取值**： 不涉及 | #### 响应参数 **状态码：200** 请求已成功。 无 #### 请求示例 重启节点。 ``` POST https://{Endpoint}/v2.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/rolling_restart { "type" : "role", "value" : "ess" } ``` #### 响应示例 无 #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求已成功。 | | 400 | 非法请求。 建议直接修改该请求，不要重试该请求。 | | 409 | 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 | | 412 | 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-css/css_03_0076.html)。