Controle un error o advertencia en una sesión de NETCONF

En una sesión NETCONF con un dispositivo que ejecuta Junos OS, una aplicación cliente envía RPCs al servidor NETCONF para solicitar información y administrar la configuración en el dispositivo. El servidor NETCONF envía una respuesta a cada solicitud de cliente. Si el servidor encuentra una condición de error, emite un <rpc-error> elemento que contiene elementos secundarios que describen el error.

<bad-element> identifica el comando o la instrucción de configuración que se procesaba cuando se produjo el error o la advertencia. Para una instrucción de configuración, el <error-path> elemento tag incluido en el <rpc-error> elemento tag especifica el nivel de jerarquía principal de la instrucción.

<error-message> describe el error o la advertencia en una cadena de texto en lenguaje natural.

<error-path> especifica la ruta al nivel de jerarquía de configuración de Junos OS en el que se produjo el error o la advertencia, en la forma del banner del modo de configuración de la CLI.

<error-severity> indica la gravedad del evento que causó que el servidor NETCONF devuelva el <rpc-error> elemento de etiqueta. Los dos valores posibles son error y warning.

Puede producirse un error mientras el servidor realiza cualquiera de las siguientes operaciones, y el servidor puede enviar una combinación diferente de elementos de etiqueta secundaria en cada caso:

• Procesamiento de una solicitud operativa enviada por una aplicación cliente

• Abrir, bloquear, cambiar, confirmar o cerrar una configuración según lo solicite una aplicación cliente

• Análisis de datos de configuración enviados por una aplicación cliente en un <edit-config> elemento de etiqueta

Las aplicaciones cliente deben estar preparadas para recibir y manejar un <rpc-error> elemento de etiqueta en cualquier momento. La información de cualquier elemento de etiqueta de respuesta ya recibida y relacionada con la solicitud actual podría estar incompleta. La aplicación cliente puede incluir lógica para decidir si se descarta o conserva la información.

Cuando el <error-severity> elemento tag tiene el valor error, la respuesta habitual es que la aplicación cliente descarte la información y termine. Cuando el <error-severity> elemento tag tiene el valor warning, lo que indica que el problema es menos grave, la respuesta habitual es que la aplicación cliente registre la advertencia o la pase al usuario y continúe analizando la respuesta del servidor.

Nota:

A partir de Junos OS versión 17.4R3, 18.2R2, 18.3R2 y 18.4R1, cuando configure la rfc-compliant instrucción en el [edit system services netconf] nivel de jerarquía para aplicar ciertos comportamientos por el servidor NETCONF, el servidor NETCONF no puede devolver una respuesta RPC que incluya un <rpc-error> elemento y un <ok/> elemento. Si la operación se realiza correctamente, pero la respuesta del servidor incluiría uno o más <rpc-error> elementos con un nivel de advertencia de gravedad además del <ok/> elemento, se omiten las advertencias.