Mapper les commandes et la sortie de commande Junos OS aux éléments de balise XML Junos

L’API XML Junos est une représentation XML des instructions de configuration junos OS et des commandes du mode opérationnel. Il définit un équivalent XML pour toutes les déclarations de la hiérarchie de configuration Junos OS et pour la plupart des commandes que vous émettez en mode opérationnel CLI. Chaque commande de mode opérationnel avec un équivalent XML Junos est mappée à un élément de balise de demande et, si nécessaire, à un élément de balise de réponse.

Les éléments de balise de demande sont utilisés dans les appels de procédure à distance (RPC) dans les sessions de protocole NETCONF et Junos XML pour demander des informations à un équipement exécutant Junos OS. Le serveur renvoie la réponse à l’aide des éléments de balise XML Junos inclus dans l’élément de balise de réponse. Par exemple, la show interfaces commande est mappée à la balise de <get-interface-information> demande et le serveur renvoie la balise de <interface-information> réponse.

Les sections suivantes expliquent comment mapper les commandes, les options de commande et la sortie de commande aux éléments de balise XML Junos.

Mappage de la sortie de commande aux éléments XML Junos

Sur l’interface de ligne de commande (CLI) Junos OS, pour afficher la sortie de commande en tant qu’éléments de balise XML Junos au lieu du texte ASCII formaté par défaut, ajoutez l’option | display xml après la commande. Les éléments de balise qui décrivent la configuration de Junos OS ou les données opérationnelles appartiennent à l’API XML Junos, qui définit le contenu Junos OS pouvant être récupéré et manipulé par les opérations des protocoles de gestion NETCONF et Junos XML.

L’exemple suivant montre la sortie de la show chassis hardware commande émise sur un routeur M20 qui exécute Junos OS version 9.3 (la balise d’ouverture <chassis-inventory> apparaît sur deux lignes uniquement pour la lisibilité). Cette réponse est identique à la réponse du serveur pour la <get-chassis-inventory> demande RPC.

Mappage des commandes aux éléments de balise de demande Junos XML

Vous trouverez des informations sur les commandes du mode opérationnel Junos OS et leurs balises de requête RPC Junos XML équivalentes dans l’outil Junos XML API Explorer - Operational Tags et dans la CLI Junos OS. Vous pouvez utiliser l’outil pour vérifier une commande, mapper la commande à ses balises de requête et enfants Junos XML RPC équivalentes, et afficher la balise de réponse attendue pour diverses versions de Junos OS.

Vous pouvez également afficher les éléments de balise de requête Junos XML pour n’importe quelle commande de mode opérationnel ayant un équivalent JUNOs XML sur l’interface CLI Junos OS. Pour afficher les balises de demande RPC Junos XML pour une commande du mode opérationnel, saisissez la commande et dirigez-la vers la display xml rpc commande.

L’exemple suivant affiche les balises RPC de la show route commande :

Note:

À partir de la version 20.3R1 de Junos OS, les noms de certaines balises de requête RPC Junos XML ont été mis à jour pour assurer la cohérence de l’API XML Junos. Les équipements exécutant Junos OS accepteront toujours les anciens noms des balises de demande pour une rétrocompatibilité, mais nous vous recommandons d’utiliser les nouveaux noms à l’avenir. Pour vérifier la balise de demande RPC Junos XML pour une commande en mode opérationnel dans une version Junos OS donnée, consultez l’outil Junos XML API Explorer - Balises opérationnelles .

Mappage des options de commande avec des valeurs variables

De nombreuses commandes CLI disposent d’options qui identifient l’objet qu’elle affecte ou sur lequel elle rapporte, ce qui le distingue des autres objets du même type. Dans certains cas, la CLI ne précède pas l’identifiant par un mot-clé de forme fixe, mais la convention XML exige que l’API XML Junos définisse un élément de balise pour chaque option. Pour connaître le nom de chaque identifiant (et tout autre élément de balise enfant) d’un élément de balise de demande opérationnelle, consultez l’entrée de l’élément de balise dans le DTD approprié ou dans la référence opérationnelle du développeur junos XML API, ou envoyez l’option de commande et de commande dans l’interface cli et ajoutez l’option | display xml rpc .

L’exemple suivant montre les éléments de balise Junos XML pour deux commandes opérationnelles CLI qui ont des options de forme variable. Dans la show interfaces commande, t3-5/1/0:0 est le nom de l’interface. Dans la show bgp neighbor commande, 10.168.1.222 est l’adresse IP du pair d’intérêt BGP.

Vous pouvez afficher les balises RPC Junos XML pour une commande et ses options dans la CLI en exécutant l’option de commande et de commande et en ajoutant | display xml rpc.

Mappage des options de commande de formulaire fixe

Certaines commandes CLI comprennent des options qui ont une forme fixe, telles que les brief chaînes et detail , qui spécifient la quantité de détails à inclure dans la sortie. L’API XML Junos mappe généralement une telle option à une balise vide dont le nom correspond au nom de l’option.

L’exemple suivant illustre les éléments de balise Junos XML pour la show isis adjacency commande, qui dispose d’une option de forme fixe appelée detail:

Pour afficher les balises dans la CLI :

Tableau de l’historique des versions

Libération

Description

20.3R1

À partir de la version 20.3R1 de Junos OS, les noms de certaines balises de requête RPC Junos XML ont été mis à jour pour assurer la cohérence de l’API XML Junos.