sysdepGetList

Mit der Aktion sysdepGetList kann man eine Liste von Sysdeps anfordern.

Geliefert werden die Daten im sysdeps Block

Beispiel

Anfrage:

{
	"action": "sysdepGetList"
}

Antwort (stark gekürzt):

{
	"action": "sysdepGetList",
	"sysdeps": [
		{
			"id": "232646",
			"deviceId": 11,
			"deviceTypeId": 6,
			"key": "UCD_DISKIO",
			"userData01": "9",
			"userData02": "sda",
			"createdUtcMs": "1565717381000",
			"lastUpdateUtcMs": "1659486567000"
		},
		{
			"id": "232647",
			"deviceId": 11,
			"deviceTypeId": 6,
			"key": "UCD_DISKIO",
			"userData01": "10",
			"userData02": "sda1",
			"createdUtcMs": "1565717381000",
			"lastUpdateUtcMs": "1659486567000"
		},
		{
			"id": "975350891",
			"deviceId": 11,
			"deviceTypeId": 6,
			"key": "HR_STORAGE",
			"userData01": "/run/lock",
			"userData02": "Fixed Disk",
			"userData03": ".1.3.6.1.2.1.25.2.1.4",
			"createdUtcMs": "1575102316000",
			"lastUpdateUtcMs": "1659486566000"
		}
	]
}

Parameter

Man kann die Ausgabe durch Parameter beeinflussen, entweder man kann sie erweitern oder verringern.

Parameter Name Datentyp Default Beschreibung
.actionParameter.filterDeviceIdByIds Liste von Integer [] Eine Liste von Geräte IDs die ausgegeben werden soll
.actionParameter.filterDeviceTypeIdByIds Liste von Integer [] Eine Liste von Gerätetypen IDs die ausgegeben werden soll
.actionParameter.filterSysdepKeyByKeys Liste von Strings [] Eine Liste von Sysdep Keys die ausgegeben werden soll
.actionParameter.includeDeviceType Boolean false Gibt den Gerätetyp für jedes Sysdep mit aus
.actionParameter.includeDevice Boolean false Gibt die Geräteinformationen für jedes Sysdep mit aus

Bitte beachten: Mehrere Filter zusammen in einer Anfrage sind immer im AND Modus. Für ein ODER müssen mehrere Anfragen gemacht werden.

Bitte weiterhin beachten, dass wenn man alles Included und nichts filtert, die Ausgabe gewaltige Ausmaße annehmen kann.

Die möglich verfügbaren Sysdep Keys für filterSysdepKeyByKeys, sowie die Beschreibung der User Data, sind im Kapitel KPI/Sysdep beschrieben

Beispiel mit Filtern und Includes

Im folgenden Beispiel werden mehrere Action-Parameter kombiniert. Die einzelne Beispiel-Auslistung wäre schlichtweg zu viel. Daher gibt es nur ein Beispiel, wo mehr oder weniger alles angezeigt wird.

Anfrage:

{
	"action": "sysdepGetList",
	"actionParameter": {
		"filterDeviceIdByIds": [
			11
		],
		"filterSysdepKeyByKeys": [
			"RFC1213_UDP_TRAFFIC",
			"HR_SYSTEM_USER"
		],
		"includeDevice": true,
		"includeDeviceType": true
	}
}

Antwort (sehr stark gekürzt):

{
	"sysdeps": [
		{
			"id": "232612",
			"deviceId": 11,
			"deviceTypeId": 6,
			"key": "RFC1213_UDP_TRAFFIC",
			"createdUtcMs": "1565717380000",
			"lastUpdateUtcMs": "1659486566000",
			"deviceType": {
				"id": 6,
				"name": "UNIX CorvusCore",
				"description": "UNIX mit CorvusCore und NET-SNMP"
			},
			"device": {
				"id": 11,
				"name": "corvus Frankfurt",
				"ip": "10.10.10.10"
			}
		},
		{
			"id": "138267648",
			"deviceId": 11,
			"deviceTypeId": 6,
			"key": "HR_SYSTEM_USER",
			"createdUtcMs": "1565717379000",
			"lastUpdateUtcMs": "1659486566000",
			"deviceType": {
				"id": 6,
				"name": "UNIX CorvusCore",
				"description": "UNIX mit CorvusCore und NET-SNMP"
			},
			"device": {
				"id": 11,
				"name": "corvus Frankfurt",
				"ip": "10.10.10.10"
			}
		}
	]
}

Antwort Datenfelder

Hier eine vollständige Beschreibung aller möglichen Datenfelder der Antwort

Parameter Name Datentyp Beschreibung
.sysdeps Liste Liste aller gefundenen Sysdep zu dem Gerät, ist vorhanden, wenn .actionParameter.includeSysdeps gesetzt ist
.sysdeps[].id Integer Die ID des Sysdep
.sysdeps[].deviceId Integer Die Geräte ID des Sysdep
.sysdeps[].deviceTypeId Integer Die Gerätetyp ID des Sysdep
.sysdeps[].key String Der Sysdep Key Name
.sysdeps[].isInvalid Boolean Ist gesetzt, wenn der Sysdep nicht mehr aktiv und invalide ist
.sysdeps[].userData01 String Der Inhalt des User Data 01 Feldes
.sysdeps[].userData02 String Der Inhalt des User Data 02 Feldes
.sysdeps[].userData03 String Der Inhalt des User Data 03 Feldes
.sysdeps[].userData04 String Der Inhalt des User Data 04 Feldes
.sysdeps[].userData05 String Der Inhalt des User Data 05 Feldes
.sysdeps[].userData06 String Der Inhalt des User Data 06 Feldes
.sysdeps[].userData07 String Der Inhalt des User Data 07 Feldes
.sysdeps[].userData08 String Der Inhalt des User Data 08 Feldes
.sysdeps[].userData09 String Der Inhalt des User Data 09 Feldes
.sysdeps[].createdUtcMs Long Der Zeitstempel der Erstellung
.sysdeps[].lastUpdateUtcMs Long Der Zeitstempel der letzten Änderung
.sysdeps[].device Record Das Gerät vom Interface. Wird gesetzt wenn .actionParameter.includeDevice gesetzt ist
.sysdeps[].device.id Integer Die interne ID des Gerätes
.sysdeps[].device.name String Der Name des Gerätes
.sysdeps[].device.ip String Die IP oder der Hostname des Gerätes
.sysdeps[].deviceType Record Beinhaltet den Gerätetyp, sofern .actionParameter.includeDeviceType auf true steht
.sysdeps[].deviceType.id Integer Die interne ID des Gerätetyps
.sysdeps[].deviceType.name String Der Name des Gerätetyps
.sysdeps[].deviceType.description String Die Beschreibung der Gerätetyps

Corvus Help - 28.February 2026 03:33:38 UTC - Commit 667ccc2e