解析 Junos XML 协议服务器响应
在 Junos Junos OS XML 协议会话中,客户端应用程序将 RPC 发送到 Junos XML 协议服务器,以向设备上请求信息并管理配置。该Junos XML 协议服务器将对于每个客户端请求的响应括在一对单独的开始标记 <rpc-reply>
和结束 </rpc-reply>
标记中。每个响应都构成一个格式良好的 XML 文档。
<rpc-reply xmlns:junos=""http://xml.juniper.net/junos/release/junos""> <!-- tag elements representing a response --> </rpc-reply>
开放标记中的属性定义了由前缀限定的Junos xmlns:junos
<rpc-reply>
XML 标记元素的默认 junos:
命名空间。URI 中的变量表示Junos OS XML 协议服务器设备上运行Junos版本,例如 release 20.4R1
标记 <rpc-reply>
元素仅在元素 <junoscript>
中发生。客户端应用程序必须包括用于解析来自 Junos XML 协议服务器的响应标记元素流的代码,可以在到达时处理它们,或者存储它们直到响应完成。Junos XML 协议服务器返回三类响应:
运营响应
操作响应 是响应有关交换、路由或安全平台状态的信息请求。它们与来自以下操作命令CLI对应。
标准Junos XML API 定义所有已定义操作请求标记元素的响应标记元素。例如,Junos XML 协议服务器在名为 的响应标记中返回标记请求的信息,并返回响应标记中标记 <get-interface-information>
<interface-information>
<get-chassis-inventory>
<chassis-inventory>
请求的信息 <chassis-inventory>
。操作响应也可以格式的 ASCII(包含于元素内)或 output
JSON 格式返回。有关对操作响应进行格式化的信息,请参阅 指定操作信息请求的输出格式 Junos XML 协议会话中。
以下示例响应包括有关接口 ge-2/3/0 的信息。由开放标记中的属性指示的名称空间包含第 xmlns
<interface-information>
20.4 Junos OS个接口信息。
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/20.4R1/junos"> <interface-information xmlns="http://xml.juniper.net/junos/20.4R1/junos-interface"> <physical-interface> <name>ge-2/3/0</name> <!-- other data tag elements for the ge-2/3/0 interface --> </physical-interface> </interface-information> </rpc-reply>
有关操作响应标记元素的属性和内容详细信息,请参阅 使用 Junos xmlns
XML 协议请求操作信息。有关操作响应标记元素的摘要,请参阅 Junos XML API 操作开发人员参考。
配置信息响应
配置信息 响应是响应有关设备当前配置的信息请求。Junos XML API 为配置层次结构中每个容器和叶语句定义标记元素。您可以指示服务器返回不同格式的配置数据,包括 Junos XML 元素、格式化的 ASCII、Junos OS 命令 set
或 JSON。如果没有指定格式,则默认为 XML。有关对配置信息响应进行格式化的信息,请参阅 在 Junos XML 协议会话中指定 配置数据的输出格式。
以下示例响应包括配置层次结构 [edit system login]
中层级的信息。为简洁起见,示例仅显示在此级别定义的一个用户。
<rpc-reply xmlns:junos="URL"> <configuration> <system> <login> <user> <name>admin</name> <full-name>Administrator</full-name> <!-- other data tag elements for the admin user --> </user> </login> </system> </configuration> </rpc-reply>
配置更改响应
配置更改 响应是响应更改设备配置状态或内容的请求。对于提交操作,Junos XML 协议服务器返回响应标记,其中包含成功或失败 <commit-results>
显式指示。
<rpc-reply xmlns:junos="URL"> <commit-results> <!-- tag elements for information about the commit --> </commit-results> </rpc-reply>
对于其他操作,Junos XML 协议服务器没有发出显式成功指示,而是通过返回没有子元素的开始标记和结束标记来 <rpc-reply>
</rpc-reply>
表示成功。
<rpc-reply xmlns:junos="URL"> </rpc-reply>
有关详细信息,请参阅 使用 Junos XML 协议请求配置更改 和 使用 Junos XML 协议提交候选 配置。有关可用配置标记元素的摘要,请参阅 Junos XML API 配置开发人员参考。