Envoyer des demandes au serveur NETCONF
Pour lancer une demande au serveur NETCONF, une application client émettra la balise ouvrante, suivie d’un ou plusieurs éléments de balise représentant la requête spécifique, et la balise de clôture, dans cet <rpc> </rpc> ordre:
<rpc>
<!-- tag elements representing a request -->
</rpc>
]]>]]>
L’application joint chaque demande dans sa propre paire séparée de balises ouvrantes <rpc> et </rpc> fermant. Chaque demande doit constituer un document XML bien formé comprenant uniquement des éléments de balise conformes et commandés correctement. Le serveur NETCONF 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 du formulaire dans la balise d’ouverture attribute-name="value" <rpc> de chaque demande. Le serveur NETCONF fait écho à chaque attribut, sans changement, sur la balise d’ouverture dans laquelle il <rpc-reply> joint sa réponse.
Une application client peut utiliser cette fonctionnalité pour associer les requêtes et les réponses en incluant un attribut dans chaque balise de demande ouvrante qui affecte un <rpc> identifiant unique. Le serveur NETCONF fait écho à l’attribut dans sa balise d’ouverture, ce qui a facilité la mapuration de la réponse <rpc-reply> à la demande d’origine. La spécification NETCONF spécifie le message-id nom de cet attribut.
Même si les demandes opérationnelles et de configuration appartiennent conceptuellement à des classes distinctes, les sessions NETCONF ne sont pas distinctes et ne se distinguent pas des modes correspondant CLI modes opérationnels et de configuration. Chaque élément de balise de demande est inclus dans sa propre balise, de sorte qu’une application client peut alternativer librement les demandes opérationnelles <rpc> 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 un élément de balise de demande pour de CLI commandes. Par exemple, l’élément de balise correspond à la commande, alors que le tag demande les mêmes informations <get-interface-information> show interfaces que la <get-chassis-inventory> 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 opérationnelles, consultez la requête d’informations opérationnelles à l’aide de NETCONF. Pour plus d’informations sur les éléments de balise de demande XML Junos disponibles dans la version actuelle de Junos OS, consultez l’API XML De référence pour junos et l’explorer API 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 commutation, de routage 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 NETCONF définit le fonctionnement de la récupération des informations de <get-config> 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 du niveau [edit system login] hiérarchique de la configuration du candidat:
<rpc>
<get-config>
<source>
<candidate/>
</source>
<filter type="subtree">
<configuration>
<system>
<login/>
</system>
</configuration>
</filter>
</get-config>
</rpc>
]]>]]>
Pour plus d’informations sur les demandes d’informations de configuration, consultez la requête Request Configuration Data Using NETCONF. Pour un récapitulatif des éléments de balise de configuration disponibles, consultez les références de développeur de configuration API XML de Junos et XML API Explorer.
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 NETCONF définit les opérations et l’évolution <edit-config> <copy-config> 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 configuration réseau.
L’exemple suivant montre comment créer un nouveau compte utilisateur Junos OS appelé au niveau hiérarchique admin dans la configuration du [edit system login] candidat:
<rpc>
<edit-config>
<target>
<candidate/>
</target>
<config>
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<class>superuser</class>
</user>
</login>
<login/>
</system>
</configuration>
</config>
</edit-config>
</rpc>
]]>]]>
Pour plus d’informations sur les demandes de modification de configuration, consultez la version modifiée à l’aide de NETCONF. 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.