Enviar solicitudes al servidor NETCONF
Para iniciar una solicitud al servidor NETCONF, una aplicación cliente emite la etiqueta de apertura <rpc> , seguida de uno o más 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 ordenan correctamente. El servidor NETCONF ignora cualquier nuevo carácter de línea, espacios u otros caracteres de espacio blanco 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 NETCONF replica cada atributo, sin cambiar, en la etiqueta de apertura <rpc-reply> en la que encierra su respuesta.
Una aplicación cliente puede usar esta característica 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 NETCONF hace eco del atributo en su etiqueta de apertura <rpc-reply> , lo que facilita la asignación de la respuesta a la solicitud de inicio. La especificación NETCONF especifica el nombre message-id de este atributo.
Aunque las solicitudes operativas y de configuración pertenecen conceptualmente a clases independientes, una sesión NETCONF no tiene modos distintos que correspondan a los modos operativos y de configuración de CLI. Cada elemento de etiqueta de solicitud está incluido en 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 un elemento de etiqueta de solicitud para muchos comandos de CLI. Por ejemplo, el <get-interface-information> tag element corresponde al show interfaces comando y el <get-chassis-inventory> tag element 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 NETCONF. 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 conmutación, enrutamiento o seguridad). Las configuraciones candidatas y confirmadas difieren cuando hay cambios no comprometidos en la configuración de candidato.
El protocolo NETCONF define la <get-config> 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 del [edit system login] nivel de jerarquía de la configuración del candidato:
<rpc>
<get-config>
<source>
<candidate/>
</source>
<filter type="subtree">
<configuration>
<system>
<login/>
</system>
</configuration>
</filter>
</get-config>
</rpc>
]]>]]>
Para obtener más información acerca de las solicitudes de información de configuración, consulte Solicitar datos de configuración mediante NETCONF. Para obtener un resumen de los elementos de etiqueta de configuración disponibles, consulte la Referencia para desarrolladores de configuración de la API de 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 NETCONF define las operaciones y <copy-config> las operaciones para cambiar la <edit-config> 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>
<edit-config>
<target>
<candidate/>
</target>
<config>
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<class>superuser</class>
</user>
</login>
<login/>
</system>
</configuration>
</config>
</edit-config>
</rpc>
]]>]]>
Para obtener más información acerca de las solicitudes de cambio de configuración, consulte Editar la configuración mediante NETCONF. 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.