停止主机的 OCP Agent 的工作进程

更新时间：2026-04-14 11:55:54

编辑

功能说明

停止指定主机上 OCP Agent 工作进程。

调用说明

接口约束

调用者需要具备 HOST_MANAGER 权限。

请求路径

POST /compute/hosts/{hostId}/agent/processes/{agentProcessId}/stop

请求参数

path：

参数	类型	必选	示例值	描述
hostId	Long	是	100	主机 ID。
agentProcessId	Long	是	200	Agent 进程 ID。

返回结果

参数	类型	说明
data	Object	详情参见 HostAgentProcess 数据结构。
successful	Boolean	请求是否成功。
timestamp	Datetime	服务端完成请求的时间戳。
duration	Integer	服务端处理请求的时间（毫秒）。
status	Integer	符合 HTTP Status 规范的编码。
traceId	String	请求的 Trace ID，用于排查问题。
server	String	响应请求的应用服务的地址。

HostAgentProcess 数据结构

参数	类型	说明
id	Long	Agent 进程 ID。
hostId	Long	主机 ID。
alias	String	进程别名。
pid	Integer	进程 PID。
user	String	进程用户。
startCommand	String	启动命令。
ports	String	开放端口。
elapsedTime	Long	已存活时间（秒）。
lastActiveTime	String	最近存活时间。
status	String	进程状态，包括：STOPPED、STARTED。
operable	Boolean	是否用户可操作。
logFilePattern	String	日志文件名模版。
createTime	String	创建时间。
updateTime	String	修改时间。

示例

请求示例

POST /compute/hosts/20/agent/processes/100/stop

返回示例

{
    "data": {
        "alias": "obstat2",
        "createTime": "2021-08-03T15:02:44+08:00",
        "elapsedTime": 0,
        "hostId": 20,
        "id": 185,
        "lastActiveTime": "2021-09-03T13:01:28+08:00",
        "logFilePattern": "/home/admin/ocp_agent/log/obstat2.log*",
        "operable": true,
        "pid": 0,
        "ports": null,
        "startCommand": null,
        "status": "STOPPED",
        "updateTime": "2021-08-03T15:03:27+08:00",
        "user": null
    },
    "duration": 3481,
    "server": "a83ad33525",
    "status": 200,
    "successful": true,
    "timestamp": "2021-09-03T13:01:50.465+08:00",
    "traceId": "51b0faa7203d42db"
}