处理 Junos XML 协议会话中的错误或警告
在与运行 Junos OS 的设备进行 Junos XML 协议会话中,客户端应用程序会将 RPC 发送至 Junos XML 协议服务器,以向该设备请求信息并管理设备上的配置。Junos XML 协议服务器会为每个客户端请求发送一个响应。如果服务器遇到错误情况,将发出包含 <xnm:error>
描述错误的子元素的元素。
元素的 <xnm:error>
语法如下所示:
<xnm:error xmlns="http://xml.juniper.net/xnm/1.1/xnm" \ xmlns:xnm="http://xml.juniper.net/xnm/1.1/xnm"> <!-- tag elements describing the error --> </xnm:error>
属性如下所示:
xmlns
-名称中没有前缀的<xnm:error>
子标记元素的 XML 命名空间(即 Junos XML 标记元素的默认命名空间)。值是表单http://xml.juniper.net/xnm/version/xnm
的 URL,其中 version 表示 1.1 等字符串。xmlns:xnm
-标记元素和子标记元素的 XML 命名空间<xnm:error>
,其名称中具有xnm:
前缀。值是表单http://xml.juniper.net/xnm/version/xnm
的 URL,其中 version 表示 1.1 等字符串。
元素中 <xnm:error>
封装的子标记集取决于发生错误时服务器执行的操作。服务器在执行以下任一操作时都可能发生错误,服务器可以在每种情况下发送不同的子标记元素组合:
处理客户端应用程序提交的操作请求
根据客户端应用的要求打开、锁定、更改、提交或关闭配置
解析标记元素中
<load-configuration>
客户端应用提交的配置数据
客户端应用程序必须做好随时接收和处理 <xnm:error>
标记的准备。已收到的任何响应标记元素中与当前请求相关的信息可能不完整。客户端应用程序 可以包含用于决定丢弃还是保留 信息的逻辑。
如果 Junos XML 协议服务器遇到不太严重的问题,它可以改为发出标记 <xnm:warning>
元素。在这种情况下,客户端应用的通常响应是记录警告或将其传递给用户并继续解析服务器的响应。