Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- omnivista-restful-api [2016/09/10 22:01] – benny
+++ omnivista-restful-api [2024/06/09 10:29] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 874: / Zeile 874: @@
 </code>
-==== Manuell ein Gerät aufnehmen und einer Map zuordnen ====
+==== Manuell ein Gerät aufnehmen (und einer Map zuordnen => geht aktuell nicht, siehe nächster Punkt) ====
 <WRAP center round important 60%>
@@ Zeile 880: / Zeile 880: @@
 </WRAP>
-<WRAP center round important 60%>
+  * Das Gerät dass man aufnehmen möchte muss erreichbar sein, sonst dauert der Request sehr lange bis zur JSON-Response (knapp eine Minute)
-TODO: Benny
+  * MD5+DES ist das Protokoll 5, nicht 7 wie es die Ausgabe unter /api/devices einem glauben machen will (7 ist SHA+AES192) :: Anfrage bei R&D offen.
-Es sieht so aus als wenn das Gerät erreichbar sein muss um es manuell anzulegen. Der Request läuft sehr lange und erst nach einem Timeout kommt dann die JSON-Response. Das Gerät ist dann in der "Physical Network"-Map, obwohl ich es woanders haben wollte (siehe Eintrag unten). Es ist gut möglich dass dieses verschieben funktioniert hätte wenn das Gerät erreichbar wäre, aber dafür brauche ich ein erreichbares Gerät zum testen.
+  * Egal was man als "currentMap" übergibt, das Gerät landet immer in "Physical Devices" :: Anfrage bei R&D offen.
-</WRAP>
 <code bash>
@@ Zeile 961: / Zeile 960: @@
 </code>
+==== Gerät einer Map zuordnen ====
+  * mapId ist die ID der Zielmap (im JSON-Request-Body und der URL!)
+  * id ist die instanceid des Objekts das man auf Map hinzufügen möchte
+  * deviceIPAddress ist die IP des Gerätes das der Map hinzugefügt werden soll (kann ja mehrere haben, das wird dann wohl die primäre für diese Map)
+<code bash>
+BennyE$ curl -s -k -H "Authorization: Bearer 450d7a34-5dc7-4f1e-a01f-29556864eb59" -H "Ov-App-Version:4.2.1.R01" -H "Content-Type: application/json" -X POST -d '[ { "id": "57d48039e4b0ec43d29869ac", "deviceIpAddress": "192.168.20.26", "x": 0, "y": 120, "deviceAddress": true, "mapId": "57d404d3e4b0d545f07f47db" } ]' https://192.168.40.12/api/topology/maps/57d404d3e4b0d545f07f47db/addNodes/ | jq .
+{
+  "status": "SUCCESS",
+  "statusCode": 200,
+  "type": "TopologyBaseResponse",
+  "response": {
+    "multipleResult": false,
+    "resultList": [],
+    "operation": "ADDNODESTOMAP",
+    "uniqueName": "57d404d3e4b0d545f07f47db",
+    "displayName": "Unprovisioned Devices",
+    "mapVersion": 1,
+    "success": true,
+    "message": {
+      "params": [],
+      "code": "topology.addnodestomap.success"
+    },
+    "additionParams": {},
+    "translated": {
+      "additionParams": {},
+      "operationTranslated": "ADDNODESTOMAP",
+      "successTranslated": "Success",
+      "resultList": [],
+      "messageTranslated": "Added devices to map successfully"
+    }
+  },
+  "serverVersion": "4.2.1.R01"
+}
+### json oneliner
+[ { "id": "57d48039e4b0ec43d29869ac", "deviceIpAddress": "192.168.20.26", "x": 0, "y": 120, "deviceAddress": true, "mapId": "57d404d3e4b0d545f07f47db" } ]
+### prettyprint
+[
+    {
+        "id": "57d48039e4b0ec43d29869ac",
+        "deviceIpAddress": "192.168.20.26",
+        "x": 0,
+        "y": 120,
+        "deviceAddress": true,
+        "mapId": "57d404d3e4b0d545f07f47db"
+    }
+]
+</code>
+Feierabend nun: RESTful API, you gonna be restLESS! :)
 ===== OmniVista RESTful API mit Python ansprechen =====
 <WRAP center round important 60%>