用途:通过 Kibana Streams REST API 读取流信息并管理流生命周期。Streams 是 Kibana 中管理数据的实验性方式,API 与行为可能变化。本技能仅覆盖读取与生命周期操作,创建、更新、删除、fork 等变更操作暂未提供。
主要能力:列出全部流或获取单个流的定义与元数据;读取流的摄取设置;读取查询流的 ES|QL 定义;列出与流关联的附件(仪表板、规则、SLO);启用、禁用、重新同步流。
使用方式:基础路径为 <kibana_url>/api/streams,非默认空间使用 /s/{space_id}/api/streams。读取操作通常无需额外请求头;生命周期操作 POST /api/streams/_disable、_enable、_resync 为变更操作,需按 Kibana 版本要求发送 kbn-xsrf: true。认证使用 API key 或基本认证,读取需 read_stream 权限,生命周期 API 需 manage_stream 权限。
示例: curl -X GET "${KIBANA_URL}/api/streams" -H "Authorization: ApiKey <base64-api-key>" curl -X GET "${KIBANA_URL}/api/streams/my-stream/_query" -H "Authorization: ApiKey <base64-api-key>" curl -X POST "${KIBANA_URL}/api/streams/_resync" -H "Authorization: ApiKey <base64-api-key>" -H "kbn-xsrf: true" -H "Content-Type: application/json" -d '{}'
限制:禁用流可能导致 wired stream 数据丢失(classic stream 数据保留),调用前应警告并确认。设置保留期时默认指流的 lifecycle.dsl.data_retention,而非失败存储保留。显著事件及其检测查询不在本技能范围,相关端点已弃用。查询流定义与显著事件查询不同,勿混淆。详细端点与参数见 references/streams-api-reference.md。