使用 Junos XML 协议检索救援配置
援救配置是保存的配置,以防有必要恢复有效、非默示的配置。(要创建救援配置,请使用 Junos XML 协议会话中的 Junos XML <request-save-rescue-configuration>
标记元素或 request system configuration rescue save
CLI 中的操作模式命令。有关更多信息,请参阅 Junos XML API 操作开发人员参考 或 CLI Explorer。)
在与运行 Junos OS 的设备的 Junos XML 协议会话中,客户端应用程序通过在元素<rpc>
中发出 Junos XML <get-rescue-information>
标记元素来请求救援配置。此操作等同于show system configuration rescue
操作模式命令。
要请求 Junos XML 标记的输出,应用程序要么包含 <format>
带有值 xml
的标记元素,要么省略 <format>
标记元素(默认情况下为 Junos XML 输出):
<rpc> <get-rescue-information/> </rpc>
Junos XML 协议服务器在 和 标记元素中<rpc-reply>
<rescue-information>
<configuration>
括起其响应。标记<load-success/>
是实施的副作用,不会影响结果。有关打开<configuration>
标记中的属性的信息,请参阅 在 Junos XML 协议会话中指定配置信息请求的来源。
<rpc-reply xmlns:junos="URL"> <rescue-information> <load-success/> <configuration attributes> <!-- tag elements representing the rescue configuration --> </configuration> </rescue-information> </rpc-reply>
要请求格式化的 ASCII 输出,应用程序包括 <format>
带有该值 text
的标记元素。
<rpc> <get-rescue-information> <format>text</format> </get-rescue-information> </rpc>
Junos XML 协议服务器随附了其响应 <rpc-reply>
、 <rescue-information>
、 <configuration-information>
和 <configuration-output>
标记元素。有关 Junos OS 配置语句中使用的格式化 ASCII 符号的详细信息,请参阅 在 Junos XML 协议会话中指定配置数据的输出格式。
<rpc-reply xmlns:junos="URL"> <rescue-information> <load-success/> <configuration-information> <configuration-output> <!-- formatted ASCII text representing the rescue configuration --> </configuration-output> </configuration-information> </rescue-information> </rpc-reply>
从 Junos OS 16.1 版开始,为了以 JSON 格式请求救援配置,应用程序包括 <format>
带有该元素值 json
的 <get-rescue-information>
标记元素。在 Junos OS 16.1 版之前,需要将属性包括 format="json"
在开口 <get-rescue-information>
标记中,从而请求 JSON 格式的数据。
<rpc> <get-rescue-information> <format>json</format> </get-rescue-information> </rpc>
当您使用format="json"
属性来指定格式时,Junos XML 协议服务器会将其响应括在一个<rpc-reply>
元素中,顶级 JSON 成员的字段名称为 "rescue-information"
, 而发出的配置数据则使用较旧的实施进行序列化。当您使用该<format>json</format>
元素请求 JSON 格式化的数据时,Junos XML 协议服务器会将响应包含在 、 <rescue-information>
、 <configuration-information>
和<json-output>
标记元素中<rpc-reply>
,顶级 JSON 成员的字段名称为 "configuration"
, 且发出的配置数据使用较新的实施来实现序列化。
<rpc-reply xmlns:junos="URL"> <rescue-information> <load-success/> <configuration-information> <json-output> { "configuration" : { <!-- JSON data representing the rescue configuration --> } } </json-output> </configuration-information> </rescue-information> </rpc-reply>
<format>
带有该元素值
json
的
<get-rescue-information>
标记元素。