修改点位表配置

功能介绍

修改点位表配置

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

PUT /v2/{project_id}/edge-nodes/{edge_node_id}/ots/data-sources/{ds_id}/points/{point_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参见获取项目ID。
edge_node_id	是	String	边缘节点ID
ds_id	是	String	采集数据源id，创建数据源配置时设置，节点下唯一。
point_id	是	String	采集点位表id，创建点位表时设置，数据源下唯一。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。

表3 请求Body参数
参数	是否必选	参数类型	描述
name	否	String	点位名称，允许中、数字、英文大小写、下划线、中划线、#%()*特殊字符
collection_config	否	Object	点位采集配置
device_id	是	String	设备id
property	是	String	属性，允许中、数字、英文大小写、下划线、中划线
data_type	否	String	点位数据类型
processing_config	否	ProcessingConfigDTO object	点位处理配置

表4 ProcessingConfigDTO
参数	是否必选	参数类型	描述
validity	否	PointValidityingDTO object	点位校验
stream_formula	否	String	点位流公式配置字段
scaling	否	PointScalingDTO object	点位缩放规则列表
clean	否	PointCleanDTO object	点位计算规则列表

表5 PointValidityingDTO
参数	是否必选	参数类型	描述
min	是	Object	点位上报值的最小值，小于该值则上报告警
max	是	Object	点位上报值的最大值，大于该值则上报告警
outlier_filtering	否	Boolean	异常值过滤

表6 PointScalingDTO
参数	是否必选	参数类型	描述
ratio	是	Double	缩放的倍率
base	是	Double	基准值
accuracy	否	Integer	缩放后结果的精度，精确到小数点后几位,-1表示全部保留，0表示只保留整数位

表7 PointCleanDTO
参数	是否必选	参数类型	描述
silent_window	是	Integer	静默时间窗口，在该时间窗口内，没有触发上报条件，点位将不会上
deviation	是	Double	偏差，在该偏差范围内表示是正常波动，点位将不进行上报

响应参数

状态码：200

表8 响应Body参数
参数	参数类型	描述
point_id	String	点位表id，数据源下唯一
name	String	点位名称，允许中、数字、英文大小写、下划线、中划线、#%()*特殊字符
collection_config	Object	点位采集配置
device_id	String	设备id
property	String	属性，允许中、数字、英文大小写、下划线、中划线
data_type	String	点位数据类型
ds_id	String	采集数据源id，节点下唯一
processing_config	ProcessingConfigDTO object	点位处理配置
create_time	String	创建时间
update_time	String	最后一次修改时间

表9 ProcessingConfigDTO
参数	参数类型	描述
validity	PointValidityingDTO object	点位校验
stream_formula	String	点位流公式配置字段
scaling	PointScalingDTO object	点位缩放规则列表
clean	PointCleanDTO object	点位计算规则列表

**表10** PointValidityingDTO
参数	参数类型	描述
min	Object	点位上报值的最小值，小于该值则上报告警
max	Object	点位上报值的最大值，大于该值则上报告警
outlier_filtering	Boolean	异常值过滤

**表11** PointScalingDTO
参数	参数类型	描述
ratio	Double	缩放的倍率
base	Double	基准值
accuracy	Integer	缩放后结果的精度，精确到小数点后几位,-1表示全部保留，0表示只保留整数位

**表12** PointCleanDTO
参数	参数类型	描述
silent_window	Integer	静默时间窗口，在该时间窗口内，没有触发上报条件，点位将不会上
deviation	Double	偏差，在该偏差范围内表示是正常波动，点位将不进行上报

请求示例

PUT https://{endpoint}/v2/{project_id}/edge-nodes/{edge_node_id}/ots/data-sources/{ds_id}/points/{point_id}

{
  "name" : "马达电压",
  "collection_config" : {
    "address" : "ns=2;s=Root/Motor/Voltage",
    "data_type" : "int",
    "cycle" : 10000
  },
  "device_id" : "MotorVoltage",
  "property" : "Motor/Voltage",
  "data_type" : "int",
  "processing_config" : {
    "validity" : {
      "min" : 60,
      "max" : 100
    },
    "stream_formula" : "bit(0).bool()|string_to_double(-1.0)|string_to_int(0)",
    "scaling" : {
      "ratio" : 1,
      "base" : 100,
      "accuracy" : 2
    },
    "clean" : {
      "silent_window" : 60,
      "deviation" : 0.1
    }
  }
}

响应示例

状态码：200

{
  "point_id" : "MotorVoltage",
  "name" : "马达电压",
  "collection_config" : {
    "address" : "ns=2;s=Root/Motor/Voltage",
    "data_type" : "int",
    "cycle" : 10000
  },
  "device_id" : "MotorVoltage",
  "property" : "Motor/Voltage",
  "data_type" : "int",
  "ds_id" : "opcua_1",
  "processing_config" : {
    "validity" : {
      "min" : 60,
      "max" : 100
    },
    "stream_formula" : "bit(0).bool()|string_to_double(-1.0)|string_to_int(0)",
    "scaling" : {
      "ratio" : 1,
      "base" : 100,
      "accuracy" : 2
    },
    "clean" : {
      "silent_window" : 60,
      "deviation" : 0.1
    }
  },
  "create_time" : "2020-05-28T11:31:29.740Z",
  "update_time" : "2020-05-28T11:31:29.740Z"
}