Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

<load-configuration>

Utilisation

Description

Demandez au serveur de protocole XML NETCONF ou Junos de charger les données de configuration dans la configuration candidate ou ouvrez la base de données de configuration.

Si une application cliente lance l’opération de protocole <open-configuration> XML Junos pour ouvrir une base de données de configuration spécifique avant d’exécuter l’opération <load-configuration> , le serveur charge les données de configuration dans la base de données de configuration ouverte. Sinon, le serveur charge les données de configuration dans la configuration candidate.

Fournissez les données à charger de l’une des manières suivantes :

  • Définissez l’attribut de la balise vide <load-configuration/> sur l’identificateur de révision de configuration-revision configuration d’une configuration précédemment validée. La configuration spécifiée remplace complètement la configuration candidate.

  • Définissez l’attribut de rescue la balise vide <load-configuration/> sur la valeur rescue. La configuration de secours remplace complètement la configuration candidate.

  • Définissez l’attribut de la balise vide <load-configuration/> sur l’index de rollback restauration d’une configuration précédemment validée. L’appareil stocke une copie de la dernière configuration validée et jusqu’à 49 configurations précédentes. La configuration spécifiée remplace complètement la configuration candidate.

  • Définissez l’attribut de url la balise vide <load-configuration/> sur le chemin d’accès d’un fichier contenant les données de configuration à charger. Définissez l’attribut format sur json, textou pour charger une configuration au format respectif - JavaScript Object Notation (JSON), texte ASCII formaté ou xml éléments de balise Junos XML (valeur par défaut). Pour fournir les données de configuration sous forme de commandes du mode de configuration, incluez l’attribut et omettez l’attribut action="set" format ou définissez la valeur sur text.

    Dans l’exemple suivant, l’attribut url identifie que les données de configuration doivent être chargées à partir du fichier /tmp/add.conf.

  • Placez les données de configuration sous forme de flux de données dans une balise d’ouverture <load-configuration> et de fermeture</load-configuration>. Si les données de configuration sont fournies sous forme de texte ASCII au format ASCII, placez les données dans un <configuration-text> élément de balise et définissez l’attribut format sur text. Si vous fournissez les données de configuration en tant qu’éléments de balise XML Junos, placez les données dans un <configuration> élément tag et omettez l’attribut format ou définissez la valeur sur xml. Si vous fournissez les données de configuration en tant que commandes du mode de configuration, placez les données dans un <configuration-set> élément de balise, définissez l’attribut sur , et omettez l’attribut format action ou définissez la valeur sur settext. Si vous fournissez les données de configuration en JSON, placez les données dans un <configuration-json> élément tag et définissez l’attribut format sur json.

Attributs

action

Spécifiez le mode de chargement des données de configuration, en particulier lorsque la base de données de configuration cible et la configuration chargée contiennent des instructions contradictoires.

La base de données de configuration éphémère prend en charge les valeurs d’attribut suivantes action sur les périphériques pris en charge dans les versions spécifiées :

  • merge et —pris en charge dans Junos OS version 16.2R2 et setultérieure

  • override et —pris en charge dans Junos OS version 18.1R1 et replaceultérieure

  • update—pris en charge dans Junos OS version 21.1R1 et ultérieure

Les valeurs suivantes sont acceptables :

  • merge: combinez les données de la configuration chargée avec les données de la configuration cible. Si les instructions de la configuration chargée entrent en conflit avec les instructions de la configuration cible, elles remplacent celles de la configuration cible. Il s’agit du comportement par défaut si l’attribut action est omis.

  • override: supprimez toute la configuration candidate et remplacez-la par la configuration chargée. Lorsque la configuration est validée ultérieurement, tous les processus système analysent la nouvelle configuration.

  • replace: substituez chaque niveau de hiérarchie ou objet de configuration défini dans la configuration chargée au niveau ou objet correspondant dans la configuration candidate.

    Si les données de configuration sont fournies sous forme de texte ASCII au format (soit dans le fichier nommé par l’attribut, soit placé dans un <configuration-text> élément de balise), placez également l’instruction sur la ligne qui précède directement les instructions qui représentent le niveau hiérarchique ou l’objet url replace: à remplacer. Pour plus d’informations, reportez-vous à la section sur le chargement d’un fichier de données de configuration dans le Guide de l’utilisateur de l’interface de ligne de commande.

    Si vous fournissez les données de configuration en tant qu’éléments de balise XML Junos, incluez l’attribut dans les balises d’ouverture replace="replace" des éléments qui représentent les niveaux hiérarchiques ou les objets à remplacer.

  • set: charge les données de configuration formatées en tant que commandes du mode de configuration Junos OS. Cette option exécute les instructions de configuration ligne par ligne lorsqu’elles sont stockées dans un fichier nommé par l’attribut url ou placé dans un <configuration-set> élément de balise. Les instructions peuvent contenir n’importe quelle commande du mode de configuration, telle que set, , deleteeditou deactivate. Lorsque vous fournissez les données de configuration sous la forme d’un ensemble de commandes, la seule valeur acceptable pour l’attribut format est « text ». Si la valeur de l’attribut est « set » et que l’attribut est omis, la valeur par défaut de l’attribut est « text » au lieu de action xml.format format

  • update: comparez une configuration chargée complète à la configuration candidate. Pour chaque niveau de hiérarchie ou objet de configuration différent dans les deux configurations, la version de la configuration chargée remplace la version de la configuration candidate. Lorsque la configuration est validée ultérieurement, seuls les processus système affectés par les éléments de configuration modifiés analysent la nouvelle configuration.

configuration-revision

Chargez une configuration précédemment validée en référençant son identificateur de révision de configuration. La configuration spécifiée remplace complètement la configuration candidate.

format

Spécifiez le format utilisé pour les données de configuration. Les valeurs acceptables sont les suivantes :

  • json–Indiquez que les données de configuration sont formatées à l’aide de JSON (JavaScript Object Notation).

  • text: indique que les données de configuration sont au format texte ASCII ou ensemble de commandes du mode de configuration.

    Le format texte ASCII utilise le caractère de nouvelle ligne, les tabulations et autres espaces, les accolades et les crochets pour indiquer les relations hiérarchiques entre les instructions. Il s’agit du format utilisé dans les fichiers de configuration stockés sur la plateforme de routage et du format affiché par la commande CLI show configuration . Le set format de commande se compose d’une série de commandes du mode de configuration Junos OS et est affiché par la commande CLI show configuration | display set . Pour charger un ensemble de commandes du mode de configuration, vous devez définir l’attribut action sur « set ».

  • xml: indique que les données de configuration sont mises en forme à l’aide d’éléments de balise XML Junos. Si l’attribut est omis, « xml » est le format par défaut pour toutes les valeurs de l’attribut à l’exception format action de « set », qui formate par défaut « text ».

rescue

Spécifiez que la configuration de secours remplace la configuration candidate actuelle. La seule valeur valide est « rescue ».

Note:

À partir de Junos OS version 18.1R1, vous pouvez également utiliser le <rollback-config> RPC pour charger une configuration précédemment validée, ce qui est utile pour les applications qui ne prennent pas en charge l’exécution de RPC qui incluent des attributs XML.

rollback

Chargez une configuration précédemment validée en référençant son index de restauration numérique. Les valeurs valides sont comprises entre 0 (zéro, pour la dernière configuration validée) et une de moins que le nombre de configurations précédentes stockées (49 au maximum).

Note:

À partir de Junos OS version 18.1R1, vous pouvez également utiliser le <rollback-config> RPC pour charger une configuration précédemment validée, ce qui est utile pour les applications qui ne prennent pas en charge l’exécution de RPC qui incluent des attributs XML.

url

Spécifiez le chemin d’accès complet du fichier contenant les données de configuration à charger. La valeur peut être un chemin d’accès au fichier local, un emplacement FTP ou une URL HTTP (Hypertext Transfer Protocol) :

  • Un nom de fichier local peut avoir l’une des formes suivantes :

    • /path/filename —Fichier sur un système de fichiers monté, soit sur le disque flash local, soit sur le disque dur.

    • Un:filename ou a :path/filename : fichier sur le lecteur local. Le chemin par défaut est / (le répertoire de niveau racine). Le support amovible peut être au format MS-DOS ou UNIX (UFS).

  • Un nom de fichier sur un serveur FTP a la forme suivante :

  • Un nom de fichier sur un serveur HTTP a la forme suivante :

Dans chaque cas, la valeur par défaut de la path variable est le répertoire de base du nom d’utilisateur. Pour spécifier un chemin absolu, l’application commence le chemin avec les caractères %2F ; par exemple, ftp://username :password@hostname/%2Fpath/filename.

Informations sur la version

Il s’agit d’une opération du protocole de gestion XML Junos. Il est pris en charge dans les sessions de protocole XML Junos, et il est pris en charge en tant qu’extension propriétaire de Juniper Networks dans les sessions NETCONF sur les appareils exécutant Junos OS qui identifient l’URI http://xml.juniper.net/netconf/junos/1.0 dans l’échange de fonctionnalités.

action valeur set d’attribut ajoutée dans Junos OS version 11.4.

format valeur json d’attribut ajoutée dans Junos OS version 16.1.

configuration-revision Attribut ajouté dans Junos OS version 20.4R1 et Junos OS Evolved version 20.4R1.