Solicitar cambios de configuración mediante el protocolo XML de Junos
En una sesión de protocolo Junos XML con un dispositivo que ejecuta Junos OS, puede usar operaciones de protocolo Junos XML junto con junos XML, instrucciones set de configuración de interfaz de línea de comandos (CLI) o datos JSON para cambiar la configuración en una plataforma de enrutamiento, conmutación o seguridad. La operación del protocolo <load-configuration> XML de Junos y sus atributos ofrecen una funcionalidad análoga a los comandos de modo de configuración en la CLI de Junos OS. Los elementos de etiqueta Junos XML descritos aquí corresponden a instrucciones de configuración, que se describen en las guías de configuración de Junos OS.
Para cambiar la configuración en un dispositivo que ejecuta Junos OS, la aplicación cliente realiza los procedimientos descritos en las secciones indicadas:
Establece una conexión con el servidor de protocolo XML de Junos en la plataforma de enrutamiento, conmutación o seguridad, como se describe en Conexión al servidor de protocolo XML de Junos.
Inicia una sesión de protocolo JUnos XML, como se describe en Inicio de sesiones de protocolo JUnos XML.
Opcionalmente, bloquea la configuración del candidato, crea una copia privada de la configuración del candidato o abre una instancia de la base de datos de configuración efímera.
El bloqueo de la configuración impide que otros usuarios o aplicaciones la cambien al mismo tiempo. La creación de una copia privada permite que la aplicación realice cambios sin afectar la configuración del candidato hasta que se confirma la copia. 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.
Para obtener más información acerca de la base de datos de configuración efímera, consulte Descripción de la base de datos de configuración efímera y Habilitación y configuración de instancias de la base de datos de configuración efímera.
Encierra el
<load-configuration>elemento tag en un<rpc>elemento tag. Al incluir varios atributos en la<load-configuration>etiqueta, la aplicación puede proporcionar los datos de configuración en un archivo o como una secuencia de etiqueta cargada directamente, y como elementos de etiqueta Junos XML, texto ASCII formateado, datos con formato JSON o comandos del modosetde configuración de Junos OS. La aplicación cliente puede especificar que los datos de configuración reemplazan por completo a la configuración candidata existente, o la aplicación puede especificar la forma en que el servidor de protocolo XML de Junos carga los datos en la configuración del candidato existente, una copia privada o una instancia abierta de la base de datos de configuración efímera. La sintaxis básica es la siguiente:<rpc> <!-- If providing configuration data in a file --> <load-configuration url="file" [optional attributes] /> <!-- If providing configuration data in a data stream --> <load-configuration [optional attributes] > <!-- configuration data --> </load-configuration> </rpc>Acepta la secuencia de etiquetas emitida por el servidor de protocolo XML de Junos en respuesta a cada solicitud y extrae su contenido, como se describe en el análisis de la respuesta del servidor de protocolo XML de Junos.
El servidor de protocolo JUnos XML confirma que incorporó los datos de configuración al devolver el
<load-configuration-results>elemento tag y<load-success/>la etiqueta en el<rpc-reply>elemento tag:<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-success/> </load-configuration-results> </rpc-reply>Si se produce un error en la operación de carga, el
<load-configuration-results>elemento tag encierra el<load-error-count>elemento tag, que indica el número de errores que se han producido. En este caso, la aplicación o un administrador deben eliminar los errores antes de confirmar la configuración.<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-error-count>count</load-error-count> </load-configuration-results> </rpc-reply>(Opcional) Verifica la corrección sintáctica de la configuración del candidato o de una copia privada antes de intentar confirmarla, como se describe en Verificar la sintaxis de la configuración mediante el protocolo XML de Junos.
Confirma los cambios realizados en la configuración del candidato o en la copia privada, como se describe en Confirmar la configuración del candidato mediante el protocolo Junos XML, o confirma los cambios realizados en una instancia abierta de la base de datos de configuración efímera, como se describe en Confirmar y sincronizar datos de configuración efímeros mediante el protocolo NETCONF o Junos XML.
Desbloquea la configuración del candidato si está bloqueada, o cierra una copia privada de la configuración o una instancia abierta de la base de datos de configuración efímera.
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.
Termina la sesión de protocolo JUnos XML y cierra la conexión con el dispositivo, como se describe en Terminación de una sesión de protocolo JUnos XML y Cierre de la conexión.