Asignar Junos OS comandos y salida de comandos a elementos de etiqueta XML de Junos
La API XML de Junos es una representación XML de instrucciones Junos OS configuración y comandos de modo operativo. Define un equivalente XML para todas las instrucciones de la jerarquía de configuración de Junos OS y muchos de los comandos que se emiten en CLI modo operativo. Cada comando de modo operativo con un homólogo XML de Junos se asigna a un elemento de etiqueta de solicitud y, si fuera necesario, a un elemento de etiqueta de respuesta.
Los elementos de etiqueta de solicitud se utilizan en llamadas de procedimiento remoto (RPC) dentro de las sesiones de protocolo XML NETCONF y Junos para solicitar información desde un dispositivo que ejecuta Junos OS. El servidor devuelve la respuesta mediante elementos de etiqueta XML De Junos encerrados dentro del elemento de etiqueta de respuesta. Por ejemplo, el comando show interfaces se asigna a la <get-interface-information> etiqueta de solicitud y el servidor devuelve la etiqueta <interface-information> de respuesta.
En las siguientes secciones se describe cómo asignar comandos, opciones de comando y salida de comandos a elementos de etiqueta XML de Junos.
Asignación de salida de comandos a elementos XML de Junos
En el Junos OS interfaz de línea de comandos (CLI), para mostrar el resultado del comando como elementos de etiqueta XML de Junos en lugar de como el texto ASCII formatado predeterminado, | display xml incluya la opción después del comando. Los elementos de etiqueta que describen la configuración de Junos OS o los datos operativos pertenecen a la API XML de Junos, la cual define el contenido Junos OS que se puede recuperar y manipular mediante las operaciones del protocolo de administración NETCONF y Junos XML.
show chassis hardware En el ejemplo siguiente se muestra el resultado del comando emitido en un enrutador M20 que se ejecuta en Junos OS versión 9.3 (<chassis-inventory>la etiqueta de apertura aparece en dos líneas solo para la viabilidad). Esto es idéntico a la respuesta del servidor para la solicitud <get-chassis-inventory> RPC.
user@host> show chassis hardware | display xml
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/9.3R1/junos">
<chassis-inventory \
xmlns="http://xml.juniper.net/junos/9.3R1/junos-chassis">
<chassis junos:style="inventory">
<name>Chassis</name>
<serial-number>00118</serial-number>
<description>M20</description>
<chassis-module>
<name>Backplane</name>
<version>REV 06</version>
<part-number>710-001517</part-number>
<serial-number>AB5911</serial-number>
</chassis-module>
<chassis-module>
<name>Power Supply A</name>
<!-- other child tags of <chassis-module> -->
</chassis-module>
<!-- other child tags of <chassis> -->
</chassis>
</chassis-inventory>
</rpc-reply>
Asignar comandos a elementos de etiqueta de solicitud XML de Junos
Puede encontrar información acerca de los comandos de modo operativo Junos OS disponibles y sus etiquetas de solicitud RPC XML equivalentes de Junos en la herramienta Junos XML API Explorer - Operational Tags y el Junos OS CLI. Puede usar la herramienta para comprobar un comando, asignar el comando a su etiqueta de solicitud RPC XML y etiquetas secundarias equivalentes Junos XML y ver la etiqueta de respuesta esperada para varias versiones Junos OS diferentes.
También puede mostrar los elementos de etiqueta de solicitud XML de Junos para cualquier comando de modo operativo que tenga un homólogo XML de Junos en el Junos OS CLI. Para mostrar las etiquetas de solicitud RPC XML de Junos para un comando de modo operativo, escriba el comando y canalíe al display xml rpc comando.
En el siguiente ejemplo, se muestran las etiquetas RPC del comando show route :
user@host> show route | display xml rpc
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/10.1I0/junos">
<rpc>
<get-route-information>
</get-route-information>
</rpc>
<cli>
<banner></banner>
</cli>
</rpc-reply>
A partir de Junos OS versión 20.3R1, se actualizaron los nombres de algunas etiquetas de solicitud RPC XML de Junos para garantizar la coherencia de la API de Junos XML. Los dispositivos que Junos OS seguirán aceptando los nombres de etiquetas de solicitud antiguos por compatibilidad con versiones anteriores, pero recomendamos que utilicen los nombres nuevos en adelante. Para comprobar la etiqueta de solicitud RPC XML de Junos para un comando de modo operativo en una versión Junos OS dada, consulte la herramienta Junos XML API Explorer - Operational Tags .
Asignación para opciones de comando con valores variables
Muchos CLI tienen opciones que identifican el objeto al que afecta el comando o que notifica, lo que diferencia al objeto de otros objetos del mismo tipo. En algunos casos, el CLI no precede al identificador con una palabra clave de formato fijo, pero la convención XML requiere que la API XML de Junos defina un elemento de etiqueta para cada opción. Para aprender los nombres de cada identificador (y cualquier otro elemento de etiqueta secundario) para un elemento de etiqueta de solicitud operativa, consulte la entrada del elemento de etiqueta en la DTD adecuada o en la Referencia de desarrollador operativo de la API XML de Junos, o emita la opción comando y comando en el CLI | display xml rpc y anexar la opción.
En el ejemplo siguiente se muestra los elementos de etiqueta XML de Junos para dos comandos CLI operativos que tienen opciones de formato variable. En el show interfaces comando, t3-5/1/0:0 es el nombre de la interfaz. En el show bgp neighbor comando, 10.168.1.222 es la dirección IP para el par BGP de interés.
Puede mostrar las etiquetas RPC XML de Junos para un comando y sus opciones en el CLI ejecutando la opción comando y comando y anexando | display xml rpc.
user@host> show interfaces t3-5/1/0:0 | display xml rpc
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos">
<rpc>
<get-interface-information>
<interface-name>t3-5/1/0:0</interface-name>
</get-interface-information>
</rpc>
<cli>
<banner></banner>
</cli>
</rpc-reply>
Asignación para opciones de comando de formato fijo
Algunos CLI incluyen opciones que tienen un formato fijo, brief como las cadenas y detail , en ellas, se especifica la cantidad de detalles que se deben incluir en el resultado. Por lo general, la API XML de Junos asigna esta opción a una etiqueta vacía cuyo nombre coincide con el nombre de la opción.
En el siguiente ejemplo, se muestra los elementos de etiqueta XML de Junos para el show isis adjacency comando, que tiene una opción de formato fijo denominada detail:
Para ver las etiquetas en el CLI:
user@host> show isis adjacency detail | display xml rpc
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos">
<rpc>
<get-isis-adjacency-information>
<detail/>
</get-isis-adjacency-information>
</rpc>
<cli>
<banner></banner>
</cli>
</rpc-reply>