› › ›

终止进程

编辑

终止进程

编辑

终止在运行 Elastic Defend 或受支持的第三方代理类型的主机上的进程。

您必须拥有 进程操作 权限和企业版许可证才能执行此操作。

请求 URL

编辑

POST <kibana 主机>:<端口>/api/endpoint/action/kill_process

请求正文

编辑

具有以下字段的 JSON 对象

名称	类型	描述	必填
`endpoint_ids`	数组（字符串）	您要在此处发出此操作的端点的 ID。	是
`agent_type`	字符串	主机正在运行的代理类型。接受的值为 `endpoint`（默认） `sentinel_one`（目前处于技术预览阶段）	否
`alert_ids`	数组（字符串）	如果此操作与任何警报相关联，则可以在此处指定它们。此操作将在与指定的警报相关联的任何情况下记录。	否
`case_ids`	数组（字符串）	将记录所采取操作的案例的 ID。	否
`comment`	字符串	将注释附加到此操作的日志。注释文本将显示在关联的案例中。	否
`parameters.pid`	数字	要终止的进程的进程 ID (PID)。	是，必须提供 `parameters.pid` 或 `parameters.entity_id`，但不能同时提供两者
`parameters.entity_id`	字符串	要终止的进程的实体 ID。	是，必须提供 `parameters.pid` 或 `parameters.entity_id`，但不能同时提供两者
`parameters.process_name`	字符串	仅限 SentinelOne `agent_type`。要终止的进程的名称。	是。这是 SentinelOne 接受的唯一参数

示例请求

编辑

终止实体 ID 为 abc123 的进程，该进程位于主机上，该主机的 endpoint_id 值为 ed518850-681a-4d60-bb98-e22640cae2a8，并带有注释 terminate the process

POST /api/endpoint/action/kill_process
{
  "endpoint_ids": ["ed518850-681a-4d60-bb98-e22640cae2a8"],
  "parameters": {
    "entity_id": "abc123"
  },
  "comment": "terminate the process"
}

响应代码

编辑

200: 表示调用成功。
403: 表示用户权限不足（需要 进程操作），或许可证级别不受支持（需要企业版许可证）。
500: 一般错误。响应消息将提供更多详细信息。

响应有效负载

编辑

包含创建的响应操作详细信息的 JSON 对象。

示例响应

编辑

{
  "data": {
    "id": "233db9ea-6733-4849-9226-5a7039c7161d",
    "agents": ["ed518850-681a-4d60-bb98-e22640cae2a8"],
    "command": "kill-process",
    "agentType": "endpoint",
    "isExpired": false,
    "isCompleted": true,
    "wasSuccessful": true,
    "errors": [],
    "startedAt": "2022-07-29T19:08:49.126Z",
    "completedAt": "2022-07-29T19:09:44.961Z",
    "outputs": {
      "ed518850-681a-4d60-bb98-e22640cae2a8": {
        "type": "json",
        "content": {
          "key": "value"
        }
      }
    },
    "createdBy": "myuser",
    "comment": "terminate the process",
    "parameters": {
      "entity_id": "abc123"
    }
  }
}

« 释放隔离主机挂起进程 »