Solicitar datos de configuración mediante NETCONF
En una sesión NETCONF 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 los <get-config>elementos , <source>y <filter> tag en un <rpc> elemento tag. Al incluir el elemento de etiqueta secundaria adecuado en el <source> elemento tag, la aplicación cliente solicita información de la configuración activa o de la configuración candidata o de la base de datos de configuración abierta. Al incluir los elementos de etiqueta secundaria adecuados en el <filter> elemento tag, la aplicación puede solicitar toda la configuración o porciones específicas de la configuración.
<rpc>
<get-config>
<source>
<!-- tag specifying the source configuration -->
<( candidate | running )/>
</source>
<filter type="subtree">
<!-- tag elements representing the configuration elements to return -->
</filter>
</get-config>
</rpc>
]]>]]>
El type="subtree" atributo de la etiqueta de apertura <filter> indica que la aplicación cliente usa elementos de etiqueta JUnos XML para representar los elementos de configuración sobre los que solicita información.
Si una aplicación cliente ejecuta la operación de protocolo <open-configuration> XML de Junos para abrir una base de datos de configuración específica antes de ejecutar la <get-config> operación, establezca el origen para <candidate/> recuperar 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.
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 Bloquear y desbloquear la configuración de candidato mediante NETCONF.
El servidor NETCONF encierra su respuesta en <rpc-reply>, <data>y <configuration> los elementos de etiqueta . Incluye atributos en la etiqueta de apertura <configuration> que indican el espacio de nombres XML para los elementos de etiqueta adjuntos y cuándo se cambió o concomo la configuración por última vez. Para obtener más información acerca de los atributos de la <configuration> etiqueta, consulte Especificar el origen de las solicitudes de información de configuración mediante NETCONF.
<rpc-reply xmlns="URN" xmlns:junos="URL">
<data>
<configuration attributes>
<!-- JUNOS XML tag elements representing configuration elements -->
</configuration>
</data>
</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 Cómo funciona la codificación de caracteres en los dispositivos de Juniper Networks.
Las aplicaciones cliente también pueden solicitar otra información relacionada con la configuración, como una representación de esquema XML de la jerarquía de configuración o información sobre configuraciones previamente confirmadas.