Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<get-configuration>

Uso

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.

Nota:

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.

Nota:

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 junos:changed="changed" atributo debe aparecer en la etiqueta de apertura de cada elemento de configuración modificado.

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 <configuration> de nivel superior. Si el elemento de configuración cambiado está representado por una sola etiqueta (vacía), el junos:changed="changed" atributo aparecerá en la etiqueta. Si el elemento cambiado está representado por un elemento de etiqueta de contenedor, el junos:changed="changed" atributo aparecerá en la etiqueta de contenedor de apertura y también en cada elemento de etiqueta secundaria incluido en el elemento etiqueta contenedor.

El database atributo se puede combinar con el changed="changed" atributo para solicitar la configuración candidata o activa:

  • Cuando se solicita la configuración del candidato (el database="candidate" atributo se incluye o database se omite por completo), los elementos agregados a la configuración de candidato después de la última operación de confirmación se marcan con el junos:changed="changed" atributo.

  • Cuando se solicita la configuración activa (se incluye el database="committed" atributo), los elementos agregados a la configuración activa mediante la confirmación más reciente se marcan con el junos:changed="changed" atributo.

    Nota:

    Cuando una operación de confirmación se hace correctamente, el servidor quita el junos:changed="changed" atributo de todos los elementos de etiqueta. Sin embargo, si se generan advertencias durante la confirmación, el atributo no se elimina. En este caso, el atributo aparece en elementos junos:changed="changed" de etiqueta que cambiaron antes de la operación de confirmación, así como en aquellos que cambiaron después de ella.

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 <xnm:warning> elemento tag.

Para quitar el junos:changed="changed" atributo de los elementos que cambiaron antes de la confirmación, realice las acciones necesarias para eliminar la causa de la advertencia y confirme de nuevo la configuración.

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:

  • apply— Muestra la configuración con los cambios de script de confirmación aplicados, incluidos los cambios transitorios y no transitorios. El resultado es equivalente al resultado de la CLI cuando se usa la | display commit-scripts opción.

  • apply-no-transients— Muestra la configuración con los cambios de script de confirmación aplicados, pero excluye los cambios transitorios. El resultado es equivalente al resultado de la CLI cuando se usa la | display commit-scripts no-transients opción.

  • view— Muestra la configuración en formato XML que se introduce en una secuencia de comandos de confirmación. Esto es equivalente a ver la configuración con los atributos inherit="inherit", groups="groups"y changed="changed". El resultado es equivalente al resultado de la CLI cuando se usa la | display commit-scripts view opción.

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 compare atributo se puede combinar con el database atributo para indicar si la configuración candidata o la configuración activa se comparan con la configuración confirmada anteriormente. Si omite el database atributo, la comparación utilizará la configuración de candidato.

El compare atributo acepta los siguientes valores, que indican el método utilizado para hacer referencia a la configuración de comparación:

  • configuration-revision— Haga referencia a la configuración de comparación mediante su cadena de identificador de revisión de configuración, que se define en el configuration-revision="revision-id" atributo.

  • rollback— Haga referencia a la configuración de la comparación mediante su índice de reposición, que se define en el rollback="rollback-number" atributo.

Si incluye el compare atributo, pero omite el correspondiente configuration-revision o rollback proporciona un identificador de revisión de configuración no válido, el servidor utilizará la configuración confirmada más reciente como configuración de comparación.

Cuando se compara la configuración de candidato con la configuración activa, la operación devuelve la compare salida XML. Para todas las demás comparaciones, devuelve el resultado como texto mediante un formato de revisión. Cuando compara la configuración de candidato con la configuración activa, puede mostrar las diferencias en el formato de texto, XML o JSON incluyendo el valor adecuado para el format atributo en la solicitud. Puede mostrar las diferencias en formato XML a partir de Junos OS versión 15.1R1 y puede mostrar las diferencias en formato JSON a partir de Junos OS versión 16.1R1.

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 <configuration> etiqueta en la salida XML y omite el configuration objeto en la salida JSON si la comparación no devuelve ninguna diferencia o si la comparación devuelve diferencias para solo datos de configuración no nativos, por ejemplo, datos de configuración asociados con un modelo de datos OpenConfig.

database

Especifique la configuración desde la cual se mostrarán los datos como uno de los siguientes:

  • candidate— La configuración del candidato.

  • committed— La configuración activa (la que se ha comprometido más recientemente).

El database atributo tiene prioridad sobre el database-path atributo, si ambos están incluidos.

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 $junos-context/commit-context/database-path.

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 database atributos como los database-path , el database atributo tiene prioridad.

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:

  • json—Las instrucciones de configuración se formatearán mediante notación de objetos JavaScript (JSON). 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.

    Nota:

    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. En versiones anteriores, los enteros en los datos de configuración JSON se trataban como cadenas y se adjuntaban entre comillas.

  • set—Las instrucciones de configuración se formatearán como comandos del modo set de configuración de Junos OS.

  • text— Las instrucciones de configuración tienen el formato de texto ASCII mediante el carácter de nueva línea, las pestañas y otros espacios en blanco, corchetes y corchetes para indicar las relaciones jerárquicas entre las instrucciones. Este es el formato utilizado en los archivos de configuración almacenados en un dispositivo que ejecuta Junos OS y que el comando cli show configuration muestra.

  • xml— Las instrucciones de configuración están representadas por los elementos de etiqueta Junos XML correspondientes. Este es el valor predeterminado si se omite el format atributo.

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 json-minified formatos y xml-minified , que devuelven el formato respectivo con espacios innecesarios, pestañas y líneas nuevas eliminadas.

groups

Especifique que el junos:group="group-name" atributo aparezca en la etiqueta de apertura para cada elemento de configuración que se hereda de un grupo de configuración. La group-name variable especifica el nombre del grupo de configuración del que se heredó ese elemento.

El único valor aceptable para el groups atributo es groups. Cuando especifique el groups atributo, también debe especificarlo inherit .

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 inherit atributo, la salida usa los <groups>elementos , <apply-groups>y <apply-groups-except> tag para representar grupos de configuración definidos por el usuario y el <interface-range> elemento tag para representar intervalos de interfaz definidos por el usuario; no incluye elementos de etiqueta para instrucciones definidas en el grupo junos-defaults.

Los valores aceptables son:

  • defaults— El resultado no incluye los <groups>elementos de etiqueta , <apply-groups>y <apply-groups-except> , y, en su lugar, muestra los elementos de etiqueta que se heredan de grupos definidos por el usuario y del grupo junos-defaults como hijos de los elementos de etiqueta heredados.

  • inherit— El resultado no incluye los <groups>elementos de etiqueta , <apply-groups>, <apply-groups-except>, y <interface-range> , en su lugar, muestra los elementos de etiqueta que se heredan de grupos y rangos definidos por el usuario como hijos de los elementos de etiqueta heredados. El resultado no incluye elementos de etiqueta para instrucciones definidas en el grupo junos-defaults.

interface-ranges

Especifique que el junos:interface-ranges="source-interface-range" atributo aparezca en la etiqueta de apertura para cada elemento de configuración que se hereda de un intervalo de interfaz. La source-interface-range variable especifica el nombre del intervalo de interfaz.

El único valor aceptable para el interface-ranges atributo es interface-ranges. Cuando especifique el interface-ranges atributo, también debe especificarlo inherit .

junos:key | key

Especifique que el junos:key="key" atributo aparezca en la etiqueta de apertura de cada elemento que sirva como identificador para un objeto de configuración. El único valor aceptable es key.

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.