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/>します。 |