使用 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 格式的数据。