SUR CETTE PAGE
Supprimer des éléments de configuration à l’aide de NETCONF
Lors d’une session NETCONF avec un équipement exécutant Junos OS, pour supprimer un élément de configuration, y compris les niveaux hiérarchiques ou les objets de configuration, de la configuration existante dans la configuration candidate ou dans la base de données de configuration ouverte (si l’application cliente a lancé l’opération du protocole <open-configuration> Junos XML avant l’exécution de l’opération <edit-config> ), une application cliente émet les éléments de balise de base décrits dans Modifier les éléments de configuration individuels à l’aide de NETCONF. Il émet également l’élément <default-operation> de balise avec la valeur none permettant de changer le mode par défaut en mode sans modification.
<rpc> <edit-config> <target> <candidate/> </target> <default-operation>none</default-operation> <!-- EITHER --> <config> <configuration> <!-- tag elements representing the configuration elements to delete --> </configuration> </config> <!-- OR --> <url> <!-- location specifier for file containing elements to delete --> </url> </edit-config> </rpc> ]]>]]>
En mode sans changement, les éléments de configuration existants restent inchangés à moins que l’élément correspondant de la nouvelle configuration n’ait l’attribut operation="delete" dans sa balise d’ouverture. Ce mode empêche le serveur NETCONF de créer des niveaux hiérarchiques parent pour un élément en cours de suppression. Nous recommandons que la seule opération effectuée en mode sans changement soit la suppression. Lors de la fusion, du remplacement ou de la création d’éléments de configuration, les applications clientes utilisent le mode de fusion.
Pour représenter chaque élément de configuration supprimé (soit dans l’élément <config> de balise, soit dans le fichier nommé par l’élément <url> de balise), l’application émet des éléments de balise représentant ses niveaux hiérarchiques parents, comme décrit dans La section Modifier les éléments de configuration individuels à l’aide de NETCONF. L’élément de balise dans lequel l’attribut operation="delete" est inclus dépend du type d’élément, comme décrit dans les sections suivantes :
Suppression d’un niveau hiérarchique ou d’un objet conteneur
Pour supprimer un niveau hiérarchique et tous ses enfants (ou un objet conteneur qui a des enfants mais aucun identifiant), une application cliente inclut l’attribut operation="delete" dans la balise vide qui représente le niveau :
<configuration> <!-- opening tags for each parent level --> <level-to-delete operation="delete"/> <!-- closing tags for each parent level --> </configuration>
Nous recommandons à l’application de définir le mode de non-modification par défaut en incluant l’élément <default-operation> de balise avec la valeur none, comme décrit dans Définir le mode de configuration de modification dans une session NETCONF. Pour plus d’informations sur les niveaux hiérarchiques et les objets de conteneur, voir Mapper les déclarations de configuration aux éléments de balise XML Junos.
L’exemple suivant montre comment supprimer le [edit protocols ospf] niveau hiérarchique de la configuration du candidat :
Suppression d’un objet de configuration doté d’un identifiant
Pour supprimer un objet de configuration doté d’un identifiant, une application cliente inclut l’attribut operation="delete" dans l’élément de balise conteneur de l’objet. À l’intérieur de l’élément de balise conteneur, il inclut uniquement l’élément de balise d’identification, et non aucun élément de balise représentant d’autres caractéristiques. Dans ce qui suit, l’élément de balise d’identification s’appelle <name>:
<configuration> <!-- opening tags for each parent of the object --> <object operation="delete"> <name>identifier</name> </object> <!-- closing tags for each parent of the object --> </configuration>
L’attribut delete apparaît dans la balise de conteneur d’ouverture, et non dans l’élément de balise d’identification. La présence de l’élément de balise d’identification entraîne la suppression de l’objet spécifié, et non la suppression de l’ensemble du niveau hiérarchique représenté par l’élément de balise de conteneur.
Nous recommandons à l’application de définir le mode de non-modification par défaut en incluant l’élément <default-operation> de balise avec la valeur none, comme décrit dans Définir le mode de configuration de modification dans une session NETCONF. Pour plus d’informations sur les identifiants, voir Mapper les déclarations de configuration aux éléments de balise XML Junos.
L’exemple suivant montre comment supprimer l’objet barbara utilisateur du [edit system login user] niveau hiérarchique dans la configuration du candidat :
Suppression d’une option à valeur unique ou de forme fixe d’un objet de configuration
Pour supprimer d’un objet de configuration une option de forme fixe ou une option qui ne prend qu’une seule valeur, une application cliente inclut l’attribut operation="delete" dans l’élément de balise de l’option. Dans ce qui suit, l’élément de balise d’identification de l’objet est appelé <name>. (Pour plus d’informations sur la suppression d’une option pouvant prendre plusieurs valeurs, voir Suppression de valeurs d’une option multi-valeur d’un objet de configuration.)
<configuration> <!-- opening tags for each parent of the object --> <object> <name>identifier</name> <!-- if object has an identifier --> <option1 operation="delete"> <option2 operation="delete"> <!-- tag elements for other options to delete --> </object> <!-- closing tags for each parent of the object --> </configuration>
Nous recommandons à l’application de définir le mode de non-modification par défaut en incluant l’élément <default-operation> de balise avec la valeur none, comme décrit dans Définir le mode de configuration de modification dans une session NETCONF. Pour plus d’informations sur les options, consultez Mapper les déclarations de configuration aux éléments de balise XML Junos.
L’exemple suivant montre comment supprimer l’option de forme disable fixe au niveau de la [edit forwarding-options sampling] hiérarchie :
Suppression de valeurs d’une option multi-valeur d’un objet de configuration
Comme décrit dans Mapper les déclarations de configuration aux éléments de balise XML Junos, certains objets de configuration Junos OS sont des déclarations de branche qui ont plusieurs valeurs. Dans la représentation ASCII cli formatée, les valeurs sont placées entre crochets en suivant le nom de l’objet :
object[value1 value2 value3 ...];
La représentation XML de Junos n’utilise pas de balise parente pour l’objet, mais utilise une instance distincte de l’élément de balise d’objet pour chaque valeur. Dans ce qui suit, l’élément de balise d’identification s’appelle <name>:
<parent-object> <name>identifier</name> <object>value1</object> <object>value2</object> <object>value3</object> </parent-object>
Pour supprimer une ou plusieurs valeurs d’un tel objet, une application cliente inclut l’attribut dans la operation="delete" balise d’ouverture pour chaque valeur. Il n’inclut pas d’éléments de balise qui représentent les valeurs à conserver. L’élément de balise d’identification est appelé <name>:
<configuration> <!-- opening tags for each parent of the parent object --> <parent-object> <name>identifier</name> <object operation="delete">value1</object> <object operation="delete">value2</object> </parent-object> <!-- closing tags for each parent of the parent object --> </configuration>
Nous recommandons à l’application de définir le mode de non-modification par défaut en incluant l’élément <default-operation> de balise avec la valeur none, comme décrit dans Définir le mode de configuration de modification dans une session NETCONF. Pour plus d’informations sur les déclarations de branche avec plusieurs valeurs, voir Mapper les déclarations de configuration aux éléments de balise XML Junos.
L’exemple suivant montre comment supprimer deux des autorisations accordées à la user-accounts classe de connexion :
