Virtuelles Netzweg-Element

Verwaltung von virtuellen Netzweg-Elementen.

Seitenverzeichnis:

1 cable.virtual_route_element.read
2 cable.virtual_route_element.create
3 cable.virtual_route_element.update
4 cable.virtual_route_element.delete

cable.virtual_route_element.read

Beschreibung

Gibt alle virtuellen Netzweg-Elemente zurück.

Beispielaufruf

Lesen eines speziellen virtuellen Netzweg-Elements:

{
	"method":"cable.virtual_route_element.read",
	"params":{
		"apikey":"24174j3tqj",
		"id": 4
	},
	"version":"2.0",
    "id": 1
}

Filtern von virtuellen Netzweg-Elementen:

{
	"method":"cable.virtual_route_element.read",
	"params":{
		"apikey":"24174j3tqj",
		"filter": {
			"index": 1
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version

Parameter

Typ

Beschreibung

Version

id

int

Optional: ID des virtuellen Netzweg-Elementes

ab Version 1.0

filter

array

Optional: Filter für virtuelle Netzweg-Elemente

Der Filter unterstützt alle Eigenschaften des virtuellen Netzweg-Elementes (siehe Rückgabewerte).

Als Suchkriterium kann das Prozent-Zeichen "%" als Wildcard verwendet werden.

ab Version 1.0

Rückgabewert

Liste aller virtuellen Netzweg-Elemente.

Wert	Typ	Beschreibung	Version

Wert	Typ	Beschreibung	Version
id	int	ID des virtuellen Netzweg-Elementes	ab Version 1.0
route_id	int	ID des referenzierten virtuellen Netzweges	ab Version 1.0
wire_id	int	ID der referenzierten Ader	ab Version 1.0
section_id	int	ID der referenzierten Strecke	ab Version 1.0
index	int	Index innerhalb der Reihenfolge der Elemente eines virtuellen Netzweges	ab Version 1.0

cable.virtual_route_element.create

Beschreibung

Legt ein neues virtuelles Netzweg-Element an.

Beispielaufruf

{
	"method":"cable.virtual_route_element.create",
	"params":{
		"apikey":"24174j3tqj",
		"data": {
			"route_id":1,
			"wire_id":2,
			"index":1
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version

Parameter	Typ	Beschreibung	Version
route_id	int	ID des referenzierten virtuellen Netzweges	ab Version 1.0
index	int	Index innerhalb der Reihenfolge der Elemente eines virtuellen Netzweges	ab Version 1.0
wire_id	int	Optional: ID der referenzierten Ader (Hinweis: wire_id oder section_id muss gesetzt werden!)	ab Version 1.0
section_id	int	Optional: ID der referenzierten Strecke (Hinweis: wire_id oder section_id muss gesetzt werden!)	ab Version 1.0

Rückgabewert

Wert	Typ	Version

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0

cable.virtual_route_element.update

Beschreibung

Aktualisiert ein bestehendes virtuelles Netzweg-Element.

Beispielaufruf

{
	"method":"cable.virtual_route_element.update",
	"params":{
		"apikey":"24174j3tqj",
		"id":4,
		"data": {
			"wire_id": 8
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version

Parameter	Typ	Beschreibung	Version
id	int	ID des virtuellen Netzweg-Elementes	ab Version 1.0
index	int	Index innerhalb der Reihenfolge der Elemente eines virtuellen Netzweges	ab Version 1.0
wire_id	int	ID der referenzierten Ader	ab Version 1.0
section_id	int	ID der referenzierten Strecke	ab Version 1.0

Rückgabewert

Wert	Typ	Version

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0

cable.virtual_route_element.delete

Beschreibung

Löscht ein virtuelles Netzweg-Element.

Wichtig: Es kann immer nur das jeweils letzte virtuelle Netzweg-Element gelöscht werden. Ein Löschen von Elementen innerhalb eines virtuellen Netzweges ist nicht möglich.

Beispielaufruf

{
	"method":"cable.virtual_route_element.delete",
	"params":{
		"apikey":"24174j3tqj",
		"id":4
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version

Parameter	Typ	Beschreibung	Version
id	int	ID des zu löschenden virtuellen Netzweg-Elementes	ab Version 1.0

Rückgabewert

Wert	Typ	Version

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0