Angeben des Ausgabeformats für Konfigurationsdaten in einer Junos XML-Protokollsitzung

In einer Junos XML-Protokollsitzung mit einem Gerät, auf dem Junos OS ausgeführt wird, schließt eine Clientanwendung das <get-configuration> Element in ein Tag ein <rpc> , um Informationen zu einer Konfiguration auf einer Routing-, Switching- oder Sicherheitsplattform anzufordern. Die Clientanwendung kann die Formatierung der Konfigurationsdaten angeben, die vom Junos XML-Protokollserver zurückgegeben werden, indem sie optionale Attribute im <get-configuration> Tag festlegt.

Um anzufordern, dass der Junos XML-Protokollserver Konfigurationsinformationen in der mit Junos XML-Tags versehenen Ausgabe zurückgibt, nimmt die Clientanwendung das Attribut entweder in das Tag oder das öffnende <get-configuration> Tag auf oder lässt das format="xml" <get-configuration/> Attribut vollständig weg. Der Junos XML-Protokollserver gibt standardmäßig eine Ausgabe mit Junos-XML-Tags zurück, es sei denn, das compare Attribut ist enthalten.

Wenn Sie anfordern möchten, dass der Junos XML-Protokollserver Konfigurationsinformationen als formatierten ASCII-Text zurückgibt, anstatt sie mit Junos XML-Tag-Elementen zu versehen, fügt die Clientanwendung das Attribut in das format="text" Tag oder <get-configuration> öffnende <get-configuration/> Tag ein.

Ab Junos OS Version 15.1 schließt die Clientanwendung das Attribut in das format="set" Tag oder <get-configuration> öffnende <get-configuration/> Tag ein, um anzufordern, dass der Junos XML-Protokollserver Konfigurationsinformationen als Konfigurationsmodusbefehle set anstelle von Junos XML-Tag-Elementen zurückgibt. Die Clientanwendung schließt die Anforderung in ein tag-Element ein<rpc>.

Ab Junos OS Version 14.2 kann eine Clientanwendung anfordern, dass der Junos XML-Protokollserver Konfigurationsinformationen im JSON-Format (JavaScript Object Notation) zurückgibt. Wenn Sie Konfigurationsdaten im JSON-Format zurückgeben möchten, anstatt sie mit Junos-XML-Tag-Elementen zu versehen, schließt die Clientanwendung das Attribut in das Tag oder das format="json" öffnende <get-configuration/> <get-configuration> Tag ein. Die Clientanwendung schließt die Anforderung in ein tag-Element ein <rpc> .

Informationen zu den Tag-Elementen, die in das Tag-Element eingeschlossen werden sollen, finden Sie unter Angeben des Umfangs der Konfigurationsdaten, die in einer Junos XML-Protokollsitzung zurückgegeben werden sollen.<get-configuration>

Hinweis:

Unabhängig davon, welches Ausgabeformat angefordert wird, verwenden Clientanwendungen Junos XML-Tag-Elemente, um die anzuzeigenden Konfigurationselemente darzustellen. Das format Attribut steuert nur das Format der Ausgabe des Junos-XML-Protokollservers.

Wenn die Anwendung Junos XML-Tag-Elemente anfordert, schließt der Junos XML-Protokollserver seine Ausgabe in und <configuration> Tag-Elemente ein<rpc-reply>. Weitere Informationen zu den Attributen im öffnenden <configuration> Tag finden Sie unter Angeben der Quelle für Konfigurationsinformationsanforderungen in einer Junos XML-Protokollsitzung.

Wenn die Anwendung eine formatierte ASCII-Ausgabe anfordert, formatiert der Junos XML-Protokollserver seine Antwort auf die gleiche Weise wie der CLI-Befehl show configuration Konfigurationsdaten anzeigt – er verwendet das Zeilenumbruchzeichen, Tabulatoren, geschweifte Klammern und eckige Klammern, um die hierarchischen Beziehungen zwischen Konfigurationsanweisungen anzugeben. Der Server schließt formatierte ASCII-Konfigurationsanweisungen in <rpc-reply> und <configuration-text> tag-Elemente ein.

Wenn die Anwendung Befehle für den Konfigurationsmodus set anfordert, formatiert der Junos XML-Protokollserver seine Antwort auf die gleiche Weise, wie der CLI-Befehl show configuration | display set Konfigurationsdaten anzeigt. Der Server umschließt die Daten in <rpc-reply> und <configuration-set> tag-Elemente.

Wenn die Anwendung das JSON-Format anfordert, schließt der Junos XML-Protokollserver die JSON-Daten in und <configuration-json> Tag-Elemente ein<rpc-reply>.

Hinweis:

Ab Junos OS Version 16.1 geben Geräte mit Junos OS JSON-formatierte Konfigurationsdaten mithilfe einer neuen Standardimplementierung für die Serialisierung aus.

Hinweis:

Ab den Junos OS-Versionen 16.1R4, 16.2R2 und 17.1R1 werden Ganzzahlen in Junos OS-Konfigurationsdaten, die im JSON-Format ausgegeben werden, nicht in Anführungszeichen gesetzt. In früheren Versionen werden ganze Zahlen in JSON-Konfigurationsdaten als Zeichenfolgen behandelt und in Anführungszeichen eingeschlossen.

Das format Attribut kann mit einem oder mehreren der folgenden anderen Attribute im Tag oder <get-configuration> öffnenden <get-configuration/> Tag kombiniert werden:

• compare mit dem Wert compare="rollback" und mit rollback="0". Wenn Sie die Kandidatenkonfiguration mit der aktiven Konfiguration (rollback="0") vergleichen, können Sie die Unterschiede in anderen Formaten als Text anzeigen, indem Sie den entsprechenden Wert für das format Attribut in die Anforderung aufnehmen. Sie können die Unterschiede im XML-Format ab Junos OS Version 15.1R1 und Sie können die Unterschiede im JSON-Format ab Junos OS Version 16.1R1 anzeigen.

• commit-scripts mit dem Wert commit-scripts="apply" oder commit-scripts="apply-no-transients". Das commit-scripts="view" Attribut gibt standardmäßig eine Ausgabe mit Junos-XML-Tags zurück, auch wenn das Attribut enthalten ist, da dies das Format ist, das format="text" für Commit-Skripts eingegeben wird.

• database, die unter Angeben der Quelle für Konfigurationsinformationsanforderungen in einer Junos XML-Protokollsitzung beschrieben wird

• inheritund optional groups und , die unter Angeben des Ausgabeformats für Konfigurationsgruppen und Schnittstellenbereiche mithilfe des Junos XML-Protokolls interface-rangesbeschrieben werden

Es ist nicht sinnvoll, das format="text" Attribut mit dem changed Attribut zu kombinieren (beschrieben unter Anfordern von Änderungsindikatoren für Konfigurationselemente mithilfe des Junos XML-Protokolls) oder es nach dem Anfordern eines Indikators für Bezeichner einzuschließen (beschrieben unter Anfordern von Bezeichnerindikatoren für Konfigurationselemente unter Verwendung des Junos XML-Protokolls). Die Änderungs- und Bezeichnerindikatoren werden nur in der Junos-Ausgabe mit XML-Tags und in der JSON-Ausgabe angezeigt.

Eine Anwendung kann für die gesamte Konfiguration oder einen Teil davon eine Ausgabe mit Junos-XML-Tags, formatierten ASCII-Text, Konfigurationsmodusbefehle set oder JSON-Ausgaben anfordern. Anweisungen zum Angeben der zurückzugebenden Datenmenge finden Sie unter Angeben des Bereichs der Konfigurationsdaten, die in einer Junos XML-Protokollsitzung zurückgegeben werden sollen.

Das folgende Beispiel zeigt, wie Sie eine formatierte ASCII-Ausgabe von der Hierarchieebene in der [edit policy-options] Kandidatenkonfiguration anfordern.