使用 Junos XML 协议重命名配置数据中的对象
在 Junos XML 协议会话中,与运行 Junos OS 的设备更改一个或多个配置对象标识符的名称,客户端应用程序包括使用 Junos XML 协议创建、修改或删除配置元素中所述的标签元素。使用Junos XML 标记 rename="rename" 元素时,客户端应用程序包括属性和在对象开放标记中以标识符关键字命名的属性。属性的值是新的标识符值。应用程序包括标识符标记元素以指定当前名称。在以下内容中,标识符标记元素称为 <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>
如果对象有多个标识符,则对于每个标识符,应用程序都包括开放标记中的属性和标识符标记元素。如果一个或多个标识符未更改,则其属性值将设置为其当前名称。开口标记仅以两行显示,但仅表示清晰性:
<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>
使用配置模式命令重命名对象 rename 时,应用程序指定与 CLI 模式命令等效的命令。如果对象有多个标识符,应用程序将包含每个 rename 标识符的单独命令。
<configuration-set>
rename statement-path-to-object object current-name to object new-name
</configuration-set>
当格式化的 ASCII 文本或 JSON 用于表示配置数据时,重命名操作不可用。
对于 Junos XML 标记元素, rename inactive active 属性可以与 或 属性相结合,在重命名配置元素时停用或重新激活。有关详细信息,请参阅 使用默认 XML 协议同时更改配置元素的激活Junos 状态。
以下示例显示如何将access-controlnew-access-control防火墙过滤器的名称从更改为使用 Junos XML 标记元素。此操作等同于以下配置模式命令:
[edit firewall family inet] user@host# rename filter access-control to filter new-access-control
以下示例显示如何将防火墙access-controlnew-access-control过滤器的名称从更改为使用配置模式命令:
<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>
以下示例显示如何将 虚拟链路的标识符OSPF 更改为 [edit protocols ospf area area] 和 ,在 层次结构级别定义)。 neighbor-id 192.168.0.3 transit-area 10.10.10.1 neighbor-id 192.168.0.7 transit-area 10.10.10.5此操作等效于以下配置模式命令(仅在两行上显示,只有易读性):
[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
客户端应用程序
<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>
Junos XML 协议服务器
<rpc-reply xmlns:junos="URL">
<load-configuration-results>
<load-success/>
</load-configuration-results>
</rpc-reply>