Envoyer des demandes au serveur de protocole XML Junos
Dans une session de protocole XML Junos avec un équipement exécutant Junos OS, une application <rpc> client en émet une demande en émettre la balise ouvrante, </rpc> un ou plusieurs éléments de balise représentant la demande spécifique et la balise de clôture dans cet ordre.
<rpc>
<!--tag elements representing a request-->
</rpc>
L’application joint chaque demande dans sa propre paire séparée de <rpc> balises ouvrantes et fermant </rpc> . Chaque demande doit constituer un document XML bien formé comprenant uniquement des éléments de balise conformes et commandés correctement. Le serveur de protocole XML Junos ignore les nouveaux caractères, espaces ou autres caractères d’espace blanc qui se produisent entre les éléments du tag du flux de balises, mais il préserve l’espace blanc au sein des éléments de balise.
Une application client peut, si vous le pouvez, inclure un ou plusieurs attributs attribute-name="value" <rpc> du formulaire dans la balise d’ouverture de chaque demande. Le serveur de protocoleSML Junos fait écho à chaque attribut, sans changement, <rpc-reply> dans la balise d’ouverture dans laquelle il joint sa réponse.
Une application client peut utiliser cette fonctionnalité <rpc> pour associer les requêtes et réponses en incluant un attribut dans chaque balise de demande ouvrante qui attribue un identifiant unique. Le serveur de protocoleSML <rpc-reply> Junos fait écho à l’attribut dans sa balise d’ouverture, ce qui permet d’identifier facilement la réponse à la demande à l’origine. L’application client peut définir librement les noms d’attributs, sauf dans la note décrite dans la note suivante.
Le xmlns:junos nom de l’attribut est réservé. Le serveur de protocoleS XML <rpc-reply> Junos définit l’attribut comme une valeur appropriée sur la balise ouvrante, de sorte que les applications client ne doivent pas l’émettre sur la balise d’ouverture <rpc> .
Même si les demandes opérationnelles et de configuration appartiennent conceptuellement à des classes distinctes, les sessions de protocole XML de Junos ne sont pas distinctes et ne sont pas distinctes et correspondent CLI modes opérationnels et de configuration. Chaque étiquette de demande est jointe au sein de sa propre <rpc> balise, de sorte qu’une application client peut alternativer librement les demandes opérationnelles et de configuration. Une application client peut répondre à trois classes de requêtes:
Demandes opérationnelles
Les requêtes opérationnelles sont des demandes d’informations sur l’état d’un équipement s’exécutant Junos OS. Les requêtes opérationnelles correspondent Junos OS CLI commandes du mode opérationnel. L’API XML Junos définit une balise de requête pour de nombreuses CLI données. Par exemple, la balise <get-interface-information> correspond à show interfaces la commande et la <get-chassis-inventory> balise demande les mêmes informations que la show chassis hardware commande.
Les requêtes RPC suivantes détaillent l’interface ge-2/3/0:
<rpc>
<get-interface-information>
<interface-name>ge-2/3/0</interface-name>
<detail/>
</get-interface-information>
</rpc>
Pour plus d’informations sur les demandes d’exploitation, consultez la requête d’informations opérationnelles à l’aide du protocole XML Junos. Pour plus d’informations sur les éléments de balise de demande XML Junos disponibles dans la version Junos OS actuelle, consultez l’API XML De référence pour les développeurs opérationnels Junos et l’API Explorer XML.
Demandes d’informations de configuration
Les demandes d’informations de configuration sont des demandes d’informations concernant la configuration de candidature de l’équipement, une configuration privée, la configuration éphémère ou la configuration dédiée (celle actuellement en cours d’utilisation sur la plate-forme de routage, de commutation ou de sécurité). Le candidat et les configurations engagées s’ivergent lorsqu’aucune modification de la configuration du candidat n’est non engagée.
Le protocole XML Junos définit <get-configuration> le fonctionnement de la récupération des informations de configuration. L’API XML Junos définit un élément de balise pour chaque énoncé de conteneur et de feuille dans la hiérarchie de configuration.
L’exemple suivant indique comment demander des informations [edit system login] sur le niveau hiérarchique de la configuration du candidat:
<rpc>
<get-configuration>
<configuration>
<system>
<login/>
</system>
</configuration>
</get-configuration>
</rpc>
Pour plus d’informations sur les demandes d’informations de configuration, consultez la requête Requesting Configuration Data Using the Junos XML Protocol. Pour un récapitulatif des éléments de balise de configuration XML de Junos, consultez la référence pour le développeur de configuration API XML Junos et l’API Explorer XML.
Demandes de modification de configuration
Les requêtes de modification de configuration sont des demandes de modification de la configuration ou de validation de ces modifications pour les mettre en service sur l’équipement qui s’exécute sur Junos OS. Le protocole XML Junos définit le fonctionnement de <load-configuration> la modification des informations de configuration. L’API XML Junos définit un élément de balise pour chaque CLI de configuration décrite dans les guides Junos OS de configuration réseau.
L’exemple suivant montre comment créer un nouveau Junos OS utilisateur admin [edit system login] appelé au niveau hiérarchique dans la configuration du candidat:
<rpc>
<load-configuration>
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<class>superuser</class>
</user>
</login>
</system>
</configuration>
</load-configuration>
</rpc>
Pour plus d’informations sur les demandes de modification de configuration, consultez la requête de modification de configuration à l’aide du protocole XML Junos et la validation de la configuration du candidat à l’aide du protocole XML Junos. Pour un récapitulatif des éléments de balise de configuration XML de Junos, consultez la référence pour le développeur de configuration API XML Junos et l’API Explorer XML.