Demander des modifications de configuration à l’aide du protocole JUNOS XML
Dans une session de protocole Junos XML avec un équipement exécutant Junos OS, vous pouvez utiliser les opérations de protocole JUNOS XML avec Junos XML, les instructions de configuration, set les commandes ou les données JSON pour modifier la configuration sur une plate-forme de routage, de commutation ou de sécurité. Le fonctionnement du protocole <load-configuration> JUNOs XML et ses attributs offrent des fonctionnalités analogues aux commandes du mode de configuration dans l’interface cli de Junos OS. Les éléments de balise Junos XML décrits ici correspondent aux instructions de configuration, qui sont décrites dans les guides de configuration Junos OS.
Pour modifier la configuration d’un équipement exécutant Junos OS, l’application cliente effectue les procédures décrites dans les sections indiquées :
Établit une connexion au serveur de protocole XML Junos sur la plate-forme de routage, de commutation ou de sécurité, comme décrit dans Connexion au serveur de protocole XML Junos.
Démarre une session de protocole XML Junos, comme décrit dans la section Démarrage des sessions de protocole XML Junos.
Verrouille éventuellement la configuration du candidat, crée une copie privée de la configuration du candidat ou ouvre une instance de la base de données de configuration éphémère.
Le verrouillage de la configuration empêche d’autres utilisateurs ou applications de la modifier en même temps. La création d’une copie privée permet à l’application d’apporter des modifications sans affecter la configuration du candidat jusqu’à ce que la copie soit validé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.
Pour plus d’informations sur la base de données de configuration éphémère, voir Comprendre la base de données de configuration éphémère et Activer et configurer des instances de la base de données de configuration éphémère.
Enferme l’élément
<load-configuration>de balise dans un<rpc>élément de balise. En incluant divers attributs dans la<load-configuration>balise, l’application peut fournir les données de configuration soit dans un fichier soit sous la forme d’un flux de balises directement chargé, et sous forme d’éléments de balise XML Junos, de texte ASCII formaté, de données au format JSON ou de commandes en modesetde configuration Junos OS. L’application cliente peut spécifier que les données de configuration remplacent complètement la configuration de candidature existante, ou l’application peut spécifier la manière dont le serveur de protocole Junos XML charge les données dans la configuration de candidature existante, la copie privée ou l’instance ouverte de la base de données de configuration éphémère. La syntaxe de base est la suivante :<rpc> <!-- If providing configuration data in a file --> <load-configuration url="file" [optional attributes] /> <!-- If providing configuration data in a data stream --> <load-configuration [optional attributes] > <!-- configuration data --> </load-configuration> </rpc>Accepte le flux de balises émis par le serveur de protocole XML Junos en réponse à chaque requête et extrait son contenu, comme décrit dans l’analyse de la réponse du serveur du protocole Junos XML.
Le serveur de protocole JUNOS XML confirme qu’il a incorporé les données de configuration en renvoyant l’élément
<load-configuration-results>de balise et<load-success/>la balise dans l’élément<rpc-reply>de balise :<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-success/> </load-configuration-results> </rpc-reply>Si l’opération de charge échoue, l’élément
<load-configuration-results>de balise enferme l’élément<load-error-count>de balise, ce qui indique le nombre d’erreurs qui se sont produites. Dans ce cas, l’application ou l’administrateur doit éliminer les erreurs avant de commettre la configuration.<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-error-count>count</load-error-count> </load-configuration-results> </rpc-reply>(Facultatif) Vérifie l’exactitude syntaxique de la configuration du candidat ou d’une copie privée avant de tenter de la valider, comme décrit dans Vérification de la syntaxe de configuration à l’aide du protocole Junos XML.
Valide les modifications apportées à la configuration du candidat ou à la copie privée, comme décrit dans Validation de la configuration du candidat à l’aide du protocole Junos XML, ou valide les modifications apportées à une instance ouverte de la base de données de configuration éphémère, comme décrit dans Validation et synchronisation des données de configuration éphémères à l’aide du protocole NETCONF ou Junos XML.
Déverrouille la configuration du candidat si elle est verrouillée, ou ferme une copie privée de la configuration ou une instance ouverte de la base de données de configuration éphémère.
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.
Termine la session du protocole XML Junos et ferme la connexion à l’équipement, comme décrit dans Mettre fin à une session du protocole XML Junos et fermer la connexion.