# 查询点位表配置列表
#### 功能介绍
查询点位表配置列表
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IoTEdge/doc?api=BatchListDcPoints)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v2/{project_id}/edge-nodes/{edge_node_id}/ots/data-sources/{ds_id}/points
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                        |
|:---|:---|:---|:---|
| project_id   | 是    | String | 项目ID。获取方法请参见 [获取项目ID](https://support.huaweicloud.com/api-iotedge/iotedge_api_0032.html)。 |
| edge_node_id | 是    | String | 边缘节点ID                                                                                    |
| ds_id        | 是    | String | 采集数据源id，创建数据源配置时设置，节点下唯一。                                                                 |
   
表2Query参数 
| 参数        | 是否必选 | 参数类型    | 描述                                        |
|:---|:---|:---|:---|
| point_id  | 否    | String  | 采集点位表id，创建点位表时设置，数据源下唯一。                  |
| name      | 否    | String  | 点位名称，允许中、数字、英文大小写、下划线、中划线、#%()\*特殊字符.模糊查询 |
| property  | 否    | String  | 属性，允许中、数字、英文大小写、下划线、中划线，精确查询              |
| device_id | 否    | String  | 设备标识，精确查询                                 |
| active    | 否    | Boolean | 点位启停状态筛选                                  |
| offset    | 否    | Integer | 查询的起始位置，取值范围为非负整数，默认为0                    |
| limit     | 否    | Integer | 每页记录数，默认值为10，取值区间为1-1000                  |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务 [获取IAM用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取，接口返回的响应消息头中"X-Subject-Token"就是需要获取的用户Token。简要的获取方法样例请参见 [Token认证](https://support.huaweicloud.com/api-iothub/iot_06_v5_0091.html#section0)。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数        | 参数类型                                                                                                                               | 描述    |
|:---|:---|:---|
| count     | Long                                                                                                                               | 总记录数  |
| page_info | [PageInfoDTO] object                             | 分页信息  |
| points    | Array of [CreateDcPointRespDTO] objects | 每页记录数 |
   
 表5PageInfoDTO 
| 参数     | 参数类型    | 描述    |
|:---|:---|:---|
| offset | Integer | 页码    |
| limit  | Integer | 每页记录数 |
   
 表6CreateDcPointRespDTO 
| 参数                | 参数类型                                                                                                                   | 描述                                   |
|:---|:---|:---|
| 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 | 点位处理配置                               |
| active            | Boolean                                                                                                                | 点位启停状态                               |
| create_time       | String                                                                                                                 | 创建时间                                 |
| update_time       | String                                                                                                                 | 最后一次修改时间                             |
   
 表7ProcessingConfigDTO 
| 参数             | 参数类型                                                                                                                   | 描述        |
|:---|:---|:---|
| validity       | [PointValidityingDTO] object | 点位校验      |
| stream_formula | String                                                                                                                 | 点位流公式配置字段 |
| scaling        | [PointScalingDTO] object         | 点位缩放规则列表  |
| clean          | [PointCleanDTO] object             | 点位计算规则列表  |
   
 表8PointValidityingDTO 
| 参数                | 参数类型    | 描述                  |
|:---|:---|:---|
| min               | Object  | 点位上报值的最小值，小于该值则上报告警 |
| max               | Object  | 点位上报值的最大值，大于该值则上报告警 |
| outlier_filtering | Boolean | 异常值过滤               |
   
 表9PointScalingDTO 
| 参数       | 参数类型    | 描述                                    |
|:---|:---|:---|
| ratio    | Double  | 缩放的倍率                                 |
| base     | Double  | 基准值                                   |
| accuracy | Integer | 缩放后结果的精度，精确到小数点后几位,-1表示全部保留，0表示只保留整数位 |
   
 表10PointCleanDTO 
| 参数            | 参数类型    | 描述                             |
|:---|:---|:---|
| silent_window | Integer | 静默时间窗口，在该时间窗口内，没有触发上报条件，点位将不会上 |
| deviation     | Double  | 偏差，在该偏差范围内表示是正常波动，点位将不进行上报     |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
OK
```
{
  "count" : 1000000,
  "page_info" : {
    "offset" : 1000000,
    "limit" : 1000
  },
  "points" : [ {
    "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"
  } ]
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | OK          |
| 400 | Bad Request |
| 404 | Not Found   |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iotedge/ErrorCode.html)。