Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Comprendre le module YANG Junos DDL Extensions

Le module YANG (Junos Data Definition Language) contient des extensions YANG pour les équipements Junos. Ces extensions comprennent des instructions qui peuvent définir des contraintes sur les données de configuration et les valeurs valides pour les chaînes. Il existe également des instructions que vous incluez dans les RPC personnalisés pour définir une commande CLI pour le RPC et pour spécifier des détails sur le script d’action à invoquer lors de l’exécution du RPC. En outre, vous pouvez utiliser des instructions pour définir des scripts d’action d’aide pour les options de commande individuelles et les instructions de configuration, par exemple, pour afficher une liste des valeurs acceptables pour les options ou les déclarations.

Note:

À partir de la version 17.4 de Junos OS, les modules YANG de Junos OS utilisent une nouvelle convention de nommage pour le nom, le nom et l’espace de noms du module. Le nom et le nom du module incluent la famille d’équipements et la version Junos OS, et le nom de fichier inclut également une date de révision.

Le tableau 1 présente les déclarations du module d’extensions DDL et fournit une brève description de chaque état.

Tableau 1 : Déclarations dans le module junos-extension

Mot-clé de déclaration

Description de l’argument

action-execute

Définissez les actions effectuées lors de l’exécution d’un RPC personnalisé. Utilisez la script sous-déclaration pour définir le script d’action du RPC, qui est appelé lorsque vous exécutez le RPC.

À partir de la version 17.3 de Junos OS, l’instruction action-execute est une sous-déclaration à command.

action-expand

Définissez le script qui calcule et affiche les valeurs possibles pour une option de commande ou une déclaration de configuration donnée dans un modèle de données YANG personnalisé lorsqu’un utilisateur demande une aide contextuelle dans la CLI.

Utilisez le script sous-état pour définir le script Python qui implémente la logique.

cli-feature

Identifiez certaines propriétés CLI associées à certaines options de commande et déclarations de configuration. Voir les propriétés prises en charge par la fonctionnalité cli.

command

Chaîne définissant la commande opérationnelle utilisée pour exécuter le RPC correspondant dans l’interface CLI Junos OS.

À partir de la version 17.3 de Junos OS, l’instruction command inclut la sous-déclaration action-execute, qui définit les actions effectuées lors de l’exécution du RPC.

must

Chaîne qui identifie une contrainte sur les données de configuration.

Alors que l’argument de l’instruction YANG must est une chaîne contenant une expression XPath, l’argument de l’instruction junos:must d’extension est une chaîne contenant la syntaxe Junos OS spéciale requise pour l’expression du chemin d’instruction de configuration. Cela peut inclure des mots clés spéciaux tels que any, allet unique.

must-message

Chaîne qui définit le message d’avertissement émis lorsque la contrainte définie par l’instruction correspondante junos:must est évaluée à false.

pattern-message

Chaîne qui définit le message d’erreur émis lorsque la contrainte définie par l’instruction correspondante posix-pattern est évaluée à false.

posix-pattern

Limitez les valeurs acceptées pour les nœuds de type chaîne à celles qui correspondent à l’expression régulière POSIX définie dans cette chaîne.

script

Chaîne spécifiant le nom d’un script d’action. Il s’agit d’une sous-déclaration du action-execute ou action-expand .

propriétés prises en charge de la fonctionnalité cli

L’extension cli-feature YANG identifie certaines propriétés CLI associées à certaines options de commande et déclarations de configuration. Cette extension est bénéfique lorsqu’un client utilise des modèles de données YANG, mais pour certains workflows, le client doit générer des outils basés sur une CLI. Les propriétés prises en charge sont les suivantes :

  • homogenous— Les groupes de données de configuration au format texte répertorient les objets dans un ensemble unique d’accolades sous le mot-clé objet.

  • nokeyword: la CLI ne nécessite pas de spécifier explicitement le nom de la branche dans la syntaxe d’entrée.

  • oneliner/oneliner-plus— Les données de configuration au format texte placent les attributs d’un objet sur une seule ligne. L’indicateur oneliner le fait sans exception ; il ne le oneliner-plus fait que lorsque zéro ou une valeur apparaît pour un attribut.

Tableau de l’historique des versions
Libération
Description
22.3R1 et 22.3R1-EVO
À partir de Junos OS version 23.1R1 et Junos OS Evolved version 23.1R1, les modules YANG qui définissent la configuration ou les RPC incluent les déclarations d’extension, le cli-feature cas échéant, dans les schémas émis avec les extensions.
17.4R1
À partir de la version 17.4 de Junos OS, les modules YANG de Junos OS utilisent une nouvelle convention de nommage pour le nom, le nom et l’espace de noms du module.