› › ›

更新列表容器

edit

更新列表容器edit

更新现有的列表容器。

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

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

请求 URLedit

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

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

请求主体edit

一个 JSON 对象，其中包含

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

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

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

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

示例请求edit

更新 name 字段

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

响应代码edit

200: 表示成功调用。

响应有效载荷edit

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

示例响应

{
  "_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
}

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