Lide com um erro ou aviso em uma sessão netconf
Em uma sessão netconf com um dispositivo executando o Junos OS, um aplicativo cliente envia RPCs para o servidor NETCONF para solicitar informações e gerenciar a configuração no dispositivo. O servidor NETCONF envia uma resposta a cada solicitação do cliente. Se o servidor encontrar uma condição de erro, ele emite um <rpc-error>
elemento contendo elementos infantis que descrevem o erro.
<rpc-reply xmlns="URN" xmlns:junos="URL"> <rpc-error> <error-severity>error-severity</error-severity> <error-path>error-path</error-path> <error-message>error-message</error-message> <error-info> <bad-element>command-or-statement</bad-element> </error-info> <rpc-error> </rpc-reply> ]]>]]>
<bad-element>
identifica a declaração de comando ou configuração que estava sendo processada quando ocorreu o erro ou o aviso. Para uma declaração de configuração, o <error-path>
elemento de tag incluído no <rpc-error>
elemento tag especifica o nível de hierarquia dos pais da declaração.
<error-message>
descreve o erro ou o aviso em uma corda de texto de linguagem natural.
<error-path>
especifica o caminho para o nível de hierarquia de configuração do Junos OS no qual ocorreu o erro ou o aviso, na forma do banner do modo de configuração CLI.
<error-severity>
indica a gravidade do evento que fez com que o servidor NETCONF devolvesse o <rpc-error>
elemento de tag. Os dois valores possíveis são error
e warning
.
Um erro pode ocorrer enquanto o servidor está realizando qualquer uma das seguintes operações, e o servidor pode enviar uma combinação diferente de elementos de tag infantil em cada caso:
Processamento de uma solicitação operacional enviada por um aplicativo do cliente
Abrir, bloquear, alterar, comprometer ou fechar uma configuração conforme solicitado por um aplicativo do cliente
Analisar dados de configuração enviados por um aplicativo do cliente em um
<edit-config>
elemento de tag
Os aplicativos do cliente devem estar preparados para receber e lidar com um <rpc-error>
elemento de tag a qualquer momento. As informações em quaisquer elementos de tag de resposta já recebidos e relacionados à solicitação atual podem estar incompletas. O aplicativo do cliente pode incluir lógica para decidir se descarta ou retém as informações.
Quando o <error-severity>
elemento tag tem o valor error
, a resposta habitual é que o aplicativo do cliente descarte as informações e encerre. Quando o <error-severity>
elemento da tag tem o valor warning
, indicando que o problema é menos grave, a resposta habitual é que o aplicativo do cliente registre o aviso ou o passe para o usuário e continue analisando a resposta do servidor.
Começando pelo Junos OS Release 17.4R3, 18.2R2, 18.3R2 e 18.4R1, quando você configura a rfc-compliant
declaração no [edit system services netconf]
nível de hierarquia para aplicar certos comportamentos pelo servidor NETCONF, o servidor NETCONF não pode retornar uma resposta de RPC que inclua um <rpc-error>
elemento e um <ok/>
elemento. Se a operação for bem sucedida, mas a resposta do servidor incluirá um ou mais <rpc-error>
elementos com um nível de alerta de gravidade, além do <ok/>
elemento, então os avisos são omitidos.