Création, modification ou suppression d’éléments de configuration à l’aide du protocole Junos XML
Dans une session de protocole XML Junos avec un périphérique exécutant Junos OS, en plus de remplacer l’intégralité de la configuration, une application cliente peut créer, modifier ou supprimer un ou plusieurs éléments de configuration (niveaux hiérarchiques et objets de configuration) dans la base de données de configuration candidate ou ouverte.
Pour utiliser des éléments de balise XML Junos pour représenter un élément, l’application inclut les éléments de balise représentant tous les niveaux de la hiérarchie de configuration, de la racine (représentée par l’élément tag <configuration> ) jusqu’à l’élément de balise conteneur de l’élément. Les attributs et les éléments de balise enfants inclus dépendent de l’opération effectuée sur l’élément. La syntaxe s’applique à la fois au contenu d’un fichier et à un flux de données. Dans l’exemple suivant, l’élément de balise d’identification est appelé <name>:
<configuration>
<!-- opening tag for each parent of the element -->
<container-tag [operation-attribute="value"]>
<name>identifier</name> <!-- if the element has an identifier -->
<!-- child tag elements --> <!-- if appropriate -->
</container-tag>
<!-- closing tag for each parent of the element -->
</configuration>
Pour utiliser du texte ASCII formaté pour représenter un élément, l’application inclut le chemin d’accès complet à l’instruction, en commençant par une instruction qui peut apparaître directement sous le niveau hiérarchique [edit] . Les attributs et les instructions enfants à inclure dépendent de l’opération effectuée sur l’élément. L’application entoure l’ensemble d’instructions dans un <configuration-text> élément de balise lorsqu’elle télécharge les données de configuration en tant que flux de données. L’application omet l’élément <configuration-text> de balise lorsque les données de configuration sont stockées et chargées à partir d’un fichier.
<configuration-text>
/* statements for parent levels of the element */
operation-to-perform: # if appropriate
element identifier { # if the element has an identifier
/* child statements */ # if appropriate for the operation
}
/* closing braces for parent levels of the element */
</configuration-text>
Lors du chargement de texte ASCII formaté, l’application doit inclure l’attribut format="text" dans la <load-configuration> balise.
Pour créer, modifier ou supprimer un élément à l’aide de commandes en mode configuration, l’application inclut les commandes telles qu’elles seraient saisies en mode configuration dans l’interface de ligne de commande. Les instructions de configuration sont exécutées dans l’ordre prévu. Vous pouvez spécifier le chemin d’accès complet à l’instruction dans la commande, ou vous pouvez utiliser des commandes de navigation CLI telles que edit et up, pour vous déplacer dans la hiérarchie de configuration.
L’application enferme l’ensemble de commandes dans un <configuration-set> élément de balise lorsqu’elle télécharge les données de configuration en tant que flux de données. L’application omet l’élément <configuration-set> de balise lorsque les données de configuration sont stockées et chargées à partir d’un fichier.
<configuration-set>
/* configuration mode commands */
</configuration-set>
Lors du chargement des commandes du mode set de configuration, l’application doit inclure les action="set" attributs et format="text" dans la <load-configuration> balise.
À partir de Junos OS version 16.1, vous pouvez charger des données de configuration formatées à l’aide de JavaScript Object Notation (JSON) sur le périphérique. Pour utiliser le format JSON pour représenter un élément, l’application inclut des objets JSON représentant tous les niveaux de la hiérarchie de configuration, de la racine jusqu’à l’objet JSON représentant cet élément. Les attributs et les objets enfants à inclure dépendent de l’opération effectuée sur l’élément. Si la valeur de l’attribut est un type de données booléen, elle n’est pas placée entre guillemets.
L’application enferme les données JSON dans un élément de <configuration-json> balise lorsqu’elle télécharge les données de configuration en tant que flux de données. L’application omet l’élément <configuration-json> de balise lorsque les données de configuration sont stockées et chargées à partir d’un fichier.
<configuration-json>
{
"configuration" : {
/* JSON objects for parent levels of the element */
"container-tag" : {
"@" : {
"operation-attribute" : ( "value" | boolean )
},
"object" : [
{
"@" : {
"operation-attribute" : ( "value" | boolean )
},
"(name | element-identifier)" : "identifier",
"statement-name" : "statement-value",
"@statement-name" : {
"operation-attribute" : ( "value" | boolean )
},
/* additional JSON data and child objects */
}
]
}
/* closing braces for parent levels of the element */
}
}
</configuration-json>
Lors du chargement de données au format JSON, l’application doit inclure l’attribut format="json" dans la <load-configuration> balise.
Pour plus d’informations sur la source et la mise en forme des éléments de configuration, reportez-vous à la section Chargement et mise en forme des données de configuration dans une session de protocole XML Junos.
Pour plus d’informations sur les opérations qu’une application cliente peut effectuer sur les éléments de configuration, consultez les sections suivantes :
Création d’éléments dans les données de configuration à l’aide du protocole Junos XML
Fusion d’éléments dans des données de configuration à l’aide du protocole Junos XML
Remplacement d’éléments dans les données de configuration à l’aide du protocole Junos XML
Suppression d’éléments dans les données de configuration à l’aide du protocole Junos XML
Renommage d’objets dans les données de configuration à l’aide du protocole Junos XML
Réorganisation des éléments dans les données de configuration à l’aide du protocole Junos XML
Protection ou déprotection d’un objet de configuration à l’aide du protocole Junos XML
Modification de l’état d’activation d’un élément de configuration à l’aide du protocole Junos XML
Remplacement de modèles dans les données de configuration à l’aide du protocole NETCONF ou Junos XML