<get-configuration>

Spécifiez que l’attribut junos:changed="changed" doit apparaître dans la balise d’ouverture de chaque élément de configuration modifié.

L’attribut apparaît dans la balise d’ouverture de chaque élément de balise parent dans le chemin d’accès à l’élément de configuration modifié, y compris la balise d’ouverture <configuration> de niveau supérieur. Si l’élément de configuration modifié est représenté par une seule balise (vide), l’attribut junos:changed="changed" apparaît dans la balise. Si l’élément modifié est représenté par un élément de balise de conteneur, l’attribut apparaît dans la balise de conteneur d’ouverture ainsi que dans chaque élément de balise enfant inclus dans l’élément junos:changed="changed" de balise de conteneur.

L’attribut database peut être combiné avec l’attribut changed="changed" pour demander la configuration candidate ou active :

• Lorsque la configuration candidate est demandée (l’attribut est inclus ou l’attribut est complètement omis), les éléments ajoutés à la configuration candidate après la dernière opération de validation sont marqués avec l’attribut database="candidate" database junos:changed="changed" .

• Lorsque la configuration active est demandée (l’attribut est inclus), les éléments ajoutés à la configuration active par le commit le plus récent sont marqués avec l’attribut database="committed" junos:changed="changed" .

  Note:

  Lorsqu’une opération de validation réussit, le serveur supprime l’attribut junos:changed="changed" de tous les éléments de balise. Toutefois, si des avertissements sont générés pendant la validation, l’attribut n’est pas supprimé. Dans ce cas, l’attribut apparaît dans les éléments de balise qui ont changé avant l’opération junos:changed="changed" de validation ainsi que sur ceux qui ont changé après celle-ci.

Un exemple d’avertissement de validation est le message expliquant qu’un élément de configuration ne s’appliquera pas tant que le périphérique n’aura pas été redémarré. L’avertissement apparaît dans la chaîne de balises que le serveur renvoie pour confirmer la réussite de la validation, entouré d’un <xnm:warning> élément de balise.

Pour supprimer l’attribut des éléments modifiés avant la validation, effectuez les actions nécessaires pour éliminer la cause de l’avertissement junos:changed="changed" et validez à nouveau la configuration.

Demandez que le serveur de protocole XML NETCONF ou Junos affiche des données XML de type script de validation. La valeur de l’attribut détermine la sortie. Les valeurs acceptables sont les suivantes :

• apply: affiche la configuration avec les modifications de script de validation appliquées, y compris les modifications transitoires et non transitoires. La sortie est équivalente à la sortie CLI lors de l’utilisation de l’option | display commit-scripts .

• apply-no-transients: affiche la configuration avec les modifications de script de validation appliquées, mais exclut les modifications temporaires. La sortie est équivalente à la sortie CLI lors de l’utilisation de l’option | display commit-scripts no-transients .

• view: affiche la configuration au format XML entrant dans un script de validation. Cela revient à afficher la configuration avec les attributs inherit="inherit", groups="groups"et changed="changed". La sortie est équivalente à la sortie CLI lors de l’utilisation de l’option | display commit-scripts view .

Demandez au serveur de protocole XML NETCONF ou Junos d’afficher les différences entre la configuration active ou candidate et une configuration précédemment validée (la configuration de comparaison).

L’attribut compare peut être combiné avec l’attribut database pour indiquer si la configuration candidate ou la configuration active est comparée à la configuration précédemment validée. Si vous omettez l’attribut database , la comparaison utilise la configuration candidate.

L’attribut compare accepte les valeurs suivantes, qui indiquent la méthode utilisée pour référencer la configuration de comparaison :

• configuration-revision: référencez la configuration de comparaison à l’aide de sa chaîne d’identificateur de révision de configuration, que vous définissez dans l’attribut configuration-revision="revision-id" .

• rollback: référencez la configuration de comparaison à l’aide de son index de restauration, que vous définissez dans l’attribut rollback="rollback-number" .

Si vous incluez l’attribut, mais omettez l’attribut ou rollback correspondant configuration-revision ou fournissez un identificateur de révision de configuration non valide, compare le serveur utilise la dernière configuration validée comme configuration de comparaison.

Lorsque vous comparez la configuration candidate à la configuration active, l’opération renvoie une compare sortie XML. Pour toutes les autres comparaisons, il renvoie la sortie sous forme de texte à l’aide d’un format de correctif. Lorsque vous comparez la configuration candidate à la configuration active, vous pouvez afficher les différences de format texte, XML ou JSON en incluant la valeur appropriée pour l’attribut format dans la demande. Vous pouvez afficher les différences de format XML à partir de Junos OS version 15.1R1, et vous pouvez afficher les différences de format JSON à partir de Junos OS version 16.1R1.

Spécifiez la configuration à partir de laquelle afficher les données comme l’une des suivantes :

• candidate: la configuration candidate.

• committed: la configuration active (la plus récemment validée).

L’attribut database est prioritaire sur l’attribut, database-path si les deux sont inclus.

Dans un script de validation, cet attribut spécifie le chemin d’accès à la configuration candidate de préhéritage de la session. La seule valeur acceptable est $junos-context/commit-context/database-path.

Pour les sessions de configuration normales, le script de validation récupère la configuration candidate normale antérieure à l’héritage. Pour les sessions de configuration privées, le script de validation récupère la configuration candidate privée antérieure à l’héritage.

Si vous incluez à la fois les attributs et les database database-path attributs, l’attribut database est prioritaire.

Spécifiez le format dans lequel le serveur de protocole XML NETCONF ou Junos renvoie les données de configuration. Les valeurs acceptables sont les suivantes :

• json: les instructions de configuration sont mises en forme à l’aide de JSON (JavaScript Object Notation). À partir de Junos OS version 16.1, les équipements exécutant Junos OS émettent des données de configuration au format JSON à l’aide d’une nouvelle implémentation par défaut pour la sérialisation.

  Note:

  À partir des versions 16.1R4, 16.2R2 et 17.1R1 de Junos OS, les entiers des données de configuration de Junos OS émises au format JSON ne sont pas placés entre guillemets. Dans les versions antérieures, les entiers dans les données de configuration JSON étaient traités comme des chaînes et placés entre guillemets.

• set: les instructions de configuration sont mises en forme en tant que commandes du mode set de configuration Junos OS.

• text: les instructions de configuration sont mises en forme sous forme de texte ASCII, à l’aide du caractère de nouvelle ligne, des tabulations et autres espaces, des accolades et des crochets pour indiquer les relations hiérarchiques entre les instructions. Il s’agit du format utilisé dans les fichiers de configuration stockés sur un équipement exécutant Junos OS et affichés par la commande CLI show configuration .

• xml: les instructions de configuration sont représentées par les éléments de balise XML Junos correspondants. Il s’agit de la valeur par défaut si l’attribut format est omis.

Spécifiez que l’attribut apparaît dans la balise d’ouverture pour chaque élément de configuration hérité d’un junos:group="group-name" groupe de configuration. La group-name variable spécifie le nom du groupe de configuration dont cet élément a été hérité.

La seule valeur acceptable pour l’attribut groups est groups. Lorsque vous spécifiez l’attribut, vous devez également spécifier l’attribut groups inherit .

Spécifiez comment le serveur de protocole XML NETCONF ou Junos affiche les instructions définies dans les groupes de configuration et les plages d’interfaces. Si l’attribut est omis, la sortie utilise les éléments , <apply-groups>et tag pour représenter les groupes de configuration définis par l’utilisateur et <apply-groups-except> utilise l’élément tag pour représenter les plages d’interface définies par l’utilisateur ; elle n’inclut inherit pas les éléments tag pour les <groups><interface-range> instructions définies dans le groupe junos-defaults.

Les valeurs acceptables sont les suivantes :

• defaults: la sortie n’inclut pas les éléments , et tag, <apply-groups>mais affiche à la place les éléments tag hérités des groupes définis par l’utilisateur et <apply-groups-except> du groupe junos-defaults en tant qu’enfants <groups>des éléments de balise héritiers.

• inherit: la sortie n’inclut pas les éléments , , <apply-groups-except>et tag, <apply-groups>mais affiche à la place les éléments de balise hérités de groupes et <interface-range> de plages définis par l’utilisateur en tant qu’enfants <groups>des éléments de balise héritiers. La sortie n’inclut pas les éléments de balise pour les instructions définies dans le groupe junos-defaults.

Spécifiez que l’attribut apparaît dans la balise d’ouverture pour chaque élément de configuration hérité d’une plage d’interface junos:interface-ranges="source-interface-range" . La source-interface-range variable spécifie le nom de la plage d’interfaces.

La seule valeur acceptable pour l’attribut interface-ranges est interface-ranges. Lorsque vous spécifiez l’attribut, vous devez également spécifier l’attribut interface-ranges inherit .

Spécifiez que l’attribut apparaît dans la balise d’ouverture de chaque élément qui sert d’identificateur junos:key="key" à un objet de configuration. La seule valeur acceptable est key.