Save Storage Policy¶
根据存储策略ID,更新并保存指定存储策略的配置信息,包括数据存储时长、和存储策略中配置的模型测点信息。
请求格式¶
POST https://{apigw-address}/tsdb-policy/v2.1/policies/{policyId}
请求参数(Header)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
Content-Type |
必需 |
String |
内容或文件类型,默认值为 application/json。 |
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
policyId |
Path |
必需 |
String |
存储策略ID,可通过 EnOS管理门户 > 时序数据管理 > 存储策略 页面获取指定存储类型的存储策略ID。 |
orgId |
Query |
必需 |
String |
资产所属的组织ID。如何获取orgId信息>> |
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
retention |
可选,若模型测点已配置存储时长,此参数为可选。 |
String |
数据存储时长,1M 表示一个月,1y 表示一年。所有可选值有:1M、3M、 6M、1y、 2y、 3y、 5y、10y、15y 、20y。 |
models |
必需 |
List<JSONObject> |
模型测点集合。详见 模型测点结构体 |
模型测点结构体 ¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
modelId |
必需 |
String |
模型ID。 |
points |
必需 |
List<JSONObject> |
模型中需配置存储策略的测点列表,以及测点数据压缩配置。详见 测点数据压缩配置 |
错误码¶
有关错误码的描述,参见 通用错误码。
示例¶
请求示例¶
url: https://{apigw-address}/tsdb-policy/v2.1/policies/aa8bbcba-2919-4c78-854c-54984d85d2fa
method: POST
requestBody:
{
"models": [
{
"modelId": "yourModelId1",
"points": [
{
"pointId": "yourPointId1",
"sdt": {
"compdev": 0.22,
"compmax": 2200,
"compmin": 22
},
"db": {
"excdev": 0.11,
"excmax": 100,
"excmin": 11
}
},
{
"pointId": "yourPointId2",
"sdt": null,
"db": null
},
{
"pointId": "yourPointId3",
"sdt": {
"compdev": 0.22,
"compmax": 2200,
"compmin": 22
},
"db": null
}
]
},
{
"modelId": "yourModelId2",
"points": [
{
"pointId": "yourPointId4",
"sdt": {
"compdev": 0.22,
"compmax": 2200,
"compmin": 22
},
"db": {
"excdev": 0.11,
"excmax": 1100,
"excmin": 11
}
}
]
}
],
"retention": "6M"
}
返回示例¶
{
"code": 0,
"msg": "OK",
"data": null
}