重启单个服务器上的HBlock服务
更新时间 2026-08-17 09:47:46
最近更新时间: 2026-08-17 09:47:46
本节主要介绍如何使用API重启单个服务器上的HBlock服务。
此操作用来重启单个服务器上的HBlock服务。
前提条件:集群正常工作,所有基础服务正常,并且目标服务器的管理服务(ms)正常。
请求语法
PUT /rest/v1/system/server/serverId/restart HTTP/1.1
Date:date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization:authorization
{
"scope": [
service1,
service2,
…,
serveiceN
],
"force": force
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| serverId | String | 需要重启HBlock服务的服务器ID。 | 是 |
| scope | Array of string | 重启的HBlock服务范围。 取值:
默认值为Min。 注意 web服务与ms服务存在依赖关系,重启ms服务时web服务的处理规则如下:
说明 各服务具体作用详见HBlock服务。 | 否 |
| force | Boolean | 是否强制重启服务上的HBlock服务。 注意 强制重启HBlock服务,可能会造成数据丢失。 取值:
默认值为false。 | 否 |
响应结果
| 名称 | 类型 | 描述 |
|---|---|---|
| success | Array of success | 重启成功的HBlock服务信息,详见“表1 响应参数success说明”。 |
| failed | Array of failed | 重启失败的HBlock服务信息,详见“表2 响应参数failed说明”。 |
| processing | Array of processing | 重启操作未完成的HBlock服务信息,详见“表3 响应参数processing说明”。 |
表1 响应参数success说明
| 名称 | 类型 | 描述 |
|---|---|---|
| action | String | 执行的操作:
|
| serverId | String | HBlock服务停止/启动成功的服务器。 |
| service | Array of string | 停止/启动成功的HBlock服务。 |
表2 响应参数failed说明
| 名称 | 类型 | 描述 |
|---|---|---|
| action | String | 执行的操作:
|
| serverId | String | HBlock服务停止/启动失败的服务器。 |
| service | Array of string | 停止/启动失败的HBlock服务。 |
| reason | String | HBlock服务停止/启动失败的原因。 |
表3 响应参数processing说明
| 名称 | 类型 | 描述 |
|---|---|---|
| action | String | 执行的操作:
|
| serverId | String | HBlock服务停止/启动操作未完成的服务器。 |
| service | Array of string | 停止/启动操作未完成的HBlock服务。 |
请求示例
重启hblock_4上的HBlock ws和web服务。
PUT /rest/v1/system/server/hblock_4/restart HTTP/1.1
Date: Wed, 10 Jun 2026 01:33:25 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 57
Host: 192.168.0.65:1443
{
"scope": [
"ws",
"web"
]
}响应示例
HTTP/1.1 200 OK
x-hblock-request-id: 508e10ef6cac4f4199d0bf6cb0657c02
Connection: keep-alive
Content-Length: 254
Date: Wed, 10 Jun 2026 01:33:29 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"success": [
{
"action": "stop",
"serverId": "hblock_4",
"service": [
"ws"
]
},
{
"action": "start",
"serverId": "hblock_4",
"service": [
"ws"
]
},
{
"action": "stop",
"serverId": "hblock_4",
"service": [
"web"
]
},
{
"action": "start",
"serverId": "hblock_4",
"service": [
"web"
]
}
]
}
}