Demander un schéma XML pour la hiérarchie de configuration à l’aide de NETCONF
Le schéma représente tous les éléments de configuration disponibles dans la version de Junos OS qui s’exécute sur un équipement. (Pour déterminer la version de Junos OS, émettre l’élément <get-software-information> de balise de demande opérationnelle, qui est documenté dans la référence du développeur opérationnel de l’API JUNOs XML.)
Les applications clientes peuvent utiliser le schéma pour valider la configuration sur un équipement ou simplement pour savoir quelles instructions de configuration sont disponibles dans la version de Junos OS exécutée sur l’équipement. Le schéma n’indique pas quels éléments sont réellement configurés, ni même qu’un élément peut être configuré sur ce type d’équipement (certaines instructions de configuration ne sont disponibles que sur certains types d’équipements). Pour demander l’ensemble des éléments actuellement configurés et leurs paramètres, envoyez l’élément de balise à la <get-config> place, comme décrit dans Demander des données de configuration à l’aide de NETCONF.
L’explication de la structure et des conventions de notation du langage XML Schema dépasse le champ d’application de ce document. Pour plus d’informations, voir XML Schema Part 0: Primer, disponible auprès du World Wide Web Consortium (W3C) à http://www.w3.org/TR/xmlschema-0/ . L’introduction fournit une introduction de base et liste les spécifications formelles où vous pouvez trouver des informations détaillées.
Pour plus d’informations, consultez les sections suivantes :
Demander un schéma XML pour la hiérarchie de configuration
Dans une session NETCONF avec un équipement exécutant Junos OS, pour demander une représentation en langage de schéma XML de l’ensemble de la hiérarchie de configuration, une application cliente émet l’élément de balise XML <get-xnm-information> Junos et ses <type> éléments de <namespace> balise enfant avec les valeurs indiquées dans un élément de <rpc> balise :
<rpc> <get-xnm-information> <type>xml-schema</type> <namespace>junos-configuration</namespace> </get-xnm-information> </rpc> ]]>]]>
Le serveur NETCONF enferme le schéma XML dans <rpc-reply> des éléments de <xsd:schema> balise :
<rpc-reply xmlns="URN" xmlns:junos="URL"> <xsd:schema> <!-- tag elements for the Junos XML schema --> </xsd:schema> </rpc-reply> ]]>]]>
Création du fichier junos.xsd
La plupart des éléments de balise définis dans le schéma retourné dans la balise appartiennent à l’espace <xsd:schema> de noms par défaut pour les éléments de configuration Junos OS. Cependant, au moins une balise, <junos:comment>, appartient à un autre espace de noms : http://xml.juniper.net/junos/Junos-version/junos. Par convention XML, un schéma ne décrit qu’un seul espace de noms. Les validateurs de schéma doivent donc importer des informations sur les espaces de noms supplémentaires avant de pouvoir traiter le schéma.
À partir de la version 6.4 de Junos OS, l’élément <xsd:import> de balise est joint à l’élément <xsd:schema> de balise et fait référence au fichier junos.xsd, qui contient les informations requises sur l’espace de junos noms. Par exemple, l’élément de balise suivant <xsd:import> spécifie le fichier pour Junos OS Version 20.4R1 (et apparaît sur deux lignes uniquement pour la lisibilité) :
<xsd:import schemaLocation="junos.xsd" \ namespace="http://xml.juniper.net/junos/20.4R1/junos"/>
Pour permettre au validateur de schéma d’interpréter l’élément <xsd:import> de balise, vous devez créer manuellement un fichier appelé junos.xsd dans le répertoire où vous placez le fichier .xsd qui contient le schéma de configuration complet de Junos OS. Incluez le texte suivant dans le fichier. N’utilisez pas de sauts de ligne dans la liste des attributs de la balise d’ouverture <xsd:schema> . Les sauts de ligne apparaissent dans l’exemple suivant pour la lisibilité uniquement. Pour la Junos-version variable, remplacez le numéro de version de Junos OS s’exécutant sur l’équipement (par exemple, 20.4R1 par la première version de Junos OS 20.4).
<?xml version="1.0" encoding="us-ascii"?>
<xsd:schema elementFormDefault="qualified" \
attributeFormDefault="unqualified" \
xmlns:xsd="http://www.w3.org/2001/XMLSchema" \
targetNamespace="http://xml.juniper.net/junos/Junos-version/junos">
<xsd:element name="comment" type="xsd:string"/>
</xsd:schema>
Les validateurs de schémas peuvent ne pas être en mesure de traiter le schéma s’ils ne peuvent pas localiser ou ouvrir le fichier junos.xsd .
Chaque fois que vous modifiez la version de Junos OS s’exécutant sur l’équipement, n’oubliez pas de mettre à jour la Junos-version variable du fichier junos.xsd pour qu’elle corresponde .
Exemple : demander un schéma XML
Les exemples suivants montrent comment demander le schéma de configuration Junos OS. Dans la réponse du serveur NETCONF, la première <xsd:element> instruction définit l’élément <undocumented> de balise Junos XML, qui peut être joint à la plupart des autres éléments de balise de conteneur définis dans le schéma (les éléments de balise de conteneur sont définis comme <xsd:complexType>).
Les attributs des balises d’ouverture de la réponse du serveur NETCONF apparaissent sur plusieurs lignes uniquement pour des raisons de lisibilité. Le serveur NETCONF n’insère pas de nouveaux caractères de ligne dans les balises ou les éléments de balise. En sortie réelle, la JUNOS-version variable est remplacée par une valeur telle que 20.4R1 pour la version initiale de Junos OS version 20.4.
Une autre <xsd:element> déclaration près du début du schéma définit l’élément de balise XML <configuration> Junos. Il contient l’instruction <xsd:element> qui définit l’élément <system> de balise, qui correspond au niveau hiérarchique [edit system] . Les déclarations correspondant aux autres niveaux hiérarchiques sont omises pour la brièveté.
