Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Asset Management System

AMS is a server in the sense that it is listening for connections from BMC. All of the HTTP interfaces that can be configured to BMC must be listened to in AMS. These are the ones to which BMC sends messages. They are described in the following chapters. All of the interfaces listed below are expected to respond to all of the calls from BMC immediately with HTTP code 200 and message "RECEIVED". Without this response BMC will try to send the notification again. All messages in communication between BMC and AMS uses JSON as a data exchange format.ist ein Server in dem Sinne, dass er auf Verbindungen der BMC wartet. Alle HTTP-Schnittstellen die für die BMC konfiguriert werden können müssen im AMS abgehört werden. Dies sind diese an die die BMC Nachrichten sendet. Sie werden in den folgenden Kapiteln beschrieben. Es wird erwartet, dass alle unten aufgeführten Schnittstellen sofort auf alle Anfragen der BMC mit dem HTTP-Code 200 und der Nachricht "RECEIVED" antworten. Ohne diese Antwort wird die BMC versuchen die Benachrichtigung erneut zu senden. Alle Nachrichten in der Kommunikation zwischen der BMC und das AMS verwenden JSON als Format für den Datenaustausch.

In jeder URL im Referenz AMS wird eine spezielle Notation {id} verwendet. Dies bedeutet, dass die verwendete URL mit der ID der Clientsitzung erstellt wird, die in Wirklichkeit eine UUID ist. Die selbe ID ist auch immer in der JSON-Nachricht enthalten. Daher ist die Verwendung der ID in der URL optional und kann bei der Definition der URLs für das AMS weggelassen werden. Im Referenz AMS wird sie jedoch verwendet und deshalb muss die BMC mit dieser konfiguriert werden. Wenn beispielsweise eine neue Clientnachricht gesendet wird und die ID In each URL in Reference AMS a special notation {id} is used. This signifies that the used URL is constructed with the client session ID which in reality is a UUID. The same ID is also always contained in the contained JSON message. Therefore using the ID in the URL is optional and can be left out when defining the URLs for AMS. In Reference AMS, however, it is used and therefore BMC has to be configured with it. For example, when a new client message is sent and the session's ID is 123e4567-e89b-12d3-a456-426655440000 BMC sends a notification to lautet, sendet die BMC eine Benachrichtigung an die URL http://localhost:9000/new_client/123e4567-e89b-12d3-a456-426655440000 to the extent that AMS is running on localhost port 9000 an das AMS das auf dem Port 9000 des lokalen Hosts ausgeführt wird.

Anchor
newclient
newclient

...

Neuer Client

URL in Reference AMS/new_client/{id}
HTTP MethodPOST

...