创建列表项编辑

创建一个列表项并将其与指定的 列表容器 关联。

同一列表容器中的所有列表项必须是同一类型。例如,ip 列表容器中的每个列表项必须定义一个特定的 IP 地址。

在创建列表项之前,您必须先创建一个列表容器。

请求 URL编辑

POST <kibana 主机>:<端口>/api/lists/items

请求正文编辑

包含以下字段的 JSON 对象

名称 类型 描述 必需

id

字符串

列表项的唯一标识符。

否,在未提供时自动创建。

list_id

字符串

关联的 列表容器 的 ID。

meta

对象

列表项元数据的占位符。

value

字符串

用于评估异常的值。有关如何评估列表项异常的信息,请参阅 创建异常项

refresh

字符串

确定请求所做的更改何时对搜索可见。默认为 wait_for。有效值为

  • true
  • false
  • wait_for

示例请求编辑

将 IP 地址添加到 internal-ip-excludes 列表容器

POST api/lists/items
{
  "id": "internal-ip-1",
  "list_id": "internal-ip-excludes",
  "value": "10.0.0.12"
}

将主机名添加到 host.name-container 列表容器

POST api/lists
{
  "id": "win-prem-19",
  "list_id": "host.name-container",
  "value": "hostname-123"
}

响应代码编辑

200
表示成功调用。

响应有效负载编辑

{
  "_version": "WzEsMV0=", 
  "id": "internal-ip-1",
  "type": "ip",
  "value": "10.0.0.12",
  "created_at": "2020-08-11T10:54:46.080Z",
  "created_by": "elastic",
  "list_id": "internal-ip-excludes",
  "tie_breaker_id": "ed3f9d84-cd85-4122-b93d-07d1de4fd8bb",
  "updated_at": "2020-08-11T10:54:46.080Z",
  "updated_by": "elastic"
}

if_seq_noif_primary_term 参数的 base-64 编码值,用于 乐观并发控制。为了确保没有冲突,在 更新列表项 时使用此值。