EN ESTA PÁGINA
<get-configuration>
Uso
<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>
Descripción
Solicite datos de configuración al servidor de protocolos NETCONF o Junos XML. Los atributos especifican el origen y el formato de los datos que se mostrarán.
Si una aplicación cliente emite la operación del protocolo <open-configuration>
XML de Junos para abrir una base de datos de configuración específica antes de ejecutar la <get-configuration>
operación, el servidor devuelve los datos de configuración de la base de datos de configuración abierta. De lo contrario, el servidor devuelve los datos de configuración de la configuración candidata, a menos que la configuración activa se solicite explícitamente mediante la inclusión del database="committed"
atributo.
Una aplicación cliente puede solicitar toda la jerarquía de configuración o un subconjunto de ella.
Para mostrar toda la jerarquía de configuración, emita la etiqueta vacía
<get-configuration/>
.Para mostrar un elemento de configuración (nivel de jerarquía u objeto de configuración), emita elementos de etiqueta dentro del
<get-configuration>
elemento tag para representar todos los niveles de la jerarquía de configuración desde la raíz (representada por el<configuration>
elemento tag) hasta el nivel u objeto que se muestre. Para representar un nivel de jerarquía o un objeto de configuración que no tenga un identificador, emita como una etiqueta vacía. Para representar un objeto que tiene uno o varios identificadores, emita solo su elemento de etiqueta de contenedor y sus elementos de etiqueta identificadora, no todos los elementos de etiqueta que representen otras características.
Para recuperar datos de configuración de una instancia de la base de datos de configuración efímera, una aplicación cliente debe abrir primero la instancia efímera mediante el uso de la <open-configuration>
operación con las etiquetas secundarias adecuadas antes de emitir la <get-configuration>
operación. Cuando se recuperan datos de configuración efímeros mediante la <get-configuration>
operación, los únicos atributos compatibles son format
y key
.
A partir de Junos OS versión 13.1, dentro de una sesión de protocolo NETCONF o Junos XML, un usuario de sistema lógico puede usar la operación Junos XML <get-configuration>
para solicitar jerarquías de configuración del sistema lógico específicas mediante el uso de etiquetas de configuración secundarias, así como solicitar toda la configuración del sistema lógico. Cuando se solicita la configuración del sistema lógico completo, la respuesta de RPC incluye la <configuration>
etiqueta raíz. Antes de la versión 13.1 de Junos OS, se omite la <configuration>
etiqueta raíz.
Atributos
changed |
Especifique que el El atributo aparece en la etiqueta de apertura de cada elemento de etiqueta principal en la ruta al elemento de configuración cambiado, incluida la etiqueta de apertura El
Un ejemplo de advertencia en tiempo de confirmación es el mensaje que explica que un elemento de configuración no se aplicará realmente hasta que se reinicie el dispositivo. La advertencia aparece en la cadena de etiqueta que el servidor devuelve para confirmar que la confirmación se ha correcto, adjuntada en un Para quitar el |
commit-scripts |
Solicite que el servidor de protocolo XML NETCONF o Junos muestre datos XML estilo commit-script. El valor del atributo determina la salida. Los valores aceptables son:
|
compare |
Solicite que el servidor de protocolo XML NETCONF o Junos muestre las diferencias entre la configuración activa o candidata y una configuración confirmada anteriormente (la configuración de comparación). El El
Si incluye el Cuando se compara la configuración de candidato con la configuración activa, la operación devuelve la
Nota:
A partir de Junos OS versión 16.2R2, cuando se comparan las configuraciones candidatas y activas y se muestran las diferencias en formato XML o JSON, el dispositivo omite la |
database |
Especifique la configuración desde la cual se mostrarán los datos como uno de los siguientes:
El |
database-path |
Dentro de una secuencia de comandos de confirmación, este atributo especifica la ruta a la configuración de candidato de herencia previa de la sesión. El único valor aceptable es Para sesiones de configuración normales, la secuencia de comandos de confirmación recupera la configuración candidata normal y previa a la herencia. Para sesiones de configuración privadas, la secuencia de comandos de confirmación recupera la configuración de candidato privada y previa a la herencia. Si se incluyen tanto los |
format |
Especifique el formato en el que el servidor de protocolos NETCONF o Junos XML devuelve los datos de configuración. Los valores aceptables son:
Nota:
A partir de Junos OS versión 21.1R1 y Junos OS Evolved versión 22.3R1, las sesiones de NETCONF admiten además los |
groups |
Especifique que el El único valor aceptable para el |
inherit |
Especifique cómo el servidor de protocolo XML NETCONF o Junos muestra las instrucciones definidas en los grupos de configuración y los intervalos de interfaz. Si se omite el Los valores aceptables son:
|
interface-ranges |
Especifique que el El único valor aceptable para el |
junos:key | key |
Especifique que el |
Información de versión
Esta es una operación de protocolo de administración XML de Junos. Se admite en las sesiones de protocolo XML de Junos, y se admite como una extensión propietaria de Juniper Networks en sesiones de NETCONF en dispositivos que ejecutan Junos OS que identifican el URI http://xml.juniper.net/netconf/junos/1.0 en el intercambio de capacidades.
interface-ranges
atributo agregado en Junos OS versión 10.3R1.
commit-scripts
valores apply
de atributo y apply-no-transients
agregados en junos OS versión 12.1
database-path
atributo agregado en la versión 12.2 de Junos OS.
format
valor json
de atributo agregado en la versión 14.2 de Junos OS.
format
valor set
de atributo agregado en la versión 15.1 de Junos OS.
A partir de Junos OS versión 16.1, los dispositivos que ejecutan Junos OS emiten datos de configuración con formato JSON mediante una nueva implementación predeterminada para la serialización.
A partir de Junos OS versiones 16.1R4, 16.2R2 y 17.1R1, los enteros en los datos de configuración de Junos OS emitidos en formato JSON no se adjuntan entre comillas.
compare
valor configuration-revision
de atributo agregado en Junos OS versión 20.4R1 y Junos OS Evolved versión 20.4R1.
format
valores json-minified
de atributo y xml-minified
agregados para sesiones de NETCONF solo en Junos OS versión 21.1R1 y Junos OS Evolved versión 22.3R1.