Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

NETCONF を使用して受験者の構成をロックおよびロック解除

クライアント アプリケーションは、設定情報を要求または変更する際、以下のいずれかの方法で受験者の構成にアクセスできます。

  • 候補設定をロックします。これは、アプリケーションがロックをリリースするまで、他のユーザーやアプリケーションが共有設定データベースを変更できません。これは、 CLI コマンドに相当 configure exclusive します。

  • ロックせずに、受験者の構成を変更します。この方法は推奨しません。これは、共有設定データベースを同時に編集する他のアプリケーションやユーザーが行った変更と競合する可能性があるためです。

アプリケーションが単に設定情報を要求して変更していない場合、設定をロックする必要はありません。アプリケーションは、すぐに情報の要求を開始できます。ただし、セッション中に返される情報が変更されないという重要な場合は、設定をロックすることが適切です。

受験者の設定のロックとロック解除の詳細については、以下のセクションを参照してください。

受験者の設定のロック

候補構成をロックするには、クライアント アプリケーションがタグ要素とタグ要素を <lock> <target> <candidate/> <rpc> 送信します。

候補構成をロックすると、他のユーザーやアプリケーションで、ロックがリリースされるまで、受験者の構成は変更されません。これは、 CLI コマンドに相当 configure exclusive します。特に、複数のユーザーに設定の変更が承認されたデバイスでは、変更を行う前に設定をロックするのをお勧めします。コミット操作は、コミットを要求したユーザーまたはアプリケーションによる変更ではなく、受験者の設定のすべての変更に適用されます。複数のユーザーやアプリケーションで同時に変更を行える場合、予期しない結果が生じる可能性があります。

NETCONF サーバーは、タグ要素内のタグを返して、受験者をロック <ok/> したと <rpc-reply> 確認します。

NETCONF サーバーで設定をロックできない場合は、タグ要素は失敗の理由を示すタグ要素 <rpc-reply> <rpc-error> を囲み込きます。この障害が発生した理由には、以下が含まれます。

一度に受験者の構成をロックできるアプリケーションは 1 つのみです。他のユーザーやアプリケーションは、ロックされている間に受験者の構成を読み取る可能性があります。受験者の設定のロック解除 で説明されているとおり、NETCONF セッションが終了するか、クライアント アプリケーションがタグ要素を変更して設定のロックを解除するまで、ロックは <unlock> 継続します

受験者の設定がクライアント アプリケーションのロックを解除する前にコミットされていない場合、または変更がコミットされる前に何らかの理由で NETCONF セッションが終了した場合、変更は自動的に破棄されます。受験者とコミットされた設定には変更はありません。

受験者の設定のロックを解除する

クライアント アプリケーションが受験者の設定をロックしている限り、他のアプリケーションやユーザーは受験者を変更できません。受験者の設定をロック解除するには、クライアント アプリケーションで <unlock> 、 と <target> タグの要素とタグがタグ <candidate/> 要素 <rpc> に含まれます。

NETCONF サーバーは、タグ要素からタグを返して、受験者のロックが解除 <ok/> されたと <rpc-reply> 確認します。

NETCONF サーバーで設定のロックを解除できない場合は、タグ要素が失敗の理由を示すタグ要素を <rpc-reply> <rpc-error> 囲います。