MICRO-EPSILON colorSENSOR CFO200 Betriebsanleitung Seite 101

Anhang | API-Kommunikation mit Controller (Version 0.7.1)
A 3.5.3.4 /api/firmware/images
POST
Erzeugen eines Firmware-Images mit den folgenden Attributen:
Der Upload folgt in separaten Requests via /api/firmware/images/UUID/upload (siehe unten).
Der obige Ansatz zum Erzeugen eines Images mit nachfolgendem Upload einzelner Blöcke ist auf Anwen-
dungen ausgerichtet.
Fehlercodes:
LPLC.validation.missing_input
LPLC.validation.string
LPLC.validation.non_negative_integer
LPLC.validation.positive_integer
LPLC.validation.smaller_integer
A 3.5.3.5 Firmware-Upload via Formular (multipart)
Zusätzlich ermöglicht der Firmware-Image-API-Endpunkt auch den vereinfachten Upload einer Firmware-
Image-Datei via Formular (als Teil eines multipart-Request-Body):
firmware_file:
apply:
Wenn dieses Feld den Wert 1 enthält, wird nach dem Empfang des Firmware-Images unverzüglich die apply-
Aktion ausgeführt (/api/firmware/images/UUID/apply - siehe unten). Andernfalls liefert der Request die Details
des hochgeladenen Firmware-Images aus, um einen separaten apply-Request zu ermöglichen.
Beispiel:
# einfacher Upload
curl -X POST --form „firmware_file=@firmware.img" http://169.254.168.150/api/firmware/images
# Upload mit anschließender Aktivierung des hochgeladenen Firmware-Images
curl -X POST --form „firmware_file=@firmware.img" --form „apply=1" http://169.254.168.150/api/firmware/
images
Der POST-Request wird mit einer leeren Antwort quittiert, falls keine Fehler auftraten.
colorSENSOR CFO
die hochzuladende Firmware-Image-Datei (erforderlich)
Auswahl der sofortigen Anwendung des hochgeladenen Firmware-Images (Standard: 0).
Seite 101