使用 NETCONF 检索救援配置
救援配置是在需要恢复有效的非默认配置时保存的配置。(要在 NETCONF 会话中创建救援配置,请使用 Junos XML <request-save-rescue-configuration>
标记元素或 request system configuration rescue save
CLI 操作模式命令。有关详细信息,请参阅 Junos XML API 操作开发人员参考 或 CLI 资源管理器。)
在与运行 Junos OS 的设备的 NETCONF 会话中,客户端应用程序通过在标记元素中<rpc>
发出 Junos XML <get-rescue-information>
标记元素来请求救援配置。此操作等效于show system configuration rescue
操作模式命令。
要请求 Junos XML 标记的输出,应用程序要么包含 <format>
带有值 xml
的标记元素,要么省 <format>
略标记元素(默认为 Junos XML 标记元素):
<rpc> <get-rescue-information/> </rpc> ]]>]]>
NETCONF 服务器将其响应括在 、 <rescue-information>
和<configuration>
标记元素中<rpc-reply>
。标记<ok/>
是实现的副作用,不会影响结果。有关开始<configuration>
标记中的属性的信息,请参阅使用 NETCONF 指定配置信息请求的源。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <rescue-information> <ok/> <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> ]]>]]>
NETCONF 服务器将其响应括在 、 <rescue-information>
、 <configuration-information>
和<configuration-output>
标记元素中<rpc-reply>
。有关 Junos OS 配置语句中使用的格式化 ASCII 表示法的详细信息,请参阅 CLI 用户指南。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <rescue-information> <ok/> <configuration-information> <configuration-output> /* formatted ASCII for the rescue configuration*/ </configuration-output> </configuration-information> </rescue-information> </rpc-reply> ]]>]]>
从 Junos OS 16.1 版开始,要请求 JSON 格式的救援配置,应用程序需要包含<format>
标记元素和元素中的<get-rescue-information>
值json
。在 Junos OS 16.1 版之前,通过在开始<get-rescue-information>
标记中包含属性来format="json"
请求 JSON 格式的数据。
<rpc> <get-rescue-information> <format>json</format> </get-rescue-information> </rpc> ]]>]]>
使用该format="json"
属性指定格式时,NETCONF 服务器将其响应括在一个元素中<rpc-reply>
,顶级 JSON 成员的字段名称为 "rescue-information"
,并且发出的配置数据使用较旧的实现进行序列化。使用该元素请求 <format>json</format>
JSON 格式的数据时,NETCONF 服务器会将其响应括在 、 <rescue-information>
和 <configuration-information>
<json-output>
标记元素中<rpc-reply>
,顶级 JSON 成员的字段名称为 "configuration"
,发出的配置数据使用较新的实现进行序列化。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <rescue-information> <ok/> <configuration-information> <json-output> { "configuration" : { <!-- JSON data representing the rescue configuration --> } } </json-output> </configuration-information> </rescue-information> </rpc-reply> ]]>]]>
<format>
标记元素和元素中的
<get-rescue-information>
值
json
。在 Junos OS 16.1 版之前,通过在开始
<get-rescue-information>
标记中包含属性来
format="json"
请求 JSON 格式的数据。