AUF DIESER SEITE
<get-configuration>
Verwendung
<rpc>
<get-configuration
[changed="changed"]
[commit-scripts="( apply | apply-no-transients | view )"]
[compare=("configuration-revision" [configuration-revision="revision-id"] | "rollback" [rollback="[0-49]"])]
[database="(candidate | committed)"]
[database-path=$junos-context/commit-context/database-path]
[format="( json | set | text | xml )"]
[inherit="( defaults | inherit )"
[groups="groups"] [interface-ranges="interface-ranges"]]
[(junos:key | key )="key"] >
<!-- tag elements for the configuration element to display -->
</get-configuration>
</rpc>
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.
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.
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 Das Attribut wird im öffnenden Tag jedes übergeordneten Tag-Elements im Pfad zum geänderten Konfigurationselement angezeigt, einschließlich des öffnenden Das
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 Um das |
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:
|
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 Das
Wenn Sie das Wenn Sie die Kandidatenkonfiguration mit der aktiven Konfiguration vergleichen, gibt der Vorgang die
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 |
database |
Geben Sie die Konfiguration an, von der aus Daten als eine der folgenden angezeigt werden sollen:
Das |
database-path |
In einem Commit-Skript gibt dieses Attribut den Pfad zur Kandidatenkonfiguration vor der Vererbung der Sitzung an. Der einzige akzeptable Wert ist 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 |
format |
Geben Sie das Format an, in dem der NETCONF- oder Junos XML-Protokollserver die Konfigurationsdaten zurückgibt. Akzeptable Werte sind:
Hinweis:
Ab Junos OS Version 21.1R1 und Junos OS Evolved Version 22.3R1 unterstützen NETCONF-Sitzungen zusätzlich die formate und |
groups |
Geben Sie an, dass das Der einzige akzeptable Wert für das |
inherit |
Geben Sie an, wie der NETCONF- oder Junos XML-Protokollserver Anweisungen anzeigt, die in Konfigurationsgruppen und Schnittstellenbereichen definiert sind. Wenn das Die akzeptablen Werte sind:
|
interface-ranges |
Geben Sie an, dass das Der einzige akzeptable Wert für das |
junos:key | key |
Geben Sie an, dass das |
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.