<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 parente du chemin vers 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 conteneur, l’attribut junos:changed="changed" apparaît dans la balise de conteneur d’ouverture ainsi que dans chaque élément de balise enfant inclus dans l’élément de balise conteneur.

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

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

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

  Note:

  Lorsqu’une opération de validation réussit, le serveur retire 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 junos:changed="changed" éléments de balise qui ont changé avant l’opération de validation, ainsi que sur ceux qui ont changé après elle.

Un exemple d’avertissement en temps de validation est le message expliquant qu’un élément de configuration ne s’applique pas réellement tant que l’équipement n’est pas redémarré. L’avertissement apparaît dans la chaîne de balise que le serveur renvoie pour confirmer le succès de la validation, dans un élément de <xnm:warning> balise.

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

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

• apply: affiche la configuration en appliquant les modifications de script de validation, 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 excluez les modifications transitoires. 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 équivaut à 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 que le serveur de protocole NETCONF ou Junos XML affiche les différences entre la configuration active ou candidate et une configuration précédemment validée (configuration de comparaison).

L’attribut compare peut être combiné avec l’attribut database pour indiquer si la configuration du candidat 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 du candidat.

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’identifiant 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 compare mais que vous omettez l’attribut correspondant configuration-revision ou rollback que vous fournissez un identifiant de révision de configuration non valide, le serveur utilise la configuration validée la plus récente comme configuration de comparaison.

Lorsque vous comparez la configuration du candidat à la configuration active, l’opération renvoie le compare résultat 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 du candidat à 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 La version 15.1R1 de Junos OS, et vous pouvez afficher les différences dans le format JSON à partir de La version 16.1R1 de Junos OS.

Spécifiez la configuration à partir de laquelle les données doivent être affichées comme l’une des options suivantes :

• candidate— Configuration du candidat.

• committed— Configuration active (la dernière en date).

L’attribut database a la priorité 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 du candidat 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 normale du candidat pré-héritage. Pour les sessions de configuration privées, le script de validation récupère la configuration privée du candidat pré-héritage.

Si vous incluez à la fois les database attributs et les database-path attributs, l’attribut prend la database priorité.

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 la version 16.1 de Junos OS, 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 données entières de configuration de Junos OS émises au format JSON ne sont pas jointes entre guillemets. Dans les versions précédentes, les nombres entiers dans les données de configuration JSON étaient traités comme des chaînes et placés entre guillemets.

• set— Les déclarations de configuration sont mises en forme sous la forme de commandes du mode set de configuration Junos OS.

• text: les instructions de configuration sont mises en forme en texte ASCII, à l’aide du caractère newline, des onglets et d’autres espaces blancs, accolades et 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 junos:group="group-name" apparaît dans la balise d’ouverture pour chaque élément de configuration hérité d’un 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 groups , vous devez également spécifier l’attribut inherit .

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

Les valeurs acceptables sont :

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

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

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

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

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