Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

<edit-config>

Utilisation

Description

Demandez au serveur NETCONF d’incorporer les données de configuration dans la configuration candidate ou dans la base de données de configuration ouverte. Fournissez les données de l’une des trois manières suivantes :

  • Incluez l’élément <config> de balise pour fournir un flux de données d’éléments de balise de configuration XML Junos à incorporer. Les éléments de balise sont entourés de l’élément de <configuration> balise.

  • Incluez l’élément <config-text> tag pour fournir un flux de données d’instructions de configuration CLI à intégrer. Les instructions de configuration sont incluses dans l’élément <configuration-text> tag.

  • Incluez l’élément <url> tag pour spécifier l’emplacement d’un fichier contenant la configuration Junos OS à incorporer. Les données de configuration peuvent prendre la forme d’éléments XML Junos ou d’instructions de configuration CLI.

Si une application cliente exécute l’opération du protocole <open-configuration> XML Junos pour ouvrir une base de données de configuration spécifique avant d’exécuter l’opération <edit-config> sur la cible <candidate/>, Junos OS effectue l’opération <edit-config> sur la base de données de configuration ouverte. Dans le cas contraire, l’opération est effectuée sur la configuration candidate.

Contenu

<config>

Entourez l’élément tag <configuration> .
<configuration>

Joignez les données de configuration écrites au format Junos XML. Ces données de configuration sont fournies sous forme de flux de données et sont incorporées dans la base de données de configuration candidate ou de configuration ouverte. Pour plus d’informations sur la syntaxe de représentation des éléments à créer, supprimer ou modifier, reportez-vous à la section Mapper des instructions de configuration à des éléments de balise XML Junos.
<config-text>

Entourez l’élément tag <configuration-text> .
<configuration-text>

Joignez les données de configuration au format sous forme d’instructions de configuration CLI. Ces données de configuration sont fournies sous forme de flux de données et sont incorporées dans la base de données de configuration candidate ou de configuration ouverte.

<default-operation>

(Facultatif) Spécifiez comment incorporer les nouvelles données de configuration dans la configuration candidate ou dans la base de données de configuration ouverte, en particulier lorsqu’il existe des instructions contradictoires. Les valeurs acceptables sont les suivantes :

  • merge: combinez les nouvelles données de configuration avec la configuration existante selon les règles définies dans Définir le mode de modification de la configuration dans une session NETCONF. Il s’agit du mode par défaut si l’élément <default-operation> tag est omis. Il s’applique à tous les éléments des nouvelles données qui n’ont pas l’attribut operation dans leur balise de conteneur d’ouverture pour spécifier un mode différent.

  • none: conserve chaque élément de configuration dans la configuration existante, sauf si les nouvelles données incluent un élément correspondant dont l’attribut operation se trouve dans sa balise de conteneur d’ouverture pour spécifier un mode d’incorporation. Ce mode empêche le serveur NETCONF de créer des niveaux hiérarchiques parents pour un élément en cours de suppression. Pour plus d’informations, reportez-vous à la section Définir le mode de configuration de modification dans une session NETCONF.

  • replace: supprimez les données de configuration existantes dans la configuration candidate ou la base de données de configuration ouverte et remplacez-les par les nouvelles données. Pour plus d’informations, reportez-vous à la section Remplacer la configuration candidate à l’aide de NETCONF.
<error-option>

(Facultatif) Spécifiez la manière dont le serveur NETCONF gère les erreurs rencontrées lors de l’intégration des données de configuration. Les valeurs acceptables sont les suivantes :

  • ignore-error: spécifie que le serveur NETCONF continue d’incorporer les nouvelles données de configuration même s’il rencontre une erreur.

  • stop-on-error: spécifiez que le serveur NETCONF cesse d’incorporer les nouvelles données de configuration lorsqu’il rencontre une erreur. Il s’agit du comportement par défaut si l’élément <error-option> tag est omis.
<test-option>

(Facultatif) Indiquez si le serveur NETCONF valide les données de configuration avant de les incorporer dans la configuration candidate. Les valeurs acceptables définies dans la spécification NETCONF sont set (pas de validation) et la valeur par défaut test-then-set (ne pas incorporer de données en cas d’échec de la validation).

Quelle que soit la valeur fournie, le serveur NETCONF pour Junos OS effectue une vérification syntaxique de base sur les données de configuration de l’élément <edit-config> de balise. Il effectue une validation syntaxique et sémantique complète sur la configuration candidate en réponse aux <validate> éléments and <commit> tag, mais pas pour l’élément <edit-config> tag.

Note:

L’élément <test-option> n’est pas pris en charge lors de l’incorporation de données de configuration dans la base de données de configuration éphémère.
<url>

Spécifiez le chemin d’accès complet du fichier contenant les données de configuration à charger. Lorsque les données de configuration sont mises en forme en tant qu’éléments de balise XML Junos, définissez l’attribut <url> format sur « xml » ou omettez-le. Lorsque les données de configuration sont mises en forme en tant qu’instructions de configuration CLI, définissez l’attribut <url> format sur « text ». Pour plus d’informations, reportez-vous à la section Charger et formater des données de configuration dans une session NETCONF.

L’élément <target> de balise et son contenu sont expliqués séparément.

Documentation connexe

Tableau de l’historique des modifications

La prise en charge des fonctionnalités est déterminée par la plate-forme et la version que vous utilisez. Utilisez l’Explorateur de fonctionnalités pour déterminer si une fonctionnalité est prise en charge sur votre plateforme.

Libération
Description
21.1R1 et 21.1R1-EVO
À partir de Junos OS version 21.1R1 et Junos OS evolved version 21.1R1, lorsque vous définissez <default-operation> sur replace, le périphérique utilise une load update opération au lieu d’une load override opération pour remplacer la configuration. Lors des opérations de mise à jour de charge, l’équipement notifie uniquement les processus Junos qui correspondent aux instructions modifiées, minimisant ainsi les perturbations possibles du réseau.