Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Gérer une erreur ou un avertissement dans une session NETCONF

Dans une session NETCONF avec un équipement exécutant Junos OS, une application cliente envoie des RPC au serveur NETCONF pour demander des informations et gérer la configuration sur l’équipement. Le serveur NETCONF envoie une réponse à chaque demande du client. Si le serveur rencontre une condition d’erreur, il émet un <rpc-error> élément contenant des éléments enfants qui décrivent l’erreur.

<bad-element> identifie la commande ou l’instruction de configuration qui était traitée lorsque l’erreur ou l’avertissement s’est produit. Pour une instruction de configuration, l’élément <error-path> de balise inclus dans l’élément <rpc-error> de balise spécifie le niveau hiérarchique parent de l’instruction.

<error-message> décrit l’erreur ou l’avertissement dans une chaîne de texte en langage naturel.

<error-path> spécifie le chemin d’accès au niveau de la hiérarchie de configuration Junos OS auquel l’erreur ou l’avertissement s’est produit, sous la forme de la bannière du mode de configuration CLI.

<error-severity> indique la gravité de l’événement qui a conduit le serveur NETCONF à renvoyer l’élément de <rpc-error> balise. Les deux valeurs possibles sont error et warning.

Une erreur peut se produire pendant que le serveur effectue l’une des opérations suivantes, et le serveur peut envoyer une combinaison différente d’éléments de balise enfant dans chaque cas :

  • Traitement d’une demande opérationnelle soumise par une demande cliente

  • Ouverture, verrouillage, modification, validation ou fermeture d’une configuration comme demandé par une application cliente

  • Analyse des données de configuration transmises par une application cliente dans un élément de <edit-config> balise

Les applications clientes doivent être préparées pour recevoir et gérer un élément de <rpc-error> balise à tout moment. Les informations contenues dans les éléments de balise de réponse déjà reçus et liés à la demande actuelle peuvent être incomplètes. L’application cliente peut inclure une logique permettant de décider de supprimer ou de conserver les informations.

Lorsque l’élément <error-severity> de balise a la valeur error, la réponse habituelle est que l’application cliente supprime les informations et termine. Lorsque l’élément <error-severity> de balise a la valeur warning, indiquant que le problème est moins grave, la réponse habituelle est que l’application cliente enregistre l’avertissement ou le transmet à l’utilisateur et poursuit l’analyse de la réponse du serveur.

Note:

À partir des versions 17.4R3, 18.2R2, 18.3R2 et 18.4R1 de Junos OS, lorsque vous configurez l’instruction au niveau de la rfc-compliant [edit system services netconf] hiérarchie pour appliquer certains comportements du serveur NETCONF, le serveur NETCONF ne peut pas renvoyer une réponse RPC comprenant à la fois un <rpc-error> élément et un <ok/> élément. Si l’opération est réussie, mais que la réponse du serveur comprend un ou plusieurs <rpc-error> éléments avec un niveau d’avertissement de gravité en plus de l’élément <ok/> , les avertissements sont alors omis.