Solicitar datos de configuración mediante el protocolo XML de Junos
En una sesión de protocolo Junos XML con un dispositivo que ejecuta Junos OS, para solicitar datos de configuración para una plataforma de enrutamiento, conmutación o seguridad, una aplicación cliente encierra el <get-configuration> elemento en una <rpc> etiqueta. Al establecer atributos opcionales, la aplicación cliente puede especificar el origen y el formato de la información de configuración que devuelve el servidor de protocolo Junos XML. Al incluir los elementos de etiqueta secundaria opcional adecuados, la aplicación puede solicitar toda la configuración o partes específicas de la configuración. La sintaxis básica es la siguiente:
<rpc>
<!-- If requesting the complete configuration -->
<get-configuration [optional attributes]/>
<!-- If requesting part of the configuration -->
<get-configuration [optional attributes]>
<configuration>
<!-- tag elements representing the data to return -->
</configuration>
</get-configuration>
</rpc>
Para ver los datos de configuración en una instancia específica de la base de datos de configuración efímera, una aplicación cliente debe abrir la instancia efímera mediante la <open-configuration> operación con las etiquetas secundarias adecuadas antes de ejecutar la <get-configuration> solicitud.
A partir de Junos OS versión 13.1, dentro de una sesión de protocolo Junos XML, un usuario de sistema lógico puede usar la operación de protocolo <get-configuration> Junos XML 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 la configuración completa 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 omitió la <configuration> etiqueta raíz.
El servidor de protocolo JUnos XML encierra su respuesta en un <rpc-reply> elemento tag. Incluye atributos con el junos: prefijo en la etiqueta de apertura <configuration> para indicar cuándo la última vez que se cambió o se contó la configuración y el usuario que la convencionó (los atributos aparecen en varias líneas en la instrucción de sintaxis solo para legibilidad). Para obtener más información acerca de los atributos, consulte Especificar el origen de las solicitudes de información de configuración en una sesión de protocolo XML de Junos.
<rpc-reply xmlns:junos="URL">
<!-- If the application requests Junos XML tag elements -->
<configuration junos:(changed | commit)-seconds="seconds" \
junos:(changed | commit)-localtime="YYYY-MM-DD hh:mm:ss TZ" \
[junos:commit-user="username"]>
<!-- Junos XML tag elements representing configuration elements -->
</configuration>
<!-- If the application requests formatted ASCII text -->
<configuration-text>
<!-- formatted ASCII configuration statements -->
</configuration-text>
<!-- If the application requests configuration mode set commands -->
<configuration-set>
<!-- configuration mode commands -->
</configuration-set>
<!-- If the application requests JSON format -->
<configuration-json>
<!-- JSON configuration data -->
</configuration-json>
</rpc-reply>
Si se devuelve un elemento de etiqueta Junos XML dentro de un <undocumented> elemento tag, el elemento de configuración correspondiente no se documenta en las guías de configuración de Junos OS ni es compatible oficialmente con Juniper Networks. La mayoría de las veces, el elemento adjunto solo se usa para la depuración por el personal de soporte. En un número menor de casos, el elemento ya no se admite o se movió a otra área de la jerarquía de configuración, pero aparece en la ubicación actual para compatibilidad con versiones anteriores.
Cuando se muestran datos operativos o de configuración que contienen caracteres fuera del conjunto de caracteres ASCII de 7 bits, Junos OS escapa y codifica estos caracteres mediante la referencia de caracteres decimales UTF-8 equivalente. Para obtener más información, consulte Descripción de la codificación de caracteres en dispositivos que ejecutan Junos OS.
Para las páginas de referencia de los <configuration>elementos de etiqueta , <configuration-json>, <configuration-set><configuration-text>, y <undocumented> de etiqueta, consulte la Referencia del desarrollador operativo de la API XML de Junos.
Si la aplicación cliente bloquea la configuración del candidato antes de realizar solicitudes, debe desbloquearla después de realizar sus solicitudes de lectura. Otros usuarios y aplicaciones no pueden cambiar la configuración mientras permanece bloqueada. Para obtener más información, consulte Bloqueo y desbloqueo de la configuración de candidato o Creación de una copia privada con el protocolo XML de Junos.
Los temas siguientes describen cómo una aplicación cliente especifica el origen, el formato y la cantidad de información que devuelve el servidor de protocolo XML de Junos:
Las aplicaciones también pueden solicitar otra información relacionada con la configuración, incluida una representación de esquema XML de la jerarquía de configuración o información sobre configuraciones previamente confirmadas. Para obtener más información, consulte lo siguiente:
Recuperar una configuración anterior (revertir) mediante el protocolo XML de Junos
Recuperación de la configuración de Rescate mediante el protocolo XML de Junos
Comparación de dos configuraciones anteriores (reposición) con el protocolo XML de Junos
Solicitar un esquema XML para la jerarquía de configuración mediante el protocolo XML de Junos