使用 Junos XML 协议请求配置更改
在运行 Junos OS 设备的 Junos XML 协议会话中,您可以使用 Junos XML 协议操作以及 Junos XML、命令行界面 (CLI) 配置语句、命令或 JSON 数据来更改路由、交换或安全平台上的配置。 set
Junos XML 协议操作及其属性提供的功能类似于多云中的配置模式 <load-configuration>
Junos OS CLI。此处Junos XML 标记元素对应于配置语句,配置指南中介绍了Junos OS语句。
要更改运行 Junos OS 的设备上的配置,客户端应用程序将执行以下部分中介绍的过程:
建立与路由、交换或安全平台上的 Junos XML 协议服务器的连接,如 连接到 Junos XML 协议服务器 中所述。
启动一Junos XML 协议会话,如"启动 Junos XML 协议会话"中所述。
可选择锁定候选配置、创建候选配置的专用副本或打开临时配置数据库实例。
锁定配置可以防止其他用户或应用程序同时更改配置。创建专用副本使应用程序进行更改不会影响候选配置,直到提交副本。有关详细信息,请参阅 使用默认 XML 协议锁定和解锁候选配置或创建 Junos副本。
有关临时配置数据库的信息,请参阅 了解临时配置数据库以及启用和配置临时配置数据库的实例。
将标记
<load-configuration>
元素括在标记<rpc>
元素中。通过将各种属性包括到标记中,应用程序可以提供在文件中或作为直接加载的标记流中的配置数据,以及作为 Junos XML 标记元素、格式化<load-configuration>
的 ASCII 文本、JSON 格式的数据或 Junos OS 配置模式命令。set
客户端应用程序可指定配置数据完全取代现有候选配置,或者应用程序可指定 Junos XML 协议服务器将数据加载至临时配置数据库的现有候选配置、私有副本或开放实例的方式。基本语法如下所示:<rpc> <!-- If providing configuration data in a file --> <load-configuration url="file" [optional attributes] /> <!-- If providing configuration data in a data stream --> <load-configuration [optional attributes] > <!-- configuration data --> </load-configuration> </rpc>
接受 Junos XML 协议服务器响应每个请求时发出的标记流,并提取其内容,如 解析 Junos XML 协议服务器响应 中所述。
该Junos XML 协议服务器通过返回标记元素中的标记元素和标记,确认已纳入
<load-configuration-results>
<load-success/>
<rpc-reply>
配置数据:<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-success/> </load-configuration-results> </rpc-reply>
如果负载操作失败,
<load-configuration-results>
标记元素将括住标记元素<load-error-count>
,表示发生的错误数。在这种情况下,应用程序或管理员提交配置前必须消除错误。<rpc-reply xmlns:junos="URL"> <load-configuration-results> <load-error-count>count</load-error-count> </load-configuration-results> </rpc-reply>
(可选)在尝试提交之前验证候选配置或私有副本的语法正确性,如 使用 Junos XML 协议 验证配置语法 中所述。
提交对候选配置或私有副本进行更改(如 使用 Junos XML协议提交候选配置 中所述,或提交对临时配置数据库的开放实例进行更改,如 使用 NETCONF或 Junos XML 协议提交和同步临时配置数据中所述。
如果候选配置锁定,则解锁,或关闭配置或临时配置数据库的开放实例的专用副本。
其他用户和应用程序在保持锁定期间不能更改配置。有关详细信息,请参阅 使用默认 XML 协议锁定和解锁候选配置或 创建Junos副本。
结束 Junos XML 协议会话并关闭设备连接,如"结束 Junos XML 协议会话和关闭 连接 "中所述。