首批通过分布式安全可靠测评,为关键业务系统打造
重启主机的 OCP Agent 的工作进程
更新时间:2023-08-10 11:45:58
功能说明
重启时,指定主机上 OCP Agent 的工作进程。
调用说明
接口约束
调用者需要具备 HOST_MANAGER 权限。
请求路径
POST /compute/hosts/{hostId}/agent/processes/{agentProcessId}/restart
请求参数
| 参数 | 类型 | 必选 | 示例值 | 描述 |
|---|---|---|---|---|
| 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/restart
返回示例
{
"data": {
"alias": "ob_cleaner",
"createTime": "2021-08-03T15:02:44+08:00",
"elapsedTime": 2,
"hostId": 20,
"id": 187,
"lastActiveTime": "2021-09-03T12:58:56.055+08:00",
"logFilePattern": "/home/admin/ocp_agent/log/ob_cleaner.log*",
"operable": true,
"pid": 59304,
"ports": "",
"startCommand": "ob_cleaner",
"status": "STARTED",
"updateTime": "2021-08-25T17:49:28+08:00",
"user": "root"
},
"duration": 12058,
"server": "a83ad33525",
"status": 200,
"successful": true,
"timestamp": "2021-09-03T12:58:56.062+08:00",
"traceId": "b201de8b35b641e9"
}