使用 NETCONF 提交候选配置
在运行 Junos OS 的设备上提交候选配置时,该配置将成为路由、交换或安全平台上的活动配置。有关提交操作的详细信息(包括讨论操作的不同变体之间的交互),请参阅 CLI 用户指南。
在与运行 Junos OS 的设备的 NETCONF 会话中提交候选配置时,客户端应用程序将标记括 <commit/>
在标记元素中 <rpc>
。
<rpc> <commit/> </rpc> ]]>]]>
建议客户端应用程序在修改前锁定候选配置,并在配置仍然锁定时发出 <commit/>
标记。此过程可避免无意中提交其他用户或应用程序做出的更改。提交配置后,应用程序必须将其解锁,以便其他用户和应用程序进行更改。
NETCONF 服务器通过返回 <ok/>
标记元素中的 <rpc-reply>
标记来确认提交操作成功。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <ok/> </rpc-reply> ]]>]]>
如果提交操作失败,服务器将返回 <rpc-reply>
元素和 <rpc-error>
子元素,这解释了故障的原因。最常见的原因是候选配置中的语义或语法错误。
您可以在[edit system services netconf]
层级配置rfc-compliant
语句,以便由 NETCONF 服务器实施某些行为,包括 NETCONF 服务器对<commit>
操作的响应更改。表 1 介绍了符合 RFC 的会话的更改。
提交 RPC 响应 | 默认响应 | RFC 兼容会话响应 |
---|---|---|
一次成功的 <commit> 操作会返回一个带有警告的响应。 |
NETCONF 服务器返回一个 <ok/> 元素,还可返回一个或多个 <rpc-error> 具有严重性级别警告的元素。 |
从 Junos OS 17.4R3、18.2R2、18.3R2 和 18.4R1 版开始,NETCONF 服务器将返回一个 <ok/> 元素,但省略任何警告。在 Junos OS 版本 21.2R1 和更高版本中,警告也重定向到系统日志文件。 |
<commit> 操作响应返回包含<rpc-error> 元素的<source-daemon> 元素。 |
NETCONF 服务器响应会在其中<rpc-error> 发出<source-daemon> 该元素。 |
从 Junos OS 21.2R1 版开始,NETCONF 服务器响应会在其中发出 <source-daemon> 该元素 <error-info> 。 |
<commit> 操作响应包含一个<commit-results> 元素。 |
NETCONF 服务器除了一个<ok/> 元素或<rpc-error> 子元素外,还包括 <commit-results> XML 子树。 |
如果还在层次结构级别上配置flatten-commit-results 语句[edit system services netconf] ,则 NETCONF 服务器会<commit-results> 抑制 XML 子树,并在其响应中仅发出或<rpc-error> 元素<ok/> 。 |