获取异步 EQL 搜索 API

编辑

获取异步 EQL 搜索 API

编辑

返回异步 EQL 搜索存储的同步 EQL 搜索的当前状态和可用结果。

resp = client.eql.get(
    id="FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM=",
)
print(resp)
response = client.eql.get(
  id: 'FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM='
)
puts response
const response = await client.eql.get({
  id: "FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM=",
});
console.log(response);
GET /_eql/search/FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM=

请求

编辑

GET /_eql/search/<search_id>

先决条件

编辑
  • 如果启用了 Elasticsearch 安全功能,则只有最初提交 EQL 搜索的用户才能使用此 API 检索搜索。
  • 请参阅必需字段

限制

编辑

请参阅EQL 限制

路径参数

编辑
<search_id>

(必需,字符串) 搜索的标识符。

异步搜索的搜索 ID 在EQL 搜索 API的响应中提供。如果请求的keep_on_completion参数为 true,也会提供搜索 ID。

查询参数

编辑
keep_alive

(可选,时间值) 搜索及其结果在集群上存储的时间段。默认为搜索的EQL 搜索 API请求设置的 keep_alive 值。

如果指定,此参数将为搜索设置一个新的 keep_alive 周期,从获取异步 EQL 搜索 API 请求执行时开始。这个新周期会覆盖 EQL 搜索 API 请求中指定的周期。

当此周期到期时,即使搜索正在进行,搜索及其结果也会被删除。

wait_for_completion_timeout

(可选,时间值) 等待请求完成的超时时长。默认为无超时,这意味着请求会等待完整的搜索结果。

如果指定此参数且请求在此期间完成,则会返回完整的搜索结果。

如果请求在此期间未完成,则响应会返回 is_partial 值为 true 且不包含搜索结果。

响应主体

编辑

异步 EQL 搜索 API 返回与 EQL 搜索 API 相同的响应主体。请参阅 EQL 搜索 API 的响应主体参数