Analyse de la réponse du serveur 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 joint sa réponse à chaque demande de 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="urn:ietf:params:xml:ns:netconf:base:1.0" \
xmlns:junos="http://xml.juniper.net/junos/release/junos" \
[echoed attributes]>
<!-- tag elements representing a response -->
</rpc-reply>
]]>]]>
L’attribut xmlns de la balise d’ouverture <rpc-reply> définit l’espace de noms pour les éléments de balise joints qui ne comportent pas le junos: préfixe dans leur nom et qui ne sont pas joints à une balise de conteneur pour enfant dont l’attribut xmlns a une valeur différente.
À partir de Junos OS Version 15.1, si vous configurez l’instruction rfc-compliant sur l’équipement, le serveur NETCONF déclare explicitement l’espace de noms NETCONF, lié au nc préfixe, et qualifie toutes les balises NETCONF dans ses réponses par le préfixe.
L’attribut xmlns:junos définit l’espace de noms par défaut pour les éléments de balise XML Junos joints qui sont qualifiés par le junos: préfixe. La release variable de l’URI représente la version de Junos OS qui s’exécute sur l’équipement serveur NETCONF, par exemple 20.4R1.
Les applications clientes doivent inclure du code pour l’analyse du flux d’éléments de balise de réponse provenant du serveur NETCONF, soit pour les traiter dès leur arrivée, soit pour les stocker jusqu’à ce que la réponse soit terminée. Le serveur NETCONF 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é. Elles correspondent aux sorties des commandes opérationnelles de l’interface CLI.
L’API XML Junos définit les é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 NETCONF renvoie les informations demandées par la <get-interface-information> balise dans un élément de balise de réponse appelé <interface-information>, et renvoie les informations demandées par la <get-chassis-inventory> balise dans une balise de réponse appelée <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écifier le format de sortie des requêtes d’informations opérationnelles dans une session NETCONF.
L’exemple suivant comprend des informations sur l’interface ge-2/3/0. L’espace de noms indiqué par l’attribut xmlns de la balise d’ouverture <interface-information> contient des informations d’interface pour Junos OS Version 20.4. Les balises d’ouverture apparaissent ici sur deux lignes pour une lisibilité uniquement :
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"\ 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 xmlns et le contenu des éléments de balise de réponse opérationnelle, consultez Demander des informations opérationnelles à l’aide de NETCONF. Pour un résumé des éléments de balise de réponse opérationnelle, reportez-vous à l’API XML Junos Operational Developer Reference.
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’équipement. L’API XML Junos définit un élément de balise pour chaque instruction de conteneur et de branche dans la hiérarchie de configuration.
L’exemple de réponse suivant inclut les informations au [edit system login] niveau hiérarchique de la hiérarchie de configuration. Pour plus de brièveté, l’échantillon montre qu’un seul utilisateur est défini à ce niveau. La balise d’ouverture <rpc-reply> apparaît sur deux lignes pour une lisibilité uniquement. Pour plus d’informations sur les attributs de la balise d’ouverture <configuration> , reportez-vous à la rubrique Spécifier la source pour les demandes d’informations de configuration à l’aide de NETCONF.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"\
xmlns:junos="http://xml.juniper.net/junos/20.4R1/junos">
<data>
<configuration attributes>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<!-- other data tag elements for the admin user -->
</user>
</login>
</system>
</configuration>
</data>
</rpc-reply>
]]>]]>
Réponses aux changements de configuration
Les réponses aux changements de configuration sont des réponses aux demandes qui modifient l’état ou le contenu de la configuration de l’équipement. Le serveur NETCONF indique que la requête a bien été exécutée en renvoyant la <ok/> balise au sein de l’élément de <rpc-reply> balise :
<rpc-reply xmlns="URN" xmlns:junos="URL">
<ok/>
</rpc-reply>
]]>]]>
En cas d’échec de l’opération, l’élément <rpc-reply> de balise encadre un <rpc-error> élément qui décrit la cause de la défaillance. Pour plus d’informations sur le traitement des erreurs, consultez Gérer une erreur ou un avertissement dans une session NETCONF.
rfc-compliant sur l’équipement, le serveur NETCONF déclare explicitement l’espace de noms NETCONF, lié au
nc préfixe, et qualifie toutes les balises NETCONF dans ses réponses par le préfixe.