Einfügen von Werten in Nachrichten, HTTP-Requests und Pfade - icom OS-Router

Status-Informationen, Ereignis-abhängige Informationen sowie alle Parameter der Konfiguration können als Variablen im Nachrichtentext von SMS- und E-Mail-Meldungen sowie in der Betreff-Zeile einer E-Mail-Nachricht eingesetzt werden. Ereignis-abhängige Informationen können nur von dem Ereignis verwendet werden, durch das die Meldung ausgelöst wurde. Es ist außerdem möglich, Werte in den Pfad für die Download-Liste auf einem Auto-Update-Server einzubinden.

Einfügen in Meldungen und HTTP-Requests

Dabei wird der Ausdruck für die Variable mit der Rückgabe eines CLI-Befehls oder einer REST-Anfrage ersetzt. Während mit dem CLI-Ausdruck die Rückgaben sämtlicher CLI-Befehle in den Text eingefügt werden können, können mit der REST-Anfrage nur die Rückgaben von Status-Endpunkten eingefügt werden. Folgende Einschränkungen gelten für die jeweiligen Meldungstypen:

Beispiel für einen Meldungstext, der die aktuelle Systemzeit im Router in einer Meldung ausgibt:
Die aktuelle Systemzeit ist $cli(status.sysdetail.system.date).

Beispiel für einen Meldungstext, der mit Hilfe Ereignis-abhängiger Informationen in einer Meldung ausgibt, wann sich welcher Benutzer an welchem Standort anmeldet:
Der Benutzer $cli(events.info[username]) meldete sich um $cli(administration.time.time) am Standort $cli(administration.hostnames.location) an.
Dazu muss die Meldung durch ein Ereignis Anmeldungsversuch erkannt - erfolgreich im Rahmen einer Aktion ausgelöst werden.

Beispiel für einen Meldungstext, der mit Hilfe verschachtelter Ereignis-abhängiger Informationen in einer Meldung ausgibt, welches Ereignis aufgetreten ist:
Das Ereignis $cli(events.event_config.event[$cli(events.info[event_id])].description) ist aufgetreten.
Dabei wird die Nummer des abgefragten Ereignisses über die Ereignis-abhängiger Information $cli(events.info[event_id]) in die Abfrage der Beschreibung des Ereignisses eingesetzt.

Wenn zum Beispiel in einen Meldungstext der Ausdruck $rest(/status/sysdetail/system) eingefügt wird, wird an Stelle des Ausdrucks folgende Rückgabe eingesetzt:

{
 "status": {
  "unique": {
   "location": "Regensburg",
   "date": "2025-02-27 11:32:30",
   "uptime": "21 min 1 s",
   "load": "3.30 2.95 1.96",
   "ram": "30964 kByte free",
   "hash": "2C637FC2",
   "mac": "00:05:B6:06:82:61",
   "remote_management": "inactive",
   "remote_management_uptime": "",
   "time_status": "manually_set",
   "signature_required": "inactive",
   "device_virgin": "0",
   "profile_mode": "permanent",
   "flash_mode": "SLC",
   "flash_status": "OK",
   "hostname": "insys",
   "classic_ui_active": "1",
   "device_note": "",
   "minimum_fw_version": "6.9",
   "boots_since_production": "2406",
   "boots_since_reset": "1",
   "operating_hours": "735h:45m",
   "online_count_since_production": "1056",
   "online_count_since_reset": "0",
   "online_count_since_boot": "0",
   "last_online_time": "never"
  }
 }
}

Einfügen in einen Pfad

Beispiel für die Verwendung der Seriennummer des Routers, um einen gerätespezifischen Pfad auf dem Auto-Update-Server zu generieren:

/updates/$cli(status.device_info.slot[1].serial_number)/list.txt

In diesem Fall wäre der resultierende Pfad: /updates/12345678/list.txt (bei einer angenommenen Seriennummer von 12345678)