Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<get-configuration>

Verwendung

Beschreibung

Fordern Sie Konfigurationsdaten vom NETCONF- oder Junos XML-Protokollserver an. Die Attribute geben die Quelle und Die Formatierung der anzuzeigenen Daten an.

Wenn eine Clientanwendung den Junos XML-Protokollbetrieb <open-configuration> ausgibt, um eine bestimmte Konfigurationsdatenbank zu öffnen, bevor der <get-configuration> Vorgang ausgeführt wird, gibt der Server die Konfigurationsdaten aus der offenen Konfigurationsdatenbank zurück. Andernfalls gibt der Server die Konfigurationsdaten von der Kandidatenkonfiguration zurück, es sei denn, die aktive Konfiguration wird explizit durch Angabe des Attributs database="committed" angefordert.

Eine Clientanwendung kann die gesamte Konfigurationshierarchie oder eine Teilmenge davon anfordern.

  • Um die gesamte Konfigurationshierarchie anzuzeigen, geben Sie das leere <get-configuration/> Tag aus.

  • Um ein Konfigurationselement (Hierarchieebene oder Konfigurationsobjekt) anzuzeigen, emittieren Sie Tag-Elemente innerhalb des <get-configuration> Tag-Elements, um alle Ebenen der Konfigurationshierarchie vom Stamm (dargestellt durch das <configuration> Tag-Element) bis hinunter auf die Ebene oder das objekt anzuzeigen. Um eine Hierarchieebene oder ein Konfigurationsobjekt darzustellen, das keine Kennung hat, geben Sie sie als leeres Tag aus. Um ein Objekt mit einem oder mehreren Identifikatoren darzustellen, geben Sie nur das Container-Tag-Element und die Tag-Elemente der Kennung aus, nicht alle Tag-Elemente, die andere Merkmale darstellen.

Hinweis:

Um Konfigurationsdaten aus einer Instanz der kurzlebigen Konfigurationsdatenbank abzurufen, muss eine Clientanwendung zunächst die kurzlebigen Instanz mithilfe der <open-configuration> entsprechenden untergeordneten Tags öffnen, bevor sie den <get-configuration> Vorgang abgibt. Beim Abrufen kurzlebiger Konfigurationsdaten mithilfe des <get-configuration> Vorgangs sind die einzigen unterstützten format Attribute und key.

Hinweis:

Ab Junos OS Version 13.1 kann ein logischer Systembenutzer innerhalb einer NETCONF- oder Junos XML-Protokollsitzung mithilfe des Junos XML-Betriebs <get-configuration> bestimmte Konfigurationshierarchien für logische Systeme mit untergeordneten Konfigurations-Tags anfordern und die gesamte logische Systemkonfiguration anfordern. Wenn sie die gesamte logische Systemkonfiguration anfordert, enthält die RPC-Antwort das <configuration> Root-Tag. Vor Junos OS Version 13.1 entfällt das <configuration> Root-Tag.

Attribute

changed

Geben Sie an, dass das junos:changed="changed" Attribut im öffnenden Tag jedes geänderten Konfigurationselements angezeigt wird.

Das Attribut wird im öffnenden Tag jedes übergeordneten Tag-Elements im Pfad zum geänderten Konfigurationselement angezeigt, einschließlich des öffnenden <configuration> Tags auf der obersten Ebene. Wenn das geänderte Konfigurationselement durch ein einzelnes (leeres) Tag dargestellt wird, wird das junos:changed="changed" Attribut im Tag angezeigt. Wenn das geänderte Element durch ein Container-Tag-Element dargestellt wird, wird das junos:changed="changed" Attribut im öffnenden Container-Tag und auch in jedem untergeordneten Tag-Element, das im Container-Tag-Element eingeschlossen ist, angezeigt.

Das database Attribut kann mit dem changed="changed" Attribut kombiniert werden, um entweder den Kandidaten oder die aktive Konfiguration anzufordern:

  • Wenn die Kandidatenkonfiguration angefordert wird (das database="candidate" Attribut ist enthalten oder das database Attribut wird vollständig weggelassen), werden Elemente, die der Kandidatenkonfiguration nach dem letzten Commit-Vorgang hinzugefügt wurden, mit dem junos:changed="changed" Attribut markiert.

  • Wenn die aktive Konfiguration angefordert wird (das database="committed" Attribut ist enthalten), werden Elemente, die der aktiven Konfiguration durch den letzten Commit hinzugefügt wurden, mit dem junos:changed="changed" Attribut markiert.

    Hinweis:

    Wenn ein Commit-Vorgang erfolgreich ist, entfernt der Server das junos:changed="changed" Attribut aus allen Tag-Elementen. Wenn beim Commit jedoch Warnungen generiert werden, wird das Attribut nicht entfernt. In diesem Fall wird das junos:changed="changed" Attribut sowohl in Tag-Elementen angezeigt, die sich vor dem Commit-Vorgang geändert haben, als auch in tags, die sich danach geändert haben.

Ein Beispiel für eine Commit-Zeitwarnung ist die Meldung, dass ein Konfigurationselement erst nach dem Neustart des Geräts tatsächlich angewendet wird. Die Warnung wird in der Tag-Zeichenfolge angezeigt, dass der Server zurückkehrt, um den Erfolg des commit zu bestätigen, das in einem <xnm:warning> Tag-Element eingeschlossen ist.

Um das junos:changed="changed" Attribut aus Elementen zu entfernen, die sich vor dem Commit geändert haben, führen Sie die erforderlichen Maßnahmen aus, um die Ursache der Warnung zu beseitigen, und bestätigen Sie die Konfiguration erneut.

commit-scripts

Fordern Sie an, dass auf dem NETCONF- oder Junos XML-Protokollserver XML-Daten im Commit-Script-Stil angezeigt werden. Der Wert des Attributs bestimmt die Ausgabe. Akzeptable Werte sind:

  • apply— Anzeige der Konfiguration mit übernommenen Commit-Skriptänderungen, einschließlich transienter und nicht-transienter Änderungen. Die Ausgabe entspricht der CLI-Ausgabe bei Verwendung der | display commit-scripts Option.

  • apply-no-transients— Zeigt die Konfiguration mit übernommenen Commit-Skriptänderungen an, schließt jedoch vorübergehende Änderungen aus. Die Ausgabe entspricht der CLI-Ausgabe bei Verwendung der | display commit-scripts no-transients Option.

  • view– Zeigt die Konfiguration im XML-Format an, das in ein Commit-Skript eingegeben wird. Dies entspricht dem Anzeigen der Konfiguration mit den Attributen inherit="inherit", groups="groups"und changed="changed". Die Ausgabe entspricht der CLI-Ausgabe bei Verwendung der | display commit-scripts view Option.

compare

Fordern Sie an, dass der NETCONF- oder Junos XML-Protokollserver die Unterschiede zwischen der aktiven oder der Kandidatenkonfiguration und einer zuvor zugesagten Konfiguration (die Vergleichskonfiguration) anzeigt.

Das compare Attribut kann mit dem database Attribut kombiniert werden, um anzugeben, ob die Kandidatenkonfiguration oder die aktive Konfiguration mit der zuvor zugesagten Konfiguration verglichen wird. Wenn Sie das database Attribut weglassen, verwendet der Vergleich die Kandidatenkonfiguration.

Das compare Attribut akzeptiert die folgenden Werte, die die Methode angeben, mit der die Vergleichskonfiguration referenziert wird:

  • configuration-revision– Referenz der Vergleichskonfiguration anhand der konfigurations revisionsbezeichnerden Zeichenfolge, die Sie im configuration-revision="revision-id" Attribut definieren.

  • rollback— Referenz der Vergleichskonfiguration anhand des Rollback-Index, den rollback="rollback-number" Sie im Attribut definieren.

Wenn Sie das compare Attribut angeben, aber entweder das entsprechende oder rollback das entsprechende configuration-revision Attribut auslassen oder eine ungültige Konfigurationsversionskennung angeben, verwendet der Server die zuletzt zugesagte Konfiguration als Vergleichskonfiguration.

Wenn Sie die Kandidatenkonfiguration mit der aktiven Konfiguration vergleichen, gibt der Vorgang die compare XML-Ausgabe zurück. Für alle anderen Vergleiche gibt er die Ausgabe im Patchformat als Text zurück. Wenn Sie die Kandidatenkonfiguration mit der aktiven Konfiguration vergleichen, können Sie die Unterschiede im Text-, XML- oder JSON-Format anzeigen, indem Sie den entsprechenden Wert für das format Attribut in der Anfrage einblenden. Sie können die Unterschiede im XML-Format ab Junos OS Version 15.1R1 anzeigen und die Unterschiede im JSON-Format ab Junos OS Version 16.1R1 anzeigen.

Hinweis:

Wenn Sie den Kandidaten und die aktiven Konfigurationen vergleichen und die Unterschiede im XML- oder JSON-Format anzeigen, wird ab Junos OS Version 16.2R2 das Tag in der XML-Ausgabe ausgelassen <configuration> und das configuration Objekt in der JSON-Ausgabe ausgelassen, wenn der Vergleich entweder keine Unterschiede zurückgibt oder wenn der Vergleich Unterschiede für nur nicht native Konfigurationsdaten zurückgibt, beispielsweise Konfigurationsdaten, die mit einem OpenConfig-Datenmodell verknüpft sind.

database

Geben Sie die Konfiguration an, von der aus Daten als eine der folgenden angezeigt werden sollen:

  • candidate— Die Kandidatenkonfiguration.

  • committed— Die aktive Konfiguration (diejenige, die zuletzt zugesagt wurde).

Das database Attribut hat Vorrang vor dem database-path Attribut, wenn beide enthalten sind.

database-path

In einem Commit-Skript gibt dieses Attribut den Pfad zur Kandidatenkonfiguration vor der Vererbung der Sitzung an. Der einzige akzeptable Wert ist $junos-context/commit-context/database-path.

Für normale Konfigurationssitzungen ruft das Commit-Skript die normale Kandidatenkonfiguration vor der Vererbung ab. Für private Konfigurationssitzungen ruft das Commit-Skript die private Kandidatenkonfiguration vor der Vererbung ab.

Wenn Sie sowohl die Attribute als auch die database database-path Attribute enthalten, hat das database Attribut Vorrang.

format

Geben Sie das Format an, in dem der NETCONF- oder Junos XML-Protokollserver die Konfigurationsdaten zurückgibt. Akzeptable Werte sind:

  • json— Konfigurationsanweisungen werden mitHilfe von JavaScript Object Notation (JSON) formatiert. Ab Junos OS Version 16.1 geben Geräte, auf denen Junos OS ausgeführt wird, Konfigurationsdaten im JSON-Format mit einer neuen Standardimplementierung für die Serialisierung aus.

    Hinweis:

    Ab Junos OS Releases 16.1R4, 16.2R2 und 17.1R1 werden ganzzahlige In-Junos OS-Konfigurationsdaten, die im JSON-Format emittiert werden, nicht in Anführungszeichen eingeschlossen. In früheren Versionen wurden Ganzzahl in JSON-Konfigurationsdaten als Zeichenfolgen behandelt und in Anführungszeichen eingeschlossen.

  • set— Konfigurationsanweisungen werden als Konfigurationsmodusbefehle set für Junos OS formatiert.

  • text— Konfigurationsanweisungen werden als ASCII-Text formatiert, wobei das Newline-Zeichen, die Registerkarten und andere Leerzeichen, Klammern und eckige Klammern verwendet werden, um die hierarchischen Beziehungen zwischen den Anweisungen anzuzeigen. Dies ist das Format, das in Konfigurationsdateien verwendet wird, die auf einem Gerät mit Junos OS gespeichert und mithilfe des CLI-Befehls show configuration angezeigt werden.

  • xml— Konfigurationsanweisungen werden durch die entsprechenden Junos XML-Tag-Elemente dargestellt. Dies ist der Standardwert, wenn das format Attribut weggelassen wird.

Hinweis:

Ab Junos OS Version 21.1R1 und Junos OS Evolved Version 22.3R1 unterstützen NETCONF-Sitzungen zusätzlich die formate und xml-minified die json-minified formate, die das jeweilige Format mit unnötigen Leerzeichen, Tabs und Neuzugängen zurücksendeten.

groups

Geben Sie an, dass das junos:group="group-name" Attribut im öffnenden Tag für jedes Konfigurationselement angezeigt wird, das von einer Konfigurationsgruppe geerbt wird. Die group-name Variable gibt den Namen der Konfigurationsgruppe an, von der dieses Element geerbt wurde.

Der einzige akzeptable Wert für das groups Attribut ist groups. Wenn Sie das groups Attribut angeben, müssen Sie auch das inherit Attribut angeben.

inherit

Geben Sie an, wie der NETCONF- oder Junos XML-Protokollserver Anweisungen anzeigt, die in Konfigurationsgruppen und Schnittstellenbereichen definiert sind. Wenn das inherit Attribut weggelassen wird, verwendet die Ausgabe die <groups>, <apply-groups>und <apply-groups-except> Tag-Elemente, um benutzerdefinierte Konfigurationsgruppen darzustellen, und verwendet das <interface-range> Tag-Element, um benutzerdefinierte Schnittstellenbereiche darzustellen. Es enthält keine Tag-Elemente für Anweisungen, die in der Junos-Standardgruppe definiert sind.

Die akzeptablen Werte sind:

  • defaults– Die Ausgabe umfasst nicht die <groups>, <apply-groups>und <apply-groups-except> Tag-Elemente, sondern zeigt stattdessen Tag-Elemente an, die von benutzerdefinierten Gruppen und von der Junos-Standardgruppe als Untergeordnete der erbenden Tag-Elemente geerbt wurden.

  • inherit– Die Ausgabe umfasst nicht die <groups>, <apply-groups>und <apply-groups-except><interface-range> Tag-Elemente, sondern zeigt Stattdessen Tag-Elemente an, die von benutzerdefinierten Gruppen und Bereichen als Untergeordnete der erbenden Tag-Elemente geerbt werden. Die Ausgabe enthält keine Tag-Elemente für Anweisungen, die in der Junos-Standardgruppe definiert sind.

interface-ranges

Geben Sie an, dass das junos:interface-ranges="source-interface-range" Attribut im öffnenden Tag für jedes Konfigurationselement angezeigt wird, das von einem Schnittstellenbereich geerbt wird. Die source-interface-range Variable gibt den Namen des Schnittstellenbereichs an.

Der einzige akzeptable Wert für das interface-ranges Attribut ist interface-ranges. Wenn Sie das interface-ranges Attribut angeben, müssen Sie auch das inherit Attribut angeben.

junos:key | key

Geben Sie an, dass das junos:key="key" Attribut im öffnenden Tag jedes Elements angezeigt wird, das als Bezeichner für ein Konfigurationsobjekt dient. Der einzige akzeptable Wert ist key.

Versionsinformationen

Hierbei handelt es sich um einen Junos XML-Managementprotokollbetrieb. Es wird in Junos XML-Protokollsitzungen unterstützt und als proprietäre Erweiterung von Juniper Networks in NETCONF-Sitzungen auf Geräten mit Junos OS unterstützt, die den URI http://xml.juniper.net/netconf/junos/1.0 im Capabilities Exchange identifizieren.

interface-ranges Attribut in Junos OS Version 10.3R1 hinzugefügt.

commit-scripts Attributwerte apply hinzugefügt und apply-no-transients in Junos OS Version 12.1 hinzugefügt

database-path Attribut hinzugefügt in Junos OS Version 12.2.

format Attributwert json hinzugefügt in Junos OS Version 14.2.

format Attributwert set hinzugefügt in Junos OS Version 15.1.

Ab Junos OS Version 16.1 geben Geräte, auf denen Junos OS ausgeführt wird, Konfigurationsdaten im JSON-Format mit einer neuen Standardimplementierung für die Serialisierung aus.

Ab Junos OS Releases 16.1R4, 16.2R2 und 17.1R1 werden ganzzahlige In-Junos OS-Konfigurationsdaten, die im JSON-Format emittiert werden, nicht in Anführungszeichen eingeschlossen.

compare Attributwert configuration-revision hinzugefügt in Junos OS Version 20.4R1 und Junos OS Evolved Version 20.4R1.

format Attributwerte json-minified hinzugefügt und xml-minified nur für NETCONF-Sitzungen in Junos OS Version 21.1R1 und Junos OS Evolved Version 22.3R1 hinzugefügt.