使用 NETCONF 检索上一个(回滚)配置
在与运行 Junos OS 的设备进行 NETCONF 会话中,要请求之前提交的(回滚)配置,客户端应用程序会发出标记元素中的 Junos XML <get-rollback-information>
标记元素及其子 <rollback>
标记元素 <rpc>
。此操作等同于 show system rollback
操作模式命令。 <rollback>
标记元素指定要显示的先前配置的索引号;其值可以从 0(对于最近提交的配置而言为零)到 49。
要请求 Junos XML 标记的输出,应用程序要么包括 <format>
带有该值 xml
的标记元素,要么省略 <format>
标记元素(默认为 Junos XML 标记元素):
<rpc> <get-rollback-information> <rollback>index-number</rollback> </get-rollback-information> </rpc> ]]>]]>
NETCONF 服务器将其响应封装在 <rpc-reply>
、 <rollback-information>
中并 <configuration>
标记元素。标记 <ok/>
是实施的副作用,不会影响结果。有关打开 <configuration>
标记中属性的信息,请参阅 使用 NETCONF 指定配置信息请求的源。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <rollback-information> <ok/> <configuration attributes> <!-- tag elements representing the complete previous configuration --> </configuration> </rollback-information> </rpc-reply> ]]>]]>
要请求格式化的 ASCII 输出,应用程序将 <format>
标记元素与值 text
一起。
<rpc> <get-rollback-information> <rollback>index-number</rollback> <format>text</format> </get-rollback-information> </rpc> ]]>]]>
NETCONF 服务器将其响应封装在 、 <rollback-information>
<configuration-information>
和<configuration-output>
标记元素中<rpc-reply>
。有关 Junos OS 配置语句中使用的格式化 ASCII 符号的更多信息,请参阅 CLI 用户指南。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <rollback-information> <ok/> <configuration-information> <configuration-output> /* previous configuration in formatted ASCII*/ </configuration-output> </configuration-information> </rollback-information> </rpc-reply> ]]>]]>
从 Junos OS 16.1 版开始,要请求之前提交的(回滚)JSON 格式配置,应用程序会包含<format>
元素中的<get-rollback-information>
标记元素和值json
。在 Junos OS 16.1 版之前,可以通过format="json"
在开始<get-rollback-information>
标记中包含属性来请求 JSON 格式的数据。
<rpc> <get-rollback-information> <rollback>index-number</rollback> <format>json</format> </get-rollback-information> </rpc> ]]>]]>
使用format="json"
属性指定格式时,NETCONF 服务器将其响应括在元素<rpc-reply>
中,顶级 JSON 成员的字段名称为"rollback-information"
,而发出的配置数据则使用较旧的序列化实现。使用<format>json</format>
元素请求 JSON 格式的数据时,NETCONF 服务器将其响应括在 、 <rollback-information>
<configuration-information>
和<json-output>
标记元素中<rpc-reply>
,顶级 JSON 成员的字段名称为"configuration"
,而发出的配置数据则使用更新的序列化实现。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <rollback-information> <ok/> <configuration-information> <json-output> <!-- JSON data for the complete previous configuration --> </json-output> </configuration-information> </rollback-information> </rpc-reply> ]]>]]>
以下示例说明如何为索引为 2 的回滚配置请求 Junos XML 标记的输出。在实际输出中,该 Junos-version 变量将替换为 20.4R1 等值,用于 Junos OS 20.4 版本的初始版本。
<format>
元素中的
<get-rollback-information>
标记元素和值
json
。在 Junos OS 16.1 版之前,可以通过
format="json"
在开始
<get-rollback-information>
标记中包含属性来请求 JSON 格式的数据。