Fusionner des éléments dans les données de configuration à l’aide du protocole Junos XML
Par défaut, le serveur de protocole Junos XML fusionne les données de configuration chargées dans la configuration du candidat selon les règles suivantes. (Les règles s’appliquent également à une copie privée de la configuration ou à une instance ouverte de la base de données de configuration éphémère, mais par souci de simplicité, la discussion suivante se rapporte uniquement à la configuration du candidat.)
Un élément de configuration (niveau hiérarchique ou objet de configuration) existant dans le candidat mais pas dans la configuration chargée reste inchangé.
Un élément de configuration existant dans la configuration chargée, mais pas dans le candidat, est ajouté au candidat.
Si un élément de configuration existe dans les deux configurations, la sémantique est la suivante :
Si une déclaration enfant de l’élément de configuration (représentée par un élément de balise enfant) existe dans le candidat, mais pas dans la configuration chargée, elle reste inchangée.
Si une déclaration enfant existe dans la configuration chargée, mais pas dans le candidat, elle est ajoutée au candidat.
Si une déclaration enfant existe dans les deux configurations, la valeur de la configuration chargée remplace la valeur du candidat.
Le mode de fusion est le mode par défaut pour les nouveaux éléments de configuration, de sorte que l’application émet simplement l’élément <load-configuration> de balise dans un <rpc> élément de balise :
<rpc>
<!-- For a file -->
<load-configuration url="file" [format="format"]/>
<!-- For a data stream -->
<load-configuration [format="format"]>
<!-- configuration data -->
</load-configuration>
</rpc>
Pour plus d’informations sur les attributs et format les url attributs, voir Chargement et mise en forme des données de configuration dans une session du protocole Junos XML.
Pour spécifier un mode de fusion explicite pour les données de configuration qui utilisent des éléments XML Junos, du texte ASCII formaté ou un format JSON, l’application peut inclure l’attribut action="merge" dans la <load-configuration> balise, comme illustré dans les exemples à la fin de cette section.
Lorsque vous utilisez des éléments de balise XML Junos pour représenter l’élément à fusionner dans la configuration, l’application inclut les éléments de balise de base décrits dans Création, modification ou suppression d’éléments de configuration à l’aide du protocole JUNOs XML. Il n’inclut aucun attribut dans la balise conteneur de l’élément. Si vous ajoutez ou modifiez la valeur d’un élément enfant, l’application inclut les éléments de balise pour celui-ci. Si un enfant reste inchangé, il n’a pas besoin d’être inclus dans la configuration chargée. Dans ce qui suit, l’élément de balise d’identification s’appelle <name>:
<configuration>
<!-- opening tag for each parent of the element -->
<container-tag>
<name>identifier</name> <!-- if the element has an identifier -->
<!-- tag elements for other children, if any -->
</container-tag>
<!-- closing tag for each parent of the element -->
</configuration>
Lorsque vous utilisez du texte ASCII formaté, l’application inclut le chemin d’instruction décrit dans Création, modification ou suppression d’éléments de configuration à l’aide du protocole JUNOs XML. Il n’inclut pas d’opérateur précédent, mais l’identifiant de l’élément s’il en a un. Si vous ajoutez ou modifiez la valeur d’un élément enfant, l’application inclut les éléments de balise pour celui-ci. Si un enfant reste inchangé, il n’a pas besoin d’être inclus dans la configuration chargée.
<configuration-text>
/* statements for parent levels of the element */
element identifier {
/* child statements if any */
}
/* closing braces for parent levels of the element */
</configuration-text>
À partir de la version 16.1 de Junos OS, vous pouvez charger les données de configuration formatées à l’aide de JavaScript Object Notation (JSON) sur l’équipement. Lorsque vous utilisez JSON pour représenter les éléments à fusionner dans la configuration, l’application inclut les données JSON de base décrites dans Création, modification ou suppression d’éléments de configuration à l’aide du protocole JUNOs XML. Il n’a pas besoin d’inclure d’attributs d’opération spécifiques dans les données de configuration JSON pour fusionner l’élément nouveau ou modifié. Si vous ajoutez ou modifiez la valeur d’un élément enfant, l’application inclut les données JSON ou les objets enfants. Si un enfant reste inchangé, il n’a pas besoin d’être inclus dans la configuration chargée. Dans l’exemple suivant, le membre JSON qui spécifie l’identifiant de l’élément a le nom de champ « name » :
<configuration-json>
{
"configuration" : {
/* JSON objects for parent levels of the element */
"container-tag" : {
"object" : [
{
"name" : "identifier",
"statement-name" : "statement-value", # if any
/* additional data and child objects */ # if any
}
],
/* data and child objects */ # if any
}
/* closing braces for parent levels of the element */
}
}
</configuration-json>
Lorsque vous utilisez des commandes en mode configuration pour fusionner de nouveaux éléments, l’application inclut les action="set" attributs et format="text" dans la <load-configuration> balise, comme illustré dans les exemples à la fin de cette section. L’application inclut la set commande, le chemin d’instruction vers l’élément et l’identifiant de l’élément s’il en a un. Si vous ajoutez ou modifiez la valeur d’un élément enfant, l’application inclut les éléments ou les déclarations enfants dans la commande. Si un enfant reste inchangé, il n’est pas nécessaire de l’inclure.
<configuration-set>
set statement-path-to-element element identifier child-statements
</configuration-set>
L’exemple suivant montre comment fusionner dans une nouvelle interface appelée so-3/0/0 au [edit interfaces] niveau hiérarchique de la configuration. Les informations sont fournies sous la forme d’éléments de balise XML Junos (par défaut).
L’exemple suivant montre comment utiliser un texte ASCII formaté pour définir la même nouvelle interface.
L’exemple suivant montre comment utiliser les données de configuration JSON pour définir la même interface.
<rpc>
<load-configuration format="json">
<configuration-json>
{
"configuration" : {
"interfaces" : {
"interface" : [
{
"name" : "so-3/0/0",
"unit" : [
{
"name" : 0,
"family" : {
"inet" : {
"address" : [
{
"name" : "10.0.0.1/8"
}
]
}
}
}
]
}
]
}
}
}
</configuration-json>
</load-configuration>
</rpc>
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/16.2R2/junos">
<load-configuration-results>
<load-success/>
</load-configuration-results>
</rpc-reply>
L’exemple suivant montre comment utiliser des commandes de mode de configuration pour définir la même interface.
