› › ›

更新列表容器

编辑

更新列表容器

编辑

更新现有的列表容器。

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

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

请求 URL

编辑

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

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

请求正文

编辑

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

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

如果您调用 PUT 来更新规则，则会删除所有未指定的字段。您无法修改 id 和 type 字段。

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

名称	类型	描述	必需（`PUT` 调用）
`description`	字符串	描述列表容器。	是
`meta`	对象	列表容器元数据的占位符。	否
`name`	字符串	列表容器的名称。	是
`_version`	字符串	`if_seq_no` 和 `if_primary_term` 参数的 Base-64 编码值，用于防止更新冲突（请参阅乐观并发控制）。	否

示例请求

编辑

更新 name 字段

PATCH api/lists
{
  "id": "internal-ip-excludes",
  "name": "Trusted internal IP addresses",
  "_version": "WzYsMV0="
}

响应代码

编辑

200: 表示调用成功。

响应有效负载

编辑

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

示例响应

{
  "_version": "WzcsMV0=",
  "created_at": "2020-08-11T10:38:51.087Z",
  "created_by": "elastic",
  "description": "Contains list items that exclude internal IP addresses from detection rule matches.",
  "id": "internal-ip-excludes-meta",
  "immutable": false,
  "name": "Trusted internal IP addresses",
  "tie_breaker_id": "195f54fb-244d-4f9a-9a5b-e728901347e0",
  "type": "ip",
  "updated_at": "2020-08-11T10:42:30.205Z",
  "updated_by": "elastic",
  "version": 2
}

« 获取列表项更新列表项 »