Zuordnen von Konfigurationsanweisungen zu Junos XML-Tag-Elementen

Mapping für Hierarchieebenen und Containeranweisungen

Bei dem <configuration> Element handelt es sich um das Junos-XML-Containerelement der obersten Ebene für Konfigurationsanweisungen. Sie entspricht der [edit] Hierarchieebene im CLI-Konfigurationsmodus. Die meisten Anweisungen auf den nächsten Ebenen der Konfigurationshierarchie sind Containeranweisungen. Das Junos XML-Container-Tag-Element, das einer Containeranweisung entspricht, hat fast immer den gleichen Namen wie die Anweisung.

Das folgende Beispiel zeigt die Junos XML-Tag-Elemente für zwei Anweisungen auf der obersten Ebene der Konfigurationshierarchie. Beachten Sie, dass eine schließende geschweifte Klammer in einer CLI-Konfigurationsanweisung einem schließenden Junos XML-Tag entspricht.

Mapping für Objekte, die einen Bezeichner haben

Auf einigen Hierarchieebenen kann dieselbe Art von Konfigurationsobjekt mehrmals vorkommen. Jede Instanz des Objekts verfügt über einen eindeutigen Bezeichner, um sie von den anderen Instanzen zu unterscheiden. In der CLI-Notation besteht die übergeordnete Anweisung für ein solches Objekt aus einem Schlüsselwort und einem Bezeichner der folgenden Form:

keyword ist eine feste Zeichenfolge, die den Typ des zu definierenden Objekts angibt, und identifier ist der eindeutige Name für diese Instanz des Typs. In der Junos XML-API ist das Tag-Element, das dem Schlüsselwort entspricht, ein Container-Tag-Element für untergeordnete Tag-Elemente, die die Merkmale des Objekts darstellen. Der Name des Container-Tag-Elements stimmt in der Regel mit der keyword Zeichenfolge überein.

Die Junos XML-API unterscheidet sich von der CLI in der Behandlung des Bezeichners. Da die Junos XML-API nicht zulässt, dass Container-Tag-Elemente sowohl andere Tag-Elemente als auch nicht getaggte Zeichendaten, wie z. B. einen Bezeichnernamen, enthalten, muss der Bezeichner in ein eigenes Tag-Element eingeschlossen werden. Am häufigsten werden Identifikator-Tag-Elemente für Konfigurationsobjekte aufgerufen <name>. Einige Objekte verfügen über mehrere Bezeichner, die in der Regel andere Namen als <name>. Informationen zum Überprüfen des Namens der einzelnen Bezeichner-Tag-Elemente für ein Konfigurationsobjekt finden Sie im Eintrag für das Objekt in der Junos XML API Configuration Developer Reference.

Hinweis:

Das Junos-Betriebssystem reserviert das Präfix junos- für die Bezeichner von Konfigurationsgruppen, die innerhalb der junos-defaults Konfigurationsgruppe definiert sind. Benutzerdefinierte Bezeichner können nicht mit der Zeichenfolge junos-beginnen.

Bezeichner-Tag-Elemente stellen auch eine Ausnahme von der allgemeinen XML-Konvention dar, dass Tag-Elemente auf derselben Hierarchieebene in beliebiger Reihenfolge angezeigt werden können. Das Bezeichner-Tag-Element kommt immer zuerst innerhalb des Container-Tag-Elements vor.

Die Konfiguration für die meisten Objekte, die über Bezeichner verfügen, umfasst zusätzliche Blattanweisungen, die andere Merkmale des Objekts darstellen. Beispielsweise hat jede BGP-Gruppe, die auf Hierarchieebene [edit protocols bgp group] konfiguriert ist, einen zugeordneten Namen (den Bezeichner) und kann Blattanweisungen für andere Merkmale wie Typ, AS-Nummer (Peer Autonomous System) und Nachbaradresse enthalten. Weitere Informationen zur Junos-XML-Zuordnung für Blattanweisungen finden Sie unter Zuordnung für Blattanweisungen mit einem Wert und in fester Form, Zuordnung für Blattanweisungen mit mehreren Werten und Zuordnung für mehrere Optionen in einer oder mehreren Zeilen.

Das folgende Beispiel zeigt die Junos XML-Tag-Elemente für Konfigurationsanweisungen, die zwei BGP-Gruppen namens <name> und definieren <name>. Beachten Sie, dass das Junos XML-Element <name> , das den Bezeichner jeder Gruppe (und den Bezeichner des Nachbarn innerhalb einer Gruppe) umschließt, keine Entsprechung in den CLI-Anweisungen hat.

Mapping für einwertige und festformatige Blattanweisungen

Eine Blattanweisung ist eine CLI-Konfigurationsanweisung, die keine anderen Anweisungen enthält. Die meisten Blattanweisungen definieren einen Wert für ein Merkmal eines Konfigurationsobjekts und haben die folgende Form:

Im Allgemeinen ist der Name des Junos-XML-Tag-Elements, das einer Blattanweisung entspricht, mit der keyword Zeichenfolge identisch. Die Zeichenfolge zwischen den öffnenden und schließenden Junos-XML-Tags ist identisch mit der value Zeichenfolge.

Das folgende Beispiel zeigt die Junos-XML-Tag-Elemente für zwei Blattanweisungen, die über ein Schlüsselwort und einen Wert verfügen: die message Anweisung auf der [edit system login] Hierarchieebene und die preference Anweisung auf der [edit protocols ospf] Hierarchieebene.

Einige Blattanweisungen bestehen nur aus einem Schlüsselwort in fester Form ohne zugeordneten Wert in variabler Form. Die Junos XML-API stellt solche Anweisungen mit einem leeren Tag dar. Das folgende Beispiel zeigt die Junos XML-Tag-Elemente für die disable Anweisung auf Hierarchieebene [edit forwarding-options sampling] .

Mapping für Blattanweisungen mit mehreren Werten

Einige Junos OS-Blattanweisungen akzeptieren mehrere Werte, die entweder benutzerdefiniert sein oder aus einem Satz vordefinierter Werte gezogen werden können. Bei der CLI-Notation werden eckige Klammern verwendet, um alle Werte in eine einzelne Anweisung einzuschließen, wie im Folgenden dargestellt:

Die Junos XML-API schließt stattdessen jeden Wert in ein eigenes Tag-Element ein. Das folgende Beispiel zeigt die Junos XML-Tag-Elemente für eine CLI-Anweisung mit mehreren benutzerdefinierten Werten. Die import Anweisung importiert zwei Routing-Richtlinien, die an anderer Stelle in der Konfiguration definiert sind.

Das folgende Beispiel zeigt die Junos-XML-Tag-Elemente für eine CLI-Anweisung mit mehreren vordefinierten Werten. Die permissions Anweisung gewährt Mitgliedern der user-accounts login-Klasse drei vordefinierte Berechtigungen.

Mapping für mehrere Optionen in einer oder mehreren Zeilen

Bei einigen Junos OS-Konfigurationsobjekten platziert die standardmäßige CLI-Syntax mehrere Optionen in einer einzigen Zeile, in der Regel für eine bessere Lesbarkeit und Prägnanz. In den meisten Fällen identifiziert die erste Option das Objekt und hat kein Schlüsselwort, aber spätere Optionen sind gepaarte Schlüsselwörter und Werte. Die Junos XML-API schließt jede Option in ein eigenes Tag-Element ein. Da die erste Option kein Schlüsselwort in der CLI-Anweisung enthält, weist die Junos XML-API ihrem tag-Element einen Namen zu.

Das folgende Beispiel zeigt die Junos-XML-Tag-Elemente für eine CLI-Konfigurationsanweisung mit mehreren Optionen in einer einzelnen Zeile. Die Junos XML-API definiert ein Tag-Element für beide Optionen und weist dem Tag-Element für die erste Option (10.0.0.1) einen Namen zu, die kein CLI-Schlüsselwort enthält.

Die Syntax für einige Konfigurationsobjekte enthält mehr als eine Multioptionszeile. Auch hier definiert die Junos XML-API für jede Option ein separates Tag-Element. Das folgende Beispiel zeigt Junos XML-Tag-Elemente für eine traceoptions Anweisung auf Hierarchieebene [edit protocols isis] . Die Anweisung verfügt über drei untergeordnete Anweisungen mit jeweils mehreren Optionen.

Mapping für Kommentare zu Konfigurationsanweisungen

Eine Junos OS-Konfiguration kann Kommentare enthalten, die Anweisungen in der Konfiguration beschreiben. Im CLI-Konfigurationsmodus definiert der annotate Befehl den Kommentar, der einer Anweisung auf der aktuellen Hierarchieebene zugeordnet werden soll. Sie können auch einen Texteditor verwenden, um Kommentare direkt in eine Konfigurationsdatei einzufügen. Weitere Informationen finden Sie im CLI-Benutzerhandbuch.

Die Junos XML-API schließt Kommentare zu Konfigurationsanweisungen in das <junos:comment> Element ein. (Diese Kommentare unterscheiden sich von den Kommentaren <!-- , die in den Zeichenfolgen eingeschlossen sind, und --> werden vom Protokollserver automatisch verworfen.)

In der Junos XML-API steht das <junos:comment> Element unmittelbar vor dem Element für die zugehörige Konfigurationsanweisung. (Wenn das tag-Element für die zugeordnete Anweisung weggelassen wird, wird der Kommentar nicht in der Konfigurationsdatenbank aufgezeichnet.) Die Kommentartextzeichenfolge kann eines der beiden Trennzeichen enthalten, die einen Kommentar in der Konfigurationsdatenbank angeben: entweder das # Zeichen vor dem Kommentar oder die gepaarten Zeichenfolgen /* vor und */ nach dem Kommentar. Wenn die Clientanwendung das Trennzeichen nicht enthält, fügt der Protokollserver das entsprechende Trennzeichen hinzu, wenn er den Kommentar zur Konfiguration hinzufügt. Der Protokollserver behält auch alle im Kommentar enthaltenen Leerzeichen bei.

Das folgende Beispiel zeigt die Junos-XML-Tag-Elemente, die Kommentare in einer Beispielkonfigurationsanweisung zwei Anweisungen zuordnen. Der erste Kommentar veranschaulicht, wie das Einfügen von Zeilenumbruchzeichen in den Inhalt des <junos:comment> Elements (/* New backbone area */) dazu führt, dass der Kommentar in einer eigenen Zeile in der Konfigurationsdatei angezeigt wird. Der Inhalt des zweiten <junos:comment> Elements enthält keine Zeilenumbruchzeichen, daher folgt der Kommentar in der Konfigurationsdatei direkt auf die zugehörige Anweisung in derselben Zeile.