# 错误代码

本文档描述了数据采集功能在调用 HTTP API 和 MQTT API 时会响应的错误码。

## api 请求错误代码

- 1000    通用错误
- 1001    内部错误
- 1002    请求 body 无效
- 1003    请求 param 无效
- 1004    缺少令牌
- 1005    解码令牌错误
- 1006    令牌过期
- 1007    验证令牌错误
- 1008    无效令牌
- 1009    用户名或密码错误
- 1010    程序繁忙
- 1011    文件不存在
- 1012    密码长度太短或太长
- 1013    密码重复
- 1014    执行指令失败
- 1015    ip 地址无效
- 1016    ip 地址已占用
- 1017    用户名无效
- 1018    密码无效
- 1023   端口已占用

## 添加/删除/更新 node/tag/plugin/group 错误代码

- 2002    node 已存在
- 2003    node 不存在
- 2004    node 设置无效
- 2005    node 设置未找到
- 2006    node 未准备好
- 2007    node 正在运行
- 2008    node 未运行
- 2009    node 已停止
- 2010    node 名称太长
- 2011    node 不允许删除
- 2012    node 不允许订阅
- 2013    node 不允许更新
- 2014    node 不支持图
- 2015    node 名称不允许为空
- 2101    group 已经被订阅
- 2102    group 未被订阅
- 2103    group 不允许
- 2104    group 已存在
- 2105    group 参数无效
- 2106    group 不存在
- 2107    group 名称太长
- 2108    group 超过同一 node 下最大数量
- 2201    tag 不存在
- 2202    tag 名称冲突
- 2203    tag 属性不支持
- 2204    tag 类型不支持
- 2205    tag 地址格式无效
- 2206    tag 名字太长
- 2207    tag 地址太长
- 2208    tag 描述太长
- 2209    tag 精度无效
- 2210    tag 已存在
- 2301    库未找到
- 2302    库信息无效
- 2303    库名称冲突
- 2304    库打开失败
- 2305    库模块无效
- 2306    系统库不允许删除
- 2307    插件不允许实例化
- 2308    插件不支持此架构
- 2309    插件使用中
- 2310    插件添加失败
- 2311    插件模块已存在
- 2312    插件模块不存在
- 2313    插件模块类型不支持
- 2314    插件模块版本和核心版本不匹配
- 2315    插件名称不符合规则
- 2316    插件依赖 C 库版本不匹配
- 2317    插件更新失败
- 2400    license 未找到
- 2401    license 无效
- 2402    license 过期
- 2403    license 未启用插件
- 2404    达到 license 授权的最大节点数
- 2405    达到 license 授权的最大点位数
- 2406    license 硬件不匹配
- 2407    license 检测到时钟异常
- 2408    license 模块无效
- 2409    license 硬件标识未找到
- 2500    模板已存在
- 2501    模板不存在
- 2502    模板名字太长

## 插件常见的错误代码

- 3000    插件读失败
- 3001    插件写失败
- 3002    插件未连接
- 3003    插件 tag 不允许读
- 3004    插件 tag 不允许写
- 3007    插件 tag 类型不匹配
- 3008    插件 tag 值失效
- 3009    插件协议解析失败
- 3010    插件未运行
- 3011    插件 tag 未就绪
- 3012    插件报文乱序
- 3013    插件名字太长
- 3014    插件不存在
- 3015    插件设备未响应
- 3016    插件不支持模板
- 3017    插件不支持写点位
- 3018    插件不支持同步读

## FILE 错误码

- 4100  字符串太长
- 4101  打开文件失败
- 4102  读文件失败
- 4103  写文件失败

## OPCUA 错误码

- 10001    opcua tag 不存在
- 10002    opcua 连接配置错误
- 10003    opcua 访问超时
- 10004    opcua tag 不可读
- 10005    opcua tag 不可写
- 10006    opcua tag 不支持
- 10007    opcua 错误
- 10008    值为坏，但原因不明
- 10009    客户端传入的操作列表中无任何元素，因此不会执行任何操作
- 10010    请求指定的操作过多，无法进行处理
- 10011    用户无权限执行请求的操作
- 10012    返回参数的时间戳无效
- 10013    已定义与数据源之间的通信，但尚未建立通信，无可用的最近已知值
- 10014    节点 ID 的语法无效
- 10015    节点 ID 指向服务器地址空间中不存在的节点
- 10016    指定的节点不支持该属性
- 10017    索引范围参数的语法无效
- 10018    指定的索引范围内无数据存在
- 10019    数据编码无效
- 10020    服务器不支持为该节点请求的数据编码
- 10021    访问等级不允许读取或订阅该节点
- 10022    访问等级不允许写入节点
- 10023    值超出范围
- 10024    数值有效期无效
- 10025    服务器不支持写入所提供的值、状态和时间标识的组合
- 10026    为属性提供的值与属性值的类型不匹配
- 10027    安全模式不满足服务器设定的要求

## S7COMM 错误码

- 10101  硬件错误
- 10103  对象无访问权限
- 10105  无效地址
- 10106  数据类型不支持
- 10107  数据类型不一致
- 10110  对象不存在
- 10150  COTP 连接断开
- 10151  S7 连接断开
- 10152  没有值
- 10153  值长度太短

## KNX 错误码

- 10200  设备不存在

## NONA11 错误码

- 10400  无效地址

## FINS 错误码

- 10500    fins 连接断开
- 10501    fins 错误
- 10502    本地节点错误
- 10503    目标节点错误
- 10504    控制器错误
- 10505    服务不受支持
- 10506    路由表错误
- 10507    命令格式错误
- 10508    参数错误
- 10509    无法读取
- 10510    无法写入
- 10511    当前模式不可执行
- 10512    单元不存在
- 10513    无法启动/停止
- 10514    单元错误
- 10515    命令错误
- 10516    访问权限错误
- 10517    中止

## FOCAS 错误码

- 10600  focas 错误

## EtherNet/IP 错误码

* 10701 - 10744 EtherNet/IP 错误
* 10704 点位地址错误
* 10797 EtherNet/IP 没有 CIP 连接
* 10798 EtherNet/IP 数据类型不匹配
* 10799 EtherNet/IP 未注册 session



## License 错误码（扩展）

- 13000    无效的 license 文件
- 13001    请上传 license 文件
- 13002    license 文件读取失败
- 13003    license 已过期
- 13004    license 写入失败
- 13005    license 超过激活有效期
- 13006    license 已过期，无法执行当前操作
- 13007    license 错误
- 13008    分配的点位数少于使用中的点位数
- 13009    Neuron 检测到时钟异常
- 13010    Neuron 无效的 license 模块
- 13011    Neuron 内部错误
- 13012    脱离 ECP 管理超出有效期，不允许修改、添加或操作
- 13013    非虚拟 license，不可移除
- 13014    license 不存在
- 13015    虚拟 license 删除失败
- 13016    硬件标识不匹配
- 13017    由于 NeuronEX 被 ECP 浮动 license 激活，禁止上传 license
- 13018    由于 NeuronEX 被 ECP 浮动 license 激活，禁止激活 license
- 13019    当前 license 不支持流处理引擎功能
- 13020    注册码错误
- 13021    该硬件已注册
- 13022    注册失败
- 13023    超过最大注册设备数
- 13024    ecosy license 网络连接不可用
- 13025    ecosy license 点位不足
- 13026    ecosy license 请求失败
- 13027    license 未启用该插件
- 13028    重置 license 失败，请确认点位使用少于 30 个点位
- 13029    重置试用 license 失败

## 边缘服务模板错误码

- 17000    边缘服务模板导出失败
- 17001    不支持的边缘服务版本
- 17002    不支持的边缘服务类型
- 17003    边缘服务模板分发失败
- 17004    边缘服务模板分发失败（错误）
- 17005    边缘服务模板分发失败，点位不足
- 17006    tag 属性不支持
- 17007    tag 类型不支持
- 17008    tag 地址格式无效
- 17009    tag 名字太长
- 17010    tag 地址太长
- 17011    tag 描述太长
- 17012    tag 精度无效
- 17013    node 名称太长
- 17014    group 参数无效
- 17015    group 名称太长
- 17016    库打开失败
- 17017    插件名称太长
- 17018    插件不支持请求的操作
- 17019    库未找到
- 17020    插件未找到
- 17021    tag 名称冲突
- 17022    库不允许创建实例
- 17023    服务器繁忙

## 告警和监控配置错误码

- 18000    告警配置缺少参数
- 18001    指标配置缺少参数
- 18002    Webhook URL 无效
- 18003    规则 ID 无效
- 18004    配置告警规则失败
- 18005    配置指标失败
- 18006    配置存活检测失败
- 18007    配置系统日志失败
- 18008    配置凭证失败
- 18009    系统日志配置缺少参数
- 18010    指标 ID 无效

## SSO 配置错误码

- 19000    添加 SSO 配置失败
- 19001    更新 SSO 配置失败
- 19002    查询中未找到配置名称
- 19003    删除 SSO 配置失败
- 19004    配置已存在
- 19005    获取 access_token 失败
- 19006    获取用户信息失败

## 服务器内部错误码

- 20000    服务器内部错误
- 20001    数据采集功能服务错误
- 20002    Neuron 代码错误
- 20003    数据流处理功能服务错误
- 20004    Neuron 加载未就绪
- 20005    Datalayers 加载未就绪

## 请求参数错误码

- 20100    请求 body 无效
- 20101    参数错误
- 20102    执行超时
- 20103    JSON 格式错误
- 20104    日志级别不支持
- 20105    目录不存在或为空
- 20106    文件对于数据恢复无效
- 20107    Neuron CID 请求无效
- 20108    Datalayers 查询 SQL 无效
- 20109    Datalayers 查询 SQL 执行失败
- 20110    名称已存在
- 20111    ID 不存在
- 20112    时间过滤器不存在
- 20113    时间过滤器不应该存在
- 20114    启用了多个 AI 模型
- 20115    SQL 应该是查询 SQL
- 20116    Datalayers 认证失败

## 用户认证错误码

- 20200    无效的用户名或密码
- 20201    用户名不正确
- 20202    密码不正确
- 20203    缺少令牌
- 20204    令牌不正确
- 20205    无访问权限
- 20206    用户名已存在

