Enviar solicitudes al servidor de protocolo XML de Junos
En una sesión de protocolo Junos XML con un dispositivo que ejecuta Junos OS, una aplicación cliente inicia una solicitud emitiendo la etiqueta de apertura <rpc> , uno o varios elementos de etiqueta que representan la solicitud en particular y la etiqueta de cierre </rpc> , en ese orden.
<rpc>
<!--tag elements representing a request-->
</rpc>
La aplicación encierra cada solicitud en su propio par separado de etiquetas de apertura <rpc> y cierre </rpc> . Cada solicitud debe constituir un documento XML bien formado mediante la inclusión de elementos de etiqueta que cumplan y se ordenan correctamente. El servidor de protocolo JUnos XML ignora los caracteres de línea, espacios u otros caracteres de espacio blanco nuevos que se produzcan entre elementos de etiqueta en la secuencia de etiquetas, pero conserva el espacio en blanco dentro de los elementos de etiqueta.
Opcionalmente, una aplicación cliente puede incluir uno o más atributos del formulario attribute-name="value" en la etiqueta de apertura <rpc> para cada solicitud. El servidor de protocolo XML de Junos hace eco de cada atributo, sin cambiar, en la etiqueta de apertura <rpc-reply> en la que encierra su respuesta.
Una aplicación cliente puede usar esta función para asociar solicitudes y respuestas mediante la inclusión de un atributo en cada etiqueta de solicitud de apertura <rpc> que asigna un identificador único. El servidor de protocolo JUnos XML hace eco del atributo en su etiqueta de apertura <rpc-reply> , lo que facilita la asignación de la respuesta a la solicitud iniciadora. La aplicación cliente puede definir nombres de atributos libremente, excepto como se describe en la siguiente nota.
El xmlns:junos nombre del atributo está reservado. El servidor de protocolo JUnos XML establece el atributo en un valor adecuado en la etiqueta de apertura <rpc-reply> , por lo que las aplicaciones cliente no deben emitirlo en la etiqueta de apertura <rpc> .
Aunque las solicitudes operativas y de configuración pertenecen conceptualmente a clases separadas, una sesión de protocolo Junos XML no tiene modos distintos que correspondan a los modos operativos y de configuración de CLI. Cada etiqueta de solicitud se adjunta dentro de su propia <rpc> etiqueta, por lo que una aplicación cliente puede alternar libremente solicitudes operativas y de configuración. Una aplicación cliente puede realizar tres clases de solicitudes:
Solicitudes operativas
Las solicitudes operativas son solicitudes de información sobre el estado de un dispositivo que ejecuta Junos OS. Las solicitudes operativas corresponden a los comandos del modo operativo de la CLI de Junos OS. La API XML de Junos define una etiqueta de solicitud para muchos comandos de CLI. Por ejemplo, la <get-interface-information> etiqueta corresponde al show interfaces comando y la <get-chassis-inventory> etiqueta solicita la misma información que el show chassis hardware comando.
La siguiente RPC solicita información detallada acerca de la interfaz ge-2/3/0:
<rpc>
<get-interface-information>
<interface-name>ge-2/3/0</interface-name>
<detail/>
</get-interface-information>
</rpc>
Para obtener más información acerca de las solicitudes operativas, consulte Solicitar información operativa mediante el protocolo XML de Junos. Para obtener más información acerca de los elementos de etiqueta de solicitud JUnos XML disponibles en la versión actual de Junos OS, consulte la Referencia del desarrollador operativo de la API Junos XML y el Explorador de API XML.
Solicitudes de información de configuración
Las solicitudes de información de configuración son solicitudes de información sobre la configuración candidata del dispositivo, una configuración privada, la configuración efímera o la configuración confirmada (la que se usa actualmente en la plataforma de enrutamiento, conmutación o seguridad). Las configuraciones candidatas y confirmadas difieren cuando hay cambios no comprometidos en la configuración del candidato.
El protocolo XML de Junos define la <get-configuration> operación para recuperar la información de configuración. La API XML de Junos define un elemento de etiqueta para cada instrucción de contenedor y leaf en la jerarquía de configuración.
En el siguiente ejemplo, se muestra cómo solicitar información sobre el [edit system login] nivel de jerarquía en la configuración del candidato:
<rpc>
<get-configuration>
<configuration>
<system>
<login/>
</system>
</configuration>
</get-configuration>
</rpc>
Para obtener más información acerca de las solicitudes de información de configuración, consulte Solicitar datos de configuración mediante el protocolo XML de Junos. Para obtener un resumen de los elementos de la etiqueta de configuración de Junos XML, consulte la Referencia para desarrolladores de configuración de la API junos XML y el Explorador de API XML.
Solicitudes de cambio de configuración
Las solicitudes de cambio de configuración son solicitudes para cambiar la configuración o para confirmar esos cambios para ponerlos en uso activo en el dispositivo que ejecuta Junos OS. El protocolo XML de Junos define la operación para cambiar la <load-configuration> información de configuración. La API XML de Junos define un elemento de etiqueta para cada instrucción de configuración de CLI descrita en las guías de configuración de Junos OS.
En el siguiente ejemplo, se muestra cómo crear una nueva cuenta de usuario de Junos OS llamada admin en el [edit system login] nivel de jerarquía en la configuración de candidato:
<rpc>
<load-configuration>
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<class>superuser</class>
</user>
</login>
</system>
</configuration>
</load-configuration>
</rpc>
Para obtener más información acerca de las solicitudes de cambio de configuración, consulte Solicitar cambios de configuración mediante el protocolo XML de Junos y Confirmar la configuración de candidato con el protocolo JUnos XML. Para obtener un resumen de los elementos de la etiqueta de configuración de Junos XML, consulte la Referencia para desarrolladores de configuración de la API junos XML y el Explorador de API XML.