Page History
...
Anchor | ||||
---|---|---|---|---|
|
URL in Reference im Referenz AMS | /new_client/{id} |
---|---|
HTTP MethodMethode | POST |
Die BMC notifies AMS of all new clients and this interface is used for that purpose. The intention is that AMS in responds to the notification immediately and then queries what ever systems it needs to in order to decide what kind of job specification needs to be sent, if any. The intention is that this notification contains the minimum amount of information which enables AMS to query for more information, request an asset report or to reset or shutdown the client. An example of the message that is sentbenachrichtigt das AMS über alle neuen Clients, diese Schnittstelle wird für diesen Zweck verwendet. Die Absicht ist, dass das AMS sofort auf die Benachrichtigung reagiert und anschließen abfragt welche Informationen benötigt werden um zu entscheiden welche Art von Job Spezifikation gesendet werden muss, falls eine vorhanden ist. Die Absicht ist, dass diese Benachrichtigung die minimale Menge an Informationen enthält die es dem AMS ermöglichen nach weiteren Informationen zu fragen, einen Hardwarebericht (Asset Report) anzufordern, den Client zurückzusetzen oder herunterzufahren. Ein Beispiel der Nachricht:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "new_client": { "id": "123e4567-e89b-12d3-a456-426655440000", "product": "Blancco5", "version": "5.9.0", "mac_addresses": [ "B3-3C-55-8E-7E-E6", "E3-3C-55-8E-7E-B6" ] } } |
Job
...
Spezifikation Überprüfung
URL in Reference im Referenz AMS | /client/{id}/jobspec |
---|---|
HTTP MethodMethode | POST |
Once AMS has sent job specification for any given client, BMC passes it on to the Drive Eraser instance. Drive Eraser validates it and BMC informs AMS on it's validity. This interface receives that information. To the extent that it was invalid, both BMC and Drive Eraser will remove the session and start over. AMS will then be informed of the new session as described in the chapter New Client. An example of the messageSobald das AMS eine Job Spezifikation für einen bestimmten Client gesendet hat, gibt die BMC diese an den Drive Eraser weiter. Der Drive Eraser überprüft diese und die BMC informiert das AMS über die Gültigkeit. Diese Schnittstelle empfängt diese Information. Im Falle, dass die Job Spezifikation nicht gültig war, werden sowohl die BMC als auch der Drive Eraser die Sitzung trennen und von vorn beginnen. AMS wird dann über die neue Sitzung informiert, wie im Kapitel Neuer Client beschrieben. Ein Beispiel der Nachricht:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "job_spec": { "id": "c44ed942-fab6-4dfe-8b5a-81265e68a8dd", "status": "NOT_VALID", "message": "I am a reason of failure" } } |
Hardwarebericht (Asset Report)
URL in Reference im Referenz AMS | /client/{id}/asset_report |
---|---|
HTTP MethodMethode | POST |
Once Sobald das AMS has requested BMC to fetch an asset report, it is delivered to this interface. An example messagedie BMC aufgefordert hat einen Hardwarebericht (Asset Report) abzurufen wird er an diese Schnittstelle geliefert. Ein Beispiel der Nachricht:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "client_id": "0d1f2601-7098-4e85-a772-8b3f0fdff5c3", "asset_report": { "report": "PHJ...DF==" } } |
The XML report is encoded with BASE64.
Session Finished
Der XML-Bericht ist mit BASE64 codiert.
Sitzung beendet
URL im Referenz URL in Reference AMS | /client/{id}/finished |
---|---|
HTTP MethodMethode | POST |
Once session has finished, AMS is notified with this interface. Session is considered finished when
- AMS instructed Drive Eraser to shutdown
- AMS instructed Drive Eraser to reset
- AMS sent an invalid job specification
- Drive Eraser received a valid job specification, erased the computer, and sent the erasure report
Sobald die Sitzung beendet ist wird das AMS über diese Schnittstelle benachrichtigt. Die Sitzung gilt als beendet wenn
- das AMS den Drive Eraser herunterfahren lässt
- das AMS den Drive Eraser neustarten lässt
- das AMS eine ungültige Job Spezifikation gesendet hat
- der Drive Eraser eine gültige Job Spezifikation erhalten, den Computer gelöscht und den Löschbericht gesendet hat
Ein Beispiel der NachrichtAn example of the message sent:
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
{ "client_finished": { "id": "123e4567-e89b-12d3-a456-426655440000", "report_uuid": "e8b3f8ed-09f4-470b-9d84-6ff5ff6b54c3" } } |
...