Get Storage Policy¶

根据存储策略ID，获取指定存储策略的详细信息，包括存储策略名称、存储数据类型、存储时长，以及存储策略中配置的模型测点和压缩配置信息。

请求格式¶

GET https://{apigw-address}/tsdb-policy/v2.1/policies/{policyId}

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
policyId	Path	必需	String	存储策略ID，可通过 EnOS管理门户 > 时序数据管理 > 存储策略页面获取指定存储类型的存储策略ID。
orgId	Query	必需	String	资产所属的组织ID。如何获取orgId信息>>

响应参数¶

名称	数据类型	描述
data	List<JSONObject>	存储策略的详细信息。详见存储策略结构体

存储策略结构体¶

名称	数据类型	描述
policyId	String	存储策略ID。
policyName	String	存储策略名称。
policyType	String	存储策略类型。
retention	String	数据存储时长。
models	List<JSONObject>	模型测点存储策略详细信息。详见模型测点结构体

模型测点结构体¶

名称	数据类型	描述
modelId	String	模型ID。
points	List<JSONObject>	模型中已配置存储策略的测点列表，以及测点数据压缩配置。详见测点数据压缩配置

测点数据压缩配置¶

名称	数据类型	描述
pointId	String	测点ID。
sdt	JSONObject	旋转门压缩参数配置，包括 `compdev`、`compmax` 和 `compmin` 参数的配置信息。
db	JSONObject	死区压缩参数配置，包括 `excdev`、`excmax` 和 `excmin` 参数的配置信息。

示例¶

{
   "policyId": "yourPolicyId",
   "policyName": "yourPolicyName",
   "policyType": "yourPolicyType",
   "retention": "6M",
   "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
               }
            }
         ]
      }
   ]
}

错误码¶

有关错误码的描述，参见通用错误码。

示例¶

请求示例¶

url: https://{apigw-address}/tsdb-policy/v2.1/policies/yourPolicyId?orgId=yourOrgId

method: GET

返回示例¶

{
   "code": 0,
   "msg": "OK",
   "submsg": null,
   "data": {
      "policyId": "yourPolicyId",
      "policyName": "yourPolicyName",
      "policyType": "yourPolicyType",
      "retention": "6M",
      "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
                  }
               }
            ]
         }
      ]
   }
}

SDK Samples¶

你可以在 Github 上获取 TSDB 策略服务的 Java SDK 示例。