このページでは
NETCONF を使用して受験者の構成をロックおよびロック解除
クライアント アプリケーションは、設定情報を要求または変更する際、以下のいずれかの方法で受験者の構成にアクセスできます。
候補設定をロックします。これは、アプリケーションがロックをリリースするまで、他のユーザーやアプリケーションが共有設定データベースを変更できません。これは、 CLI コマンドに相当
configure exclusive
します。ロックせずに、受験者の構成を変更します。この方法は推奨しません。これは、共有設定データベースを同時に編集する他のアプリケーションやユーザーが行った変更と競合する可能性があるためです。
アプリケーションが単に設定情報を要求して変更していない場合、設定をロックする必要はありません。アプリケーションは、すぐに情報の要求を開始できます。ただし、セッション中に返される情報が変更されないという重要な場合は、設定をロックすることが適切です。
受験者の設定のロックとロック解除の詳細については、以下のセクションを参照してください。
受験者の設定のロック
候補構成をロックするには、クライアント アプリケーションがタグ要素とタグ要素を <lock>
<target>
<candidate/>
<rpc>
送信します。
<rpc> <lock> <target> <candidate/> </target> </lock> </rpc> ]]>]]>
候補構成をロックすると、他のユーザーやアプリケーションで、ロックがリリースされるまで、受験者の構成は変更されません。これは、 CLI コマンドに相当 configure exclusive
します。特に、複数のユーザーに設定の変更が承認されたデバイスでは、変更を行う前に設定をロックするのをお勧めします。コミット操作は、コミットを要求したユーザーまたはアプリケーションによる変更ではなく、受験者の設定のすべての変更に適用されます。複数のユーザーやアプリケーションで同時に変更を行える場合、予期しない結果が生じる可能性があります。
NETCONF サーバーは、タグ要素内のタグを返して、受験者をロック <ok/>
したと <rpc-reply>
確認します。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <ok/> </rpc-reply> ]]>]]>
NETCONF サーバーで設定をロックできない場合は、タグ要素は失敗の理由を示すタグ要素 <rpc-reply>
<rpc-error>
を囲み込きます。この障害が発生した理由には、以下が含まれます。
別のユーザーまたはアプリケーションがすでに受験者の構成をロック済みです。このエラー メッセージは、ユーザーまたはアプリケーションの NETCONF セッション識別子を報告します。クライアント アプリケーションに必要なアクセス権限Junos OS、ロックを保持するセッションを終了できます。詳細については、「 NETCONF セッションの終了 」を参照してください。
受験者の設定には、まだコミットされていない変更も含まれています。変更をコミットするには、「 NETCONF を使用して受験者の設定をコミットする 」を参照してください。コミットされていない変更を破棄するには、「 NETCONF を使用した受験者設定でのコミットされていない変更のロール バック 」を参照してください。
一度に受験者の構成をロックできるアプリケーションは 1 つのみです。他のユーザーやアプリケーションは、ロックされている間に受験者の構成を読み取る可能性があります。受験者の設定のロック解除 で説明されているとおり、NETCONF セッションが終了するか、クライアント アプリケーションがタグ要素を変更して設定のロックを解除するまで、ロックは <unlock>
継続します。
受験者の設定がクライアント アプリケーションのロックを解除する前にコミットされていない場合、または変更がコミットされる前に何らかの理由で NETCONF セッションが終了した場合、変更は自動的に破棄されます。受験者とコミットされた設定には変更はありません。
受験者の設定のロックを解除する
クライアント アプリケーションが受験者の設定をロックしている限り、他のアプリケーションやユーザーは受験者を変更できません。受験者の設定をロック解除するには、クライアント アプリケーションで <unlock>
、 と <target>
タグの要素とタグがタグ <candidate/>
要素 <rpc>
に含まれます。
<rpc> <unlock> <target> <candidate/> </target> </unlock> </rpc> ]]>]]>
NETCONF サーバーは、タグ要素からタグを返して、受験者のロックが解除 <ok/>
されたと <rpc-reply>
確認します。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <ok/> </rpc-reply> ]]>]]>
NETCONF サーバーで設定のロックを解除できない場合は、タグ要素が失敗の理由を示すタグ要素を <rpc-reply>
<rpc-error>
囲います。