修改单个指标集存储策略¶
POST /api/v1/metrics_rp/modify
概述¶
Body 请求参数¶
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| name | string | Y | 指标集名称 例子: cpu |
| duration | string | Y | 标准存储时长,格式为天级字符串 <正整数>d,例如 7d、30d。SaaS 付费版 rp 当前可选值为 3d、7d、14d、30d、60d、90d、180d、360d;企业版按部署配置的范围校验。实际可选值以当前工作空间版本配置为准。例子: 7d |
| storagePolicy | json | 长期存储策略,非必填。不传时保留该指标集已有长期存储策略;没有自定义策略时回退使用工作空间默认 rp 长期存储策略。包含 longStorageEnabled 和 longStorageDuration:longStorageEnabled 表示是否开启长期存储,默认 false;longStorageDuration 表示长期存储总时长,格式为天级字符串 <正整数>d,仅开启长期存储时需要传,且必须大于 duration。默认可选值为 90d、120d、180d、360d;企业版指标集 rp 当前默认范围为 1d 到 3600d。例子: {'longStorageEnabled': False} |
参数补充说明¶
修改单个指标集的数据存储策略。
参数说明:
- duration 表示标准存储时长,格式为天级字符串:<正整数>d,例如 7d、30d。SaaS 付费版 rp 当前可选值为 3d、7d、14d、30d、60d、90d、180d、360d;企业版按部署配置的范围校验。实际可选值以当前工作空间版本配置为准。
- storagePolicy 表示长期存储策略,非必填。不传时保留该指标集已有长期存储策略;如果指标集没有自定义策略,则继续回退使用工作空间默认 rp 长期存储策略。
- storagePolicy.longStorageEnabled 表示是否开启长期存储,默认 false。传 false 或不传该字段时,后端会按未开启长期存储处理,并把 longStorageDuration 归一为空字符串。
- storagePolicy.longStorageDuration 表示长期存储总时长,格式同样为 <正整数>d,例如 90d、180d、360d。仅当 longStorageEnabled=true 时需要传递;此时该值必须大于 duration。
- 长期存储默认可选值为 90d、120d、180d、360d;企业版指标集 rp 支持按部署配置的范围校验,当前默认范围为 1d 到 3600d。unlimited 版本不支持开启长期存储。
请求例子¶
curl 'https://openapi.guance.com/api/v1/metrics_rp/modify' \
-H 'Accept: application/json, text/plain, */*' \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw $'{"name":"cpu","duration":"30d","storagePolicy":{"longStorageEnabled":false}}' \
--compressed