跳到主要内容

远程管理接口

工程师电脑上的 IDE 远程管理面板连现场 Darra.PLC.Service 的 RemoteAccessServer。通道固定 HTTPS 18443,端口硬编码,界面不可改。鉴权是 API Key + JWT,速率 100 req/s。

运维只走产品自带通道:主数据面 DarraLink 18821,本页管理面 18443。不要用 RDP / SSH / VNC / Telnet。本页是该 HTTPS 通道上已发布的状态、诊断、启停与变量写入。

确认报警​

RemoteAccessServer.AcknowledgeAlarm · 可执行

确认指定活动报警。

签名​

POST /api/alarms/{id}/ack

参数​

idint
  • 输入
  • 必填
报警编号。

返回值​

returnjson
确认结果。

行为​

  • 报警不存在或已经确认时返回 404。
  • 与 HMI 报警页同一 AlarmManager 单源,不另建缓存。

错误与限制​

  • 404:编号不存在或已确认。

示例​

POST /api/alarms/12/ack

读取活动报警​

RemoteAccessServer.GetAlarms · 可执行

读取当前活动报警。

签名​

GET /api/alarms

参数​

无参数。

返回值​

returnjson
报警数量和报警列表。

行为​

  • 列表是请求时刻快照。
  • 空列表表示当前无活动报警。

错误与限制​

  • 未声明额外错误码。

示例​

GET /api/alarms

读取系统诊断​

RemoteAccessServer.GetDiagnostics · 可执行

读取现场运行进程和设备资源的诊断摘要。

签名​

GET /api/diagnostics

参数​

无参数。

返回值​

returnjson
CPU、内存、磁盘、网络与请求统计。未探测项带 *Probed=false,不得当成已隔离或已连接。

行为​

  • 只读,不改变运行状态。
  • 资源真伪与 profile 标签按现场机器角色显示,不隐藏。

错误与限制​

  • 未声明额外错误码。

示例​

GET /api/diagnostics

读取运行日志​

RemoteAccessServer.GetLogs · 可执行

读取最近的 Service 日志。日志在 Service 可执行文件同目录 logs/service_*.log。

签名​

GET /api/logs?count=100&level=all

参数​

countint
  • 输入
  • 可选
  • 默认 100
  • 约束 范围 1..500。
最多返回的日志行数。
levelstring
  • 输入
  • 可选
  • 默认 all
日志级别筛选;all 表示不过滤。

返回值​

returnjson
日志行数和日志内容。

行为​

  • 最多返回 500 行。
  • 只读现场 Service 日志,不是 IDE 日志。

错误与限制​

  • 超出 500 的 count 被截到上限。

示例​

GET /api/logs?count=50&level=error

读取 PLC 诊断​

RemoteAccessServer.GetPlcDiagnostics · 可执行

读取扫描次数、错误数和周期时间统计。

签名​

GET /api/plc/diagnostics

参数​

无参数。

返回值​

returnjson
scanCount、errorCount、周期百分位 p50/p95/p99、通讯质量。isolatedCoresProbed=false 时 isolatedCores 不是已隔离证明。

行为​

  • 运行时尚未就绪时返回 503。
  • HTTP 200 不等于硬实时隔离已通过。

错误与限制​

  • 503:PLCDiagnostics 未在 ServiceRegistry 就绪。

示例​

GET /api/plc/diagnostics

启动 PLC​

RemoteAccessServer.StartPlc · 可执行

按受控启动流程连接设备并启动 PLC 扫描。经 RuntimeHost 强类型回执确认最终态。

签名​

POST /api/plc/start

参数​

无参数。

返回值​

returnjson
启动回执和最终运行状态。回执成功才算已启动。

行为​

  • 要求操作员权限。
  • 运行时未就绪或安全条件不满足时拒绝启动。
  • 不打开 RDP / SSH,不改端口。

错误与限制​

  • 非 operator 角色拒绝。
  • 安全条件不满足时拒绝,不伪造成功。

示例​

POST /api/plc/start

停止 PLC​

RemoteAccessServer.StopPlc · 可执行

按受控停机流程停止 PLC 扫描并处理输出。

签名​

POST /api/plc/stop

参数​

无参数。

返回值​

returnjson
停机回执和最终运行状态。

行为​

  • 要求操作员权限。
  • 输出行为遵循项目停机策略(通常 Q 区清零)。
  • 远程急停复位 /api/plc/clear-estop 在强审计确认合同落地前固定拒绝。

错误与限制​

  • 非 operator 角色拒绝。

示例​

POST /api/plc/stop

扫描现场设备​

RemoteAccessServer.ScanDevices · 可执行

扫描指定 IPv4 子网中的可发现设备。走 DeviceScannerService,不是 L2 Discovery 帧。

签名​

GET /api/scan?subnet=192.168.3

参数​

subnetstring
  • 输入
  • 可选
  • 约束 格式示例:192.168.3。
IPv4 子网前三段。省略时用本机第一个非环回 IPv4 的前三段。推断失败不默认 192.168.1。

返回值​

returnjson
子网、设备数量和设备列表。deviceCount=0 不等于扫描成功。

行为​

  • 扫描超时由服务端控制。
  • 空目录不是健康态。
  • 同广播域裸机发现走 L2 EtherType 0x88B5 + Magic 0xDA53,不走本 HTTP。

错误与限制​

  • 503:DeviceScannerService 未就绪,扫描未发出。

示例​

GET /api/scan?subnet=192.168.3

读取运行状态​

RemoteAccessServer.GetStatus · 可执行

读取 PLC、IO、运动与扫描周期的当前状态。

签名​

GET /api/status

参数​

无参数。

返回值​

returnjson
当前运行状态与采样时间。

行为​

  • 用于监控页刷新,不改变设备状态。
  • 运行态权威在 Service IRuntimeStateService,本接口是只读镜像。

错误与限制​

  • 未声明额外错误码。

示例​

GET /api/status

读取变量​

RemoteAccessServer.GetVariable · 可执行

按 PLC 地址或变量名读取当前值。

签名​

GET /api/variables/{address}

参数​

addressstring
  • 输入
  • 必填
PLC 地址或变量名。

返回值​

returnjson
变量地址、当前值和数据类型。

行为​

  • 变量不存在时返回 404。
  • 读的是过程映像当前值,不是 Historian。

错误与限制​

  • 404:变量不存在。

示例​

GET /api/variables/DB1.Speed

提交变量写入​

RemoteAccessServer.SubmitVariableWrite · 可执行

把变量写入请求提交到下一扫描边界。202 只表示已入队。

签名​

POST /api/variables/{address}
Body: { "value": 1500 }

参数​

addressstring
  • 输入
  • 必填
PLC 地址或变量名。
valueobject
  • 输入
  • 必填
请求体中的目标值。

返回值​

returnjson
202 含 transactionId 与 GET /api/variable-writes/{transactionId} 查询路径。

行为​

  • 要求操作员权限。
  • 必须续查最终扫描结果,禁止把 202 当写入完成。
  • 写入在扫描边界提交,不旁路 Force 安全门。

错误与限制​

  • 非 operator 角色拒绝。
  • 变量不存在或类型不匹配拒绝入队。

示例​

POST /api/variables/DB1.Speed
Content-Type: application/json

{ "value": 1500 }

查询写入结果​

RemoteAccessServer.GetVariableWriteReceipt · 可执行

查询一次已提交变量写入的最终扫描结果。

签名​

GET /api/variable-writes/{transactionId}

参数​

transactionIdlong
  • 输入
  • 必填
  • 约束 必须为正整数。
提交写入时返回的事务编号。

返回值​

returnjson
待处理、已提交、已拒绝或已过期状态。

行为​

  • 查询不会重复提交写入。
  • 事务未知返回对应失败态,不假装已写入。

错误与限制​

  • 非法 transactionId 拒绝。

示例​

GET /api/variable-writes/42