Renommer les objets dans les données de configuration à l’aide du protocole Junos XML
Dans une session de protocole Junos XML avec un équipement exécutant Junos OS, pour modifier le nom d’un ou plusieurs identifiants d’un objet de configuration, une application cliente inclut les éléments de balise décrits dans Création, modification ou suppression d’éléments de configuration à l’aide du protocole XML Junos. Lorsque vous utilisez des éléments de balise XML Junos, l’application cliente inclut l’attribut rename="rename" et un attribut nommé d’après le mot-clé d’identification dans la balise d’ouverture de l’objet. La valeur de l’attribut est la nouvelle valeur d’identification. L’application inclut l’élément de balise d’identification pour spécifier le nom actuel. Dans ce qui suit, l’élément de balise d’identification s’appelle <name>:
<configuration>
<!-- opening tag for each parent of the object -->
<object rename="rename" name="new-name">
<name>current-name</name>
</object>
<!-- closing tag for each parent of the object -->
</configuration>
Si l’objet possède plusieurs identifiants, l’application inclut à la fois un attribut dans la balise d’ouverture et un élément de balise d’identification. Si un ou plusieurs des identifiants ne changent pas, la valeur de l’attribut est définie sur son nom actuel. La balise d’ouverture s’affiche sur deux lignes uniquement pour la lisibilité :
<configuration>
<!-- opening tag for each parent of the object -->
<object rename="rename" changing-identifier="new-name" \
unchanging-identifier="current-name">
<changing-identifier>current-name</changing-identifier>
<unchanging-identifier>current-name</unchanging-identifier>
</object>
<!-- closing tag for each parent of the object -->
</configuration>
Lorsque vous utilisez des commandes en mode configuration pour renommer un objet, l’application spécifie la rename commande équivalente à la commande du mode de configuration CLI. Si l’objet possède plusieurs identifiants, l’application inclut une commande distincte rename pour chaque identifiant.
<configuration-set>
rename statement-path-to-object object current-name to object new-name
</configuration-set>
L’opération de renommage n’est pas disponible lorsque le texte ASCII mis en forme ou json est utilisé pour représenter les données de configuration.
Pour les éléments de balise XML Junos, l’attribut rename peut être combiné avec l’attribut inactive ou active pour désactiver ou réactiver l’élément de configuration au fur et à mesure qu’il est renommé. Pour plus d’informations, consultez Modification simultanée de l’état d’activation d’un élément de configuration avec d’autres modifications à l’aide du protocole JUNOs XML.
L’exemple suivant montre comment changer le nom d’un filtre de pare-feu à l’aide new-access-control d’éléments de access-control balise XML Junos. Cette opération équivaut à la commande du mode de configuration suivante :
[edit firewall family inet] user@host# rename filter access-control to filter new-access-control
L’exemple suivant montre comment changer le nom d’un filtre de pare-feu à l’aide new-access-control de commandes de mode de access-control configuration :
<rpc>
<load-configuration action="set" format="text">
<configuration-set>
rename firewall family inet filter access-control to filter new-access-control
</configuration-set>
</load-configuration>
</rpc>
L’exemple suivant montre comment modifier les identifiants d’une liaison virtuelle OSPF (définie au niveau de la [edit protocols ospf area area] hiérarchie) de neighbor-id 192.168.0.3 et transit-area 10.10.10.1 vers neighbor-id 192.168.0.7 et transit-area 10.10.10.5. Cette opération équivaut à la commande du mode de configuration suivante (qui apparaît sur deux lignes uniquement pour la lisibilité) :
[edit protocols ospf area area] user@host# rename virtual-link neighbor-id 192.168.0.3 transit-area \ 10.10.10.1 to virtual-link neighbor-id 192.168.0.7 transit-area 10.10.10.5
Application cliente
<rpc>
<load-configuration>
<configuration>
<protocols>
<ospf>
<area>
<name>area</name>
<virtual-link rename="rename" neighbor-id="192.168.0.7 transit-area="10.10.10.5">
<neighbor-id>192.168.0.3</neighbor-id>
<transit-area>10.10.10.1</transit-area>
</virtual-link>
</area>
</ospf>
</protocols>
</configuration>
</load-configuration>
</rpc>
Serveur de protocole Junos XML
<rpc-reply xmlns:junos="URL">
<load-configuration-results>
<load-success/>
</load-configuration-results>
</rpc-reply>