Behandeln von Fehlern oder Warnungen in Junos XML Protocol-Sitzungen

In einer Junos XML-Protokollsitzung mit einem Gerät, auf dem Junos OS ausgeführt wird, sendet eine Client-Anwendung RPCs an den Junos XML-Protokollserver, um Informationen von dem Gerät anzufordern und die Konfiguration auf dem Gerät zu verwalten. Der Junos XML-Protokollserver sendet eine Antwort auf jede Clientanfrage. Wenn auf dem Server eine Fehlerbedingung auftritt, gibt er ein <xnm:error> Element aus, das untergeordnete Elemente enthält, die den Fehler beschreiben.

Die Syntax des <xnm:error> Elements lautet wie folgt:

Die Attribute sind wie folgt:

• xmlns– Der XML-Namespace für die <xnm:error> untergeordneten Tag-Elemente, die kein Präfix in ihren Namen haben (d. a. standard namespace für Junos XML-Tag-Elemente). Der Wert ist eine URL des Formulars http://xml.juniper.net/xnm/version/xnm, wobei version eine Zeichenfolge wie 1.1 ist.

• xmlns:xnm– Der XML-Namespace für das <xnm:error> Tag-Element und die untergeordneten Tag-Elemente, die das xnm: Präfix in ihren Namen haben. Der Wert ist eine URL des Formulars http://xml.juniper.net/xnm/version/xnm, wobei version eine Zeichenfolge wie 1.1 ist.

Die Gruppe der untergeordneten Tags, die in das <xnm:error> Element eingeschlossen sind, hängt von dem Vorgang ab, den der Server ausgeführt hat, wenn der Fehler auftrat. Ein Fehler kann auftreten, wenn der Server einen der folgenden Vorgänge ausführt, und der Server kann in jedem Fall eine andere Kombination von untergeordneten Tag-Elementen senden:

• Verarbeitung einer betrieblichen Anfrage, die von einer Client-Anwendung eingereicht wird

• Öffnen, Sperren, Ändern, Festlegen oder Schließen einer Konfiguration, wie von einer Client-Anwendung angefordert

• Analysieren von Konfigurationsdaten, die von einer Clientanwendung in einem <load-configuration> Tag-Element übermittelt werden

Client-Anwendungen müssen darauf vorbereitet sein, ein <xnm:error> Tag jederzeit zu erhalten und zu behandeln. Die Informationen in den Antwort-Tag-Elementen, die bereits erhalten wurden und sich auf die aktuelle Anfrage beziehen, können unvollständig sein. Die Clientanwendung kann eine Logik für die Entscheidung, ob die Informationen verworfen oder aufbewahrt werden sollen, enthalten.

Wenn auf dem Junos XML-Protokollserver ein weniger schwerwiegendes Problem auftreten, kann er stattdessen ein <xnm:warning> Tag-Element ausstrahlen. Die übliche Antwort für die Client-Anwendung besteht in diesem Fall darin, die Warnung zu protokollieren oder an den Benutzer zu übergeben und die Antwort des Servers weiter zu analysieren.