› › ›

查找列表项

查找列表项编辑

检索指定容器中列表项的分页子集。默认情况下，将返回第一页，每页 20 个结果。

请求 URL编辑

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

URL 查询参数编辑

名称	类型	描述	必填
`list_id`	字符串	列表容器的 ID。	是
`page`	整数	要返回的页码。	否
`per_page`	整数	每页返回的项数。	否
`sort_field`	字符串	确定用于对结果进行排序的字段。	否
`sort_order`	字符串	确定排序顺序，可以是 `desc` 或 `asc`。	否
`cursor`	字符串	返回在上次调用中返回的最后一项之后的项（使用上次调用中返回的 `cursor` 值）。此参数使用 `tie_breaker_id` 字段来确保所有项都已正确排序并返回。有关详细信息，请参阅 Search After。	否

示例请求编辑

检索 external-ip-excludes 列表容器中的列表项

GET api/lists/items/_find?list_id=external-ip-excludes

响应代码编辑

200: 表示成功调用。

响应有效负载编辑

{
  "cursor": "WzIwLFsiZmFjZmZmOTQtNzIzZS00YmQ0LTk4ZTUtNzI2OGJjNTA3NWNmIl1d",
  "data": [
    {
      "_version": "WzgsMV0=",
      "created_at": "2020-08-11T11:22:13.670Z",
      "created_by": "elastic",
      "id": "bpdB3XMBx7pemMHopQ6M",
      "list_id": "internal-ip-excludes-meta",
      "tie_breaker_id": "17d3befb-dc22-4b3c-a286-b5504c4fbeeb",
      "type": "ip",
      "updated_at": "2020-08-11T11:22:13.670Z",
      "updated_by": "elastic",
      "value": "127.0.0.6"
    },
    {
      "_version": "WzMsMV0=",
      "created_at": "2020-08-11T11:22:13.669Z",
      "created_by": "elastic",
      "id": "aZdB3XMBx7pemMHopQ6L",
      "list_id": "internal-ip-excludes-meta",
      "tie_breaker_id": "26115356-c2c2-4f1c-a4ed-19b81191775a",
      "type": "ip",
      "updated_at": "2020-08-11T11:22:13.669Z",
      "updated_by": "elastic",
      "value": "127.0.0.1"
    },
    ...
    {
      "_version": "WzksMV0=",
      "created_at": "2020-08-11T11:22:13.670Z",
      "created_by": "elastic",
      "id": "b5dB3XMBx7pemMHopQ6M",
      "list_id": "internal-ip-excludes-meta",
      "tie_breaker_id": "facfff94-723e-4bd4-98e5-7268bc5075cf",
      "type": "ip",
      "updated_at": "2020-08-11T11:22:13.670Z",
      "updated_by": "elastic",
      "value": "127.0.0.7"
    }
  ],
  "page": 1,
  "per_page": 20,
  "total": 11
}

« 查找列表容器获取列表容器 »