NETCONF を使用して受験者の構成をコミットする
Junos OS を実行しているデバイスで受験者の設定をコミットすると、ルーティング、スイッチング、またはセキュリティ プラットフォーム上のアクティブな設定になります。コミット操作の詳細については、操作のさまざまなバリエーション間の相互作用の説明を含む、 CLI ユーザー ガイドを参照してください。
Junos OS を実行しているデバイスとの NETCONF セッションで、候補の設定をコミットする場合、クライアント アプリケーションはタグをタグ要素で<rpc>
囲みます<commit/>
。
<rpc> <commit/> </rpc> ]]>]]>
クライアント アプリケーションは、変更する前に候補の設定をロックし、設定がまだ <commit/>
ロックされている間にタグを発行することをお勧めします。このプロセスは、他のユーザーやアプリケーションによる変更をうっかりコミットするのを回避します。設定をコミットした後、他のユーザーやアプリケーションが変更を加えるためにアプリケーションのロックを解除する必要があります。
NETCONF サーバーは、タグ要素の<rpc-reply>
タグを返<ok/>
すことで、コミット操作が成功したことを確認します。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <ok/> </rpc-reply> ]]>]]>
コミット操作が失敗した場合、サーバーはエラーの理由を <rpc-reply>
説明する要素と <rpc-error>
子要素を返します。最も一般的な原因は、候補構成のセマンティック エラーまたは構文エラーです。
ステートメントを rfc-compliant
階層レベルで [edit system services netconf]
設定して、NETCONF サーバーによる特定の動作(操作に対する NETCONF サーバーの応答の変更を含む)を <commit>
適用できます。 表 1 は、RFC 準拠セッションの変更を示しています。
COMMIT RPC Response | Default Response | RFC-Compliant Session Response |
---|---|---|
操作が成功すると <commit> 、警告を含む応答が返されます。 |
NETCONF サーバーは、要素を <ok/> 返し、重大度レベルの警告を持つ 1 つ以上 <rpc-error> の要素を返すことができます。 |
Junos OS リリース 17.4R3、18.2R2、18.3R2、18.4R1 以降、NETCONF サーバーはエレメントを <ok/> 返しますが、警告は省略します。Junos OS リリース 21.2R1 以降では、警告もシステム ログ ファイルにリダイレクトされます。 |
操作応答は <commit> 、要素を <rpc-error> 含む要素を <source-daemon> 返します。 |
NETCONF サーバー応答は、の <source-daemon> 子 <rpc-error> として要素を発行します。 |
Junos OS リリース 21.2R1 以降、NETCONF サーバー応答は、 の子<error-info> としてエレメントを発行<source-daemon> します。 |
<commit> 操作応答には要素が<commit-results> 含まれます。 |
NETCONF サーバーには、<commit-results> 要素または<rpc-error> 子要素に加えて XML サブツリーが<ok/> 含まれています。 |
また、ステートメントをflatten-commit-results 階層レベルで[edit system services netconf] 構成すると、NETCONF サーバーは XML サブツリーを<commit-results> 抑制し、応答でまたは<rpc-error> 要素のみを発行<ok/> します。 |