此操作用来批量重启服务器上的HBlock服务。

前提条件：集群正常工作，所有基础服务正常，并且目标服务器的管理服务（ms）正常。

请求语法

PUT /rest/v1/system/service HTTP/1.1
Date:date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization:authorization

{
    "action": "restart",
    "serverIds": [
        serverId1, 
        serverId2, 
         …, 
         serverIdN
    ],
    "scope": [
        service1, 
        service2, 
         …, 
         serviceN
    ],
    "force": force
}

请求参数

响应结果

表1 响应参数success说明

表2 响应参数failed说明

表3 响应参数processing说明

请求示例

重启hblock_3、hblock_4上的HBlock ws和web服务。

PUT /rest/v1/system/server/service HTTP/1.1
Date: Wed, 10 Jun 2026 03:11:10 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 152
Host: 192.168.0.65:1443

{
    "action": "restart",
    "serverIds": [
        "hblock_3",
        "hblock_4"
    ],
    "scope": [
        "ws",
        "web"
    ]
}

响应示例

HTTP/1.1 200 OK 
x-hblock-request-id: cd0cb84090ff4c5aaded5187808da02d
Connection: keep-alive
Content-Length: 486
Date: Wed, 10 Jun 2026 03:11:13 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "success": [
            {
                "action": "stop",
                "serverId": "hblock_3",
                "service": [
                    "ws"
                ]
            },
            {
                "action": "start",
                "serverId": "hblock_3",
                "service": [
                    "ws"
                ]
            },
            {
                "action": "stop",
                "serverId": "hblock_3",
                "service": [
                    "web"
                ]
            },
            {
                "action": "start",
                "serverId": "hblock_3",
                "service": [
                    "web"
                ]
            },
            {
                "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"
                ]
            }
        ]
    }
}