此操作用来批量停止服务器上的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": "stop",
    "serverIds": [
        serverId1, 
        serverId2, 
         …, 
         serverIdN
    ],
    "scope": [
        service1, 
        service2, 
         …, 
         serviceN
    ],
    "force": force
}

请求参数

响应结果

表1 响应参数success说明

表2 响应参数failed说明

表3 响应参数processing说明

请求示例

停止hblock_2、hblock_3上的HBlock ws和web服务。

PUT /rest/v1/system/service HTTP/1.1
Date: Fri, 17 Jul 2026 08:58:44 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 149
Host: 192.168.0.65:1443

{
    "action": "stop",
    "serverIds": [
        "hblock_2",
        "hblock_3"
    ],
    "scope": [
        "ws",
        "web"
    ]
}

响应示例

HTTP/1.1 200 OK 
x-hblock-request-id: 05a7469957104cb2b936d99caea03a84
Connection: keep-alive
Content-Length: 188
Date: Fri, 17 Jul 2026 08:58:46 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "success": [
            {
                "serverId": "hblock_2",
                "service": [
                    "ws"
                ]
            },
            {
                "serverId": "hblock_2",
                "service": [
                    "web"
                ]
            },
            {
                "serverId": "hblock_3",
                "service": [
                    "ws"
                ]
            },
            {
                "serverId": "hblock_3",
                "service": [
                    "web"
                ]
            }
        ]
    }
}