Demander des données de configuration à l’aide du protocole Junos XML
Dans une session de protocole Junos XML avec un équipement exécutant Junos OS, pour demander des données de configuration pour un routage, une commutation ou une plate-forme de sécurité, une application client enferme l’élément <get-configuration> dans une <rpc> balise. En définissant des attributs facultatifs, l’application cliente peut spécifier la source et la mise en forme des informations de configuration renvoyées par le serveur de protocole Junos XML. En incluant les éléments de balise enfant appropriés en option, l’application peut demander l’intégralité de la configuration ou des parties spécifiques de la configuration. La syntaxe de base est la suivante :
<rpc>
<!-- If requesting the complete configuration -->
<get-configuration [optional attributes]/>
<!-- If requesting part of the configuration -->
<get-configuration [optional attributes]>
<configuration>
<!-- tag elements representing the data to return -->
</configuration>
</get-configuration>
</rpc>
Pour afficher les données de configuration dans une instance spécifique de la base de données de configuration éphémère, une application cliente doit ouvrir l’instance éphémère à l’aide de l’opération <open-configuration> avec les balises enfants appropriées avant d’exécuter la <get-configuration> demande.
À partir de la version 13.1 de Junos OS, dans le cadre d’une session de protocole Junos XML, un utilisateur de système logique peut utiliser l’opération de protocole <get-configuration> Junos XML pour demander des hiérarchies de configuration logiques spécifiques à l’aide de balises de configuration enfant et demander la configuration du système logique entier. Lorsque vous demandez la configuration du système logique dans son intégralité, la réponse RPC inclut la <configuration> balise racine. Avant la version 13.1 de Junos OS, la <configuration> balise racine était omise.
Le serveur de protocole XML Junos renferme sa réponse dans un élément de <rpc-reply> balise. Il inclut des attributs avec le junos: préfixe dans la balise d’ouverture <configuration> pour indiquer quand la configuration a été modifiée ou validée pour la dernière fois et l’utilisateur qui l’a validée (les attributs apparaissent sur plusieurs lignes dans l’instruction de syntaxe uniquement pour des raisons de lisibilité). Pour plus d’informations sur les attributs, voir Spécification de la source pour les demandes d’informations de configuration dans une session du protocole Junos XML.
<rpc-reply xmlns:junos="URL">
<!-- If the application requests Junos XML tag elements -->
<configuration junos:(changed | commit)-seconds="seconds" \
junos:(changed | commit)-localtime="YYYY-MM-DD hh:mm:ss TZ" \
[junos:commit-user="username"]>
<!-- Junos XML tag elements representing configuration elements -->
</configuration>
<!-- If the application requests formatted ASCII text -->
<configuration-text>
<!-- formatted ASCII configuration statements -->
</configuration-text>
<!-- If the application requests configuration mode set commands -->
<configuration-set>
<!-- configuration mode commands -->
</configuration-set>
<!-- If the application requests JSON format -->
<configuration-json>
<!-- JSON configuration data -->
</configuration-json>
</rpc-reply>
Si un élément de balise XML Junos est renvoyé dans un <undocumented> élément de balise, l’élément de configuration correspondant n’est pas documenté dans les guides de configuration Junos OS ni officiellement pris en charge par Juniper Networks. Le plus souvent, l’élément joint n’est utilisé que pour le débogage par le personnel d’assistance. Dans un plus petit nombre de cas, l’élément n’est plus pris en charge ou a été déplacé vers une autre zone de la hiérarchie de configuration, mais apparaît à l’emplacement actuel pour une rétrocompatibilité.
Lors de l’affichage des données opérationnelles ou de configuration qui contiennent des caractères en dehors du jeu de caractères ASCII 7 bits, Junos OS échappe et code ces caractères à l’aide de la référence décimale UTF-8 équivalente. Pour plus d’informations, voir Comprendre l’encodage des caractères sur les équipements exécutant Junos OS.
Pour obtenir des pages de référence pour les <configuration>éléments , <configuration-json>, <configuration-set>, <configuration-text>et <undocumented> balises, consultez la référence opérationnelle pour les développeurs de l’API Junos XML.
Si l’application client verrouille la configuration du candidat avant de faire des demandes, elle doit la déverrouiller après avoir fait ses demandes de lecture. Les autres utilisateurs et applications ne peuvent pas modifier la configuration tant qu’elle reste verrouillée. Pour plus d’informations, voir Verrouillage et déverrouillage de la configuration du candidat ou Création d’une copie privée à l’aide du protocole JUNOs XML.
Les rubriques suivantes décrivent comment une application cliente spécifie la source, le format et la quantité d’informations renvoyées par le serveur de protocole XML Junos :
Les applications peuvent également demander d’autres informations de configuration, notamment une représentation XML de la hiérarchie de configuration ou des informations sur les configurations précédemment validées. Pour plus d’informations, consultez les informations suivantes :
Récupération d’une configuration précédente (restauration) à l’aide du protocole XML Junos
Récupération de la configuration de sauvetage à l’aide du protocole XML Junos
Comparaison de deux configurations précédentes (restauration) à l’aide du protocole JUNOS XML
Demander un schéma XML pour la hiérarchie de configuration à l’aide du protocole XML Junos