Sous-ensembles de demandes d’objets de configuration à l’aide d’expressions régulières

Dans une session de protocole Junos XML avec un équipement exécutant Junos OS, pour demander des informations uniquement sur les instances d’un type d’objet de configuration qui ont un ensemble spécifié de caractères dans leurs noms d’identifiants, une application cliente inclut l’attribut matching avec une expression régulière qui correspond au nom de l’identifiant. Par exemple, l’application peut demander des informations uniquement sur les interfaces SONET/SDH au niveau de la [edit interfaces] hiérarchie en spécifiant les caractères au début de l’expression régulière.

L’utilisation de l’attribut matching permet à l’application de représenter les objets à renvoyer sous une forme similaire à la représentation du langage de chemin XML (XPath), décrite dans XML Path Language (XPath) version 1.0, disponible auprès du World Wide Web Consortium (W3C) à http://www.w3.org/TR/xpath . Dans une représentation XPath, un objet et ses niveaux parent sont une série ordonnée de noms d’éléments de balise séparés par des barres de transfert. Les crochets d’angle autour des noms d’éléments de balise sont omis, et la balise d’ouverture est utilisée pour représenter l’ensemble de l’élément de balise. Par exemple, le XPath suivant :

équivaut à la représentation balisée suivante :

L’application inclut l’attribut matching dans la balise vide qui représente un niveau parent pour le type d’objet. Comme pour toutes les demandes d’informations de configuration, le client émet un <get-configuration> élément de balise qui renferme les éléments de balise représentant tous les niveaux de la hiérarchie de configuration, de la racine (représentée par l’élément <configuration> de balise) jusqu’au niveau auquel l’attribut matching est inclus. L’ensemble de la demande est entouré d’un élément de <rpc> balise :

Dans la valeur de l’attribut matching , chaque niveau de la représentation de type XPath peut être soit un nom de niveau complet, soit une expression régulière qui correspond au nom d’identifiant d’une ou plusieurs instances d’un type d’objet :

L’expression régulière utilise la notation définie dans la norme POSIX 1003.2 pour les expressions régulières d’UNIX étendues (modernes). L’explication de la syntaxe d’expression régulière dépasse le champ d’application de ce document, mais le tableau 1 spécifie le ou les caractères correspondants à certains opérateurs d’expression régulière pouvant être utilisés dans l’expression. Dans les descriptions, le terme désigne soit un seul caractère alphanumérique, soit un ensemble de caractères entre crochets, parenthèses ou accolades.

Note:

L’attribut matching n’est pas sensible à la casse.

 

Tableau 1 : opérateurs d’expression régulière pour l’attribut correspondant

Opérateur	Matchs
. (point)	Une instance de n’importe quel caractère à l’exception de l’espace.
* (astérisque)	Zéro ou plus instances de la période immédiatement précédente.
+ (signe plus)	Une ou plusieurs instances de la période immédiatement précédente.
? (point d’interrogation)	Zéro ou une instance du terme immédiatement précédent.
| (pipe)	L’un des termes qui apparaissent de chaque côté de l’opérateur de tuyau.
^ (caret)	Le début d’une ligne, lorsque le caret apparaît en dehors des crochets. Une instance de tout caractère qui ne le suit pas entre crochets, lorsque le caret est le premier caractère à l’intérieur des crochets.
$ (signe en dollars)	La fin d’une ligne.
[ ] (crochets appairés)	Une instance de l’un des caractères alphanumériques joints. Pour indiquer une plage de caractères, utilisez un trait d’union (-) pour séparer les caractères de début et de fin de la plage. Par exemple, correspond à [a-z0-9] n’importe quelle lettre ou numéro.
( ) (parenthèses associées)	Une instance de la valeur évaluée de la durée fermée. Les parenthèses sont utilisées pour indiquer l’ordre d’évaluation dans l’expression régulière.

Lorsque l’application demande une sortie avec balisage XML Junos (par défaut), le serveur de protocole XML Junos renvoie l’objet demandé et <rpc-reply> les <configuration> éléments de balise. Pour plus d’informations sur les attributs de la balise d’ouverture<configuration>, voir Spécification de la source pour les demandes d’informations de configuration dans une session du protocole Junos XML.

L’application peut combiner un ou plusieurs des countstart, et attributs avec recurse l’attribut, pour limiter l’ensemble matching des correspondances possibles à une plage d’objets spécifique, pour demander uniquement des identifiants, ou les deux. Pour plus d’informations sur ces attributs, voir Demander un nombre spécifique d’objets de configuration à l’aide du protocole Junos XML et Demander des identifiants pour des objets de configuration d’un type spécifique à l’aide du protocole XML Junos.

Pour spécifier la source de la sortie (configuration candidate ou active) et demander une mise en forme spéciale de la sortie (par exemple, ASCII ou JSON formaté ou un indicateur pour les identifiants), l’application peut inclure des attributs dans la balise d’ouverture <get-configuration> , sa balise d’ouverture <junoscript> , ou les deux. Pour plus d’informations, voir Spécification de la source pour les demandes d’informations de configuration dans une session du protocole Junos XML et Spécification du format de sortie pour les données de configuration dans une session du protocole Junos XML.

L’application peut demander des éléments de configuration supplémentaires du même type ou d’autres types dans le même <get-configuration> élément de balise en incluant les éléments de balise appropriés. Pour plus d’informations, consultez La demande de plusieurs éléments de configuration à l’aide du protocole JUNOs XML.

L’exemple suivant montre comment demander uniquement l’identifiant des deux premières interfaces SONET/SDH configurées au niveau hiérarchique [edit interfaces] .