Gérer une erreur ou un avertissement dans les sessions de protocole XML Junos
Dans une session de protocole XML Junos avec un équipement sous Junos OS, une application client envoie des RPC au serveur de protocoles XML Junos afin de demander des informations auprès de l’équipement et de gérer sa configuration. Le serveur de protocoles XML Junos envoie une réponse à chaque demande de client. Si le serveur rencontre une condition d’erreur, il émettra un élément contenant des éléments enfant qui <xnm:error> décrivent l’erreur.
La syntaxe de <xnm:error> l’élément est la suivante:
<xnm:error xmlns="http://xml.juniper.net/xnm/1.1/xnm" \
xmlns:xnm="http://xml.juniper.net/xnm/1.1/xnm">
<!-- tag elements describing the error -->
</xnm:error>
Les attributs sont les suivants:
xmlns—L’espace de noms XML pour les éléments de balises d’enfants qui n’ont pas de préfixe à leur nom (c’est-à-dire l’espace de noms par défaut des éléments de<xnm:error>balise XML Junos). La valeur est une URL du formulaire, où se trouve une chaîne telle quehttp://xml.juniper.net/xnm/version/xnmversion 1.1.xmlns:xnm—L’espace de noms XML pour l’élément de balise et les éléments de balise pour enfants qui ont le<xnm:error>xnm:préfixe au nom. La valeur est une URL du formulaire, où se trouve une chaîne telle quehttp://xml.juniper.net/xnm/version/xnmversion 1.1.
L’ensemble de balises enfant ci-jointes dans l’élément dépend du fonctionnement du serveur au moment de <xnm:error> l’erreur. Une erreur peut se produire alors que le serveur effectue l’une des opérations suivantes, et il peut envoyer une autre combinaison d’éléments de balise enfant dans chaque cas:
Traitement d’une demande opérationnelle envoyée par une application client
Ouverture, verrouillage, modification, engagement ou fermeture d’une configuration comme demandé par une application client
Analyse des données de configuration transmises par une application client dans un
<load-configuration>tag
Les applications client doivent être prêtes à recevoir et à gérer une <xnm:error> balise à tout moment. Les informations de tous les éléments de balise de réponse déjà reçus et relatifs à la demande actuelle peuvent être incomplètes. L’application client peut inclure une logique pour décider d’écarter ou de conserver les informations.
Si le serveur de protocoleSML Junos rencontre un problème moins grave, il peut émettre un <xnm:warning> tag element à la place. Dans ce cas, la réponse habituelle de l’application client consiste à enregistrer l’avertissement ou à le transmettre à l’utilisateur et à poursuivre l’traitement de la réponse du serveur.