› › ›

更新列表项

编辑

更新列表项

编辑

更新现有的列表项。

您可以使用 PUT 或 PATCH 方法更新列表项，其中

PUT 替换原始项并删除未指定的字段。
PATCH 更新指定的字段。

请求 URL

编辑

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

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

请求正文

编辑

一个包含以下内容的 JSON 对象：

您要更新的列表项的 id。
您要修改的字段。

如果您调用 PUT 来更新规则，则所有未指定的字段都将被删除。您不能修改 list_id 和 id 字段。

对于 PATCH 调用，可以修改任何字段，而对于 PUT 调用，则需要一些字段。

名称	类型	描述	必需（`PUT` 调用）
`meta`	对象	列表项元数据的占位符。	否
`value`	字符串	用于评估异常的值。有关如何评估列表项异常的信息，请参见创建异常项。	是
`_version`	字符串	`if_seq_no` 和 `if_primary_term` 参数的 Base-64 编码值，用于防止更新冲突（请参见乐观并发控制）。	否
`refresh`	字符串	确定请求所做的更改何时对搜索可见。默认为 `false`。有效值为： `true` `false`	否

示例请求

编辑

更新 value 字段

PATCH api/lists/items
{
  "id": "internal-ip-1",
  "value": "10.0.0.17",
  "_version": "WzEsMV0="
}

响应代码

编辑

200: 指示调用成功。

响应有效负载

编辑

更新后的对象，包括其更新时间。

示例响应

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

« 更新列表容器导出列表项 »