编辑保留期与设置

curl -X PUT http://localhost:5080/api/v1/streams/$STREAM_ID/settings \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '{
    "retention_days": 30,
    "settings": { "description": "Application logs", "queryable": true }
  }'

curl -X PUT http://localhost:5080/api/v1/streams/$STREAM_ID/settings \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '{
    "retention_days": 30,
    "settings": { "description": "Application logs", "queryable": true }
  }'

PUT /api/v1/streams/{id}/settings

更新数据流的保留期与设置，只发送需要修改的属性。该调用需要 streams.configure。对 _molesignal 系统数据流需要 sys.telemetry.manage，且只能修改保留期、字段索引、提取、遮掩与降采样。 请求体

字段	类型	说明
`retention_days`	integer 或 `null`	1 到 3650 天。`null` 会清除显式值，数据流沿用设置 → 数据保留中的平台默认值。超出范围返回 `400`。
`settings`	object	数据流设置，见下文。
`fields`	array	字段索引，参见配置字段索引。

设置：

设置	说明
`description`	在网页界面中显示的自由文本。
`queryable`	`false` 时数据流仍然接收并保留数据，但会从查询选择器中隐藏，查询会失败并返回 `403`（`stream is not queryable`）。
`max_query_range_hours`	对该数据流的一次 SQL 或 PromQL 查询最多覆盖的小时数，范围 1 到 87600。时间范围更长的查询返回 `400`。`null` 表示不限制。
`field_masking`	数据流级别对全局字段遮掩规则的覆盖。
`daily_merge`	仅用于日志与链路。为 `true`（默认）时，一天结束一小时后，这一天的文件加起来不超过 `[compactor].target_size` 就合成一个文件，保留期随之按天生效。为 `false` 时保留按小时的文件。
`downsample`	仅用于指标。`{ "after_days": 7, "interval_secs": 300 }` 把早于 `after_days` 天的样本按 `interval_secs` 秒的时间桶聚合：同一 series 在一个桶里的样本合成一个点，数值取平均，增量计数取总和，原始样本随之删除。`after_days` 取 0 到 3650，`0` 表示不降采样（默认）；`interval_secs` 不小于 60 且整除一天。

curl -X PUT http://localhost:5080/api/v1/streams/$STREAM_ID/settings \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '{
    "retention_days": 30,
    "settings": { "description": "Application logs", "queryable": true }
  }'

响应是更新后的数据流。保留期与降采样决定 compactor 何时删除或聚合数据，修改只影响之后的清理，不会恢复已经删除的文件或样本。没有单独设置保留期的数据流使用的平台默认值，用 GET /api/v1/settings/stream_retention 读取，用 PUT 加同样的请求体 { "retention_days": 30 } 修改，两者都需要系统范围的 sys.settings.manage。retention_days 是 1 到 3650 的整数。

最后修改于 2026年10月26日

概览

身份验证

数据采集

查询

APM

用户体验

数据流

告警

关联与 Web

平台与管理