Roboception rc visard Montage- Und Betriebsanleitung Seite 229

8.3. REST-API-Schnittstelle
• Content-Type
Statuscodes
• 200 OK
Referenzierte Datenmodelle
• FirmwareInfo
POST /system/update
Aktualisierung des Firmware/System-Images mit einer Mender-Artefakt-Datei: Um die aktualisier-
te Firmware zu aktivieren, ist anschließend ein Neustart erforderlich.
Musteranfrage
POST /api/v1/system/update
Accept: multipart/form-data
Formularparameter
– Mender-Artefakt-Datei (obligatorisch)
•
file
Anfrage-Header
• Accept
Statuscodes
• 200 OK
• 400 Bad Request
8.3.3 Datentyp-De nitionen
Die REST-API de niert folgende Datenmodelle, die verwendet werden, um auf die
cen (Abschnitt 8.3.2) zuzugreifen oder diese zu ändern, entweder als benötigte Attribute/Parameter
oder als Rückgabewerte.
FirmwareInfo: Informationen zu aktuell aktiven und inaktiven Firmware-Images und dazu, welches
Image für den Boot-Vorgang verwendet wird.
Ein Objekt des Typs FirmwareInfo besitzt folgende Eigenschaften:
• active_image (ImageInfo): siehe Beschreibung von ImageInfo.
• fallback_booted (boolean): TRUE, wenn das gewünschte Image nicht hochgefahren werden
konnte und ein Fallback auf das zuvor genutzte Image vorgenommen wurde.
• inactive_image (ImageInfo): siehe Beschreibung von ImageInfo.
• next_boot_image (string): Firmware-Image, das beim nächsten Neustart geladen wird (ent-
active _ image
weder
Musterobjekt
{
"active _
image": {
"image _
version":
},
"fallback _
booted": false,
"inactive _
image": {
"image _
version":
},
"next _ boot _
image":
}
Roboception GmbH
Handbuch: rc_visard
– application/json
– Erfolgreiche Verarbeitung (Rückgabe: FirmwareInfo)
(Abschnitt 8.3.3)
HTTP/1.1
– Multipart/Formulardaten
– Erfolgreiche Verarbeitung
– Client-Fehler, z.B. kein gültiges Mender-Artefakt
inactive _ image
oder
"string"
"string"
"string"
228
).
verfügbaren Ressour-
Rev: 21.01.1
Status: 30.01.2021