Analyse de la réponse du serveur de protocole XML Junos
Dans une session de protocole Junos XML avec un équipement exécutant Junos OS, une application cliente envoie des RPC au serveur de protocole Junos XML pour demander des informations et gérer la configuration sur l’équipement. Le serveur de protocole XML Junos place sa réponse à chaque demande client dans une paire distincte de balises d’ouverture <rpc-reply> et de fermeture </rpc-reply> . Chaque réponse constitue un document XML bien formé.
<rpc-reply xmlns:junos=""http://xml.juniper.net/junos/release/junos"">
<!-- tag elements representing a response -->
</rpc-reply>
L’attribut xmlns:junos de la balise d’ouverture <rpc-reply> définit l’espace de noms par défaut pour les éléments de balise XML Junos inclus qui sont qualifiés par le junos: préfixe. La release variable dans l’URI représente la version de Junos OS qui s’exécute sur le périphérique serveur de protocole Junos XML, par exemple 20.4R1
L’élément <rpc-reply> tag se produit uniquement dans l’élément <junoscript> . Les applications clientes doivent inclure du code permettant d’analyser le flux d’éléments des balises de réponse provenant du serveur de protocole Junos XML, soit en les traitant au fur et à mesure de leur arrivée, soit en les stockant jusqu’à la fin de la réponse. Le serveur de protocole XML Junos renvoie trois classes de réponses :
Réponses opérationnelles
Les réponses opérationnelles sont des réponses aux demandes d’informations sur l’état d’une plate-forme de commutation, de routage ou de sécurité. Ils correspondent à la sortie des commandes opérationnelles CLI.
L’API XML Junos définit des éléments de balise de réponse pour tous les éléments de balise de requête opérationnelle définis. Par exemple, le serveur de protocole XML Junos renvoie les informations demandées par la balise dans une balise de réponse appelée , et renvoie les informations demandées par la <get-interface-information> balise dans une<chassis-inventory> balise de réponse appelée<chassis-inventory><interface-information> .<get-chassis-inventory> Les réponses opérationnelles peuvent également être renvoyées au format ASCII, qui est inclus dans un output élément, ou au format JSON. Pour plus d’informations sur la mise en forme des réponses opérationnelles, reportez-vous à Spécification du format de sortie des demandes d’informations opérationnelles dans une session Junos XML Protocol.
L’exemple de réponse suivant inclut des informations sur l’interface ge-2/3/0. L’espace de noms indiqué par l’attribut dans la balise d’ouverture <interface-information> contient des informations d’interface xmlns pour Junos OS version 20.4.
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/20.4R1/junos">
<interface-information xmlns="http://xml.juniper.net/junos/20.4R1/junos-interface">
<physical-interface>
<name>ge-2/3/0</name>
<!-- other data tag elements for the ge-2/3/0 interface -->
</physical-interface>
</interface-information>
</rpc-reply>
Pour plus d’informations sur l’attribut et le contenu des éléments de balise de réponse opérationnelle, consultez Demande d’informations opérationnelles à l’aide du protocole XML Junos.xmlns Pour obtenir un résumé des éléments des balises de réponse opérationnelle, reportez-vous au Guide de référence pour les développeurs opérationnels de l’API XML Junos.
Réponses aux informations de configuration
Les réponses aux informations de configuration sont des réponses aux demandes d’informations sur la configuration actuelle de l’appareil. L’API XML Junos définit un élément tag pour chaque instruction container et leaf dans la hiérarchie de configuration. Vous pouvez demander au serveur de renvoyer des données de configuration dans différents formats, notamment des éléments XML Junos, des ASCII formatés, des commandes Junos OS set ou JSON. Si vous ne spécifiez pas de format, la valeur par défaut est XML. Pour plus d’informations sur la mise en forme des réponses aux informations de configuration, voir Spécification du format de sortie des données de configuration dans une session Junos XML Protocol.
L’exemple de réponse suivant inclut les informations au niveau de la hiérarchie dans la [edit system login] hiérarchie de configuration. Par souci de concision, l’exemple ne montre qu’un seul utilisateur défini à ce niveau.
<rpc-reply xmlns:junos="URL">
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<!-- other data tag elements for the admin user -->
</user>
</login>
</system>
</configuration>
</rpc-reply>
Réponses aux changements de configuration
Les réponses aux modifications de configuration sont des réponses aux demandes qui modifient l’état ou le contenu de la configuration de l’appareil. Pour les opérations de validation, le serveur de protocole XML Junos renvoie la balise de <commit-results> réponse, qui contient un indicateur explicite de réussite ou d’échec.
<rpc-reply xmlns:junos="URL">
<commit-results>
<!-- tag elements for information about the commit -->
</commit-results>
</rpc-reply>
Pour les autres opérations, au lieu d’émettre un indicateur de réussite explicite, le serveur de protocole XML Junos indique la réussite en renvoyant une balise d’ouverture <rpc-reply> et une balise de fermeture </rpc-reply> sans éléments enfants.
<rpc-reply xmlns:junos="URL"> </rpc-reply>
Pour plus d’informations, voir Demande de modifications de configuration à l’aide du protocole XML Junos et Validation de la configuration candidate à l’aide du protocole XML Junos. Pour obtenir un résumé des éléments de balise de configuration disponibles, reportez-vous au Guide de référence pour les développeurs de configuration de l’API XML Junos.