查询数采器信息
参数 | 描述 | 必选 |
---|---|---|
action | queryCollectorInfoEs | 是 |
pn | 数采器编号 | 是 |
响应:
参数 | 描述 | 必选 |
---|---|---|
collector[x].pn | 数采器编号 | 是 |
collector[x].alias | 数采器别名 | 否 |
collector[x].datFetch | 数据采集频率(秒) | 是 |
collector[x].timezone | 数采器工作时区(相对零时区的秒数) | 是 |
collector[x].load | 数采器的带载数 | 是 |
collector[x].status | 数采器状态, 见设备状态 | 是 |
collector[x].uid | 数采器所属电站业主id, 数采器有可能不属于任何电站业主 | 否 |
collector[x].pid | 数采器所属电站id, 数采器有可能不属于任何电站 | 否 |
collector[x].gprs.ccid | GPRS-CCID, 仅当数采器为GPRS类型时有效 | 否 |
collector[x].gprs.card | GPRS-CARD, 仅当数采器为GPRS类型时有效 | 否 |
collector[x].gprs.imsi | GPRS-IMSI, 仅当数采器为GPRS类型时有效 | 否 |
需要注意是, 接口是快速失败的: 即, 如果有一个数采器编号被认为有误, 接口将立即返回错误.
另外, 返回的数采器顺序可能与查询时传递的顺序不同.
{
"err":0,
"desc":"ERR_NONE",
"dat":{
"collector":[
{
"pn":"COLLECTOR0001",
"datFetch":60,
"timezone":28800,
"load":1,
"uid":1,
"pid":1
}
]
}
}
可能出现的错误:
返回错误码 | 描述 | 详细描述 |
---|---|---|
0x0006 | ERR_FORMAT_ERROR | 参数错误 |
0x0007 | ERR_MISSING_PARAMETER | 缺少必要的参数(传入参数可能为空) |
0x000D | ERR_OVER_LIMIT | 超出限制 |
0x0101 | ERR_NOT_FOUND_COLLECTOR | 找不到数采器 |