XML プロトコルを使用した受験者設定のロック、ロック解除、Junos作成
クライアント アプリケーションは、設定情報を要求または変更する際、以下のいずれかの方法で受験者の構成にアクセスできます。
候補設定をロックします。これは、アプリケーションがロックをリリースするまで(CLI コマンドに相当)、他のユーザーやアプリケーションが共有設定データベースを変更CLI
configure exclusiveします。候補構成のプライベート コピーを作成します。これにより、プライベート コピーがコミットされるまで(CLI コマンドに相当)、受験者またはアクティブな設定に影響を与えなくても、アプリケーションは設定データを表示または変更できます
configure private。ロックせずに、受験者の構成を変更します。この方法は推奨しません。これは、共有設定データベースを同時に編集する他のアプリケーションやユーザーが行った変更と競合する可能性があるためです。
アプリケーションが単に設定情報を要求して変更していない場合は、設定のロックやプライベート コピーの作成は必要ありません。アプリケーションは、すぐに情報の要求を開始できます。ただし、セッション中に返される情報が変更されないという重要な場合は、設定をロックすることが適切です。プライベート コピーからの情報は変更されませんが、他のユーザーやアプリケーションが受験者の設定を変更している場合は、受験者の設定から転用する可能性があります。
ロックされた通常の受験者設定およびプライベート コピーに対する操作の制限および操作は、CLIやコマンドの configure exclusive 場合と同 configure private じです。詳細については、「 Junos XML プロトコルを使用した設定のプライベート コピーのコミット 」および「 CLI ガイド 」 を参照してください。
受験者の設定のロックとロック解除、プライベート コピーの作成の詳細については、以下のセクションを参照してください。
受験者の設定のロック
受験者の設定をロックするには、クライアント アプリケーションがタグ内 <lock-configuration/> でタグを送信 <rpc> します。
<rpc>
<lock-configuration/>
</rpc>
候補構成をロックすると、他のユーザーやアプリケーションで、ロックがリリースされるまで、受験者の構成は変更されません。これは、 CLI コマンドに相当 configure exclusive します。特に、複数のユーザーに設定の変更が承認されたデバイスでは、変更を行う前に設定をロックするのをお勧めします。コミット操作は、コミットを要求したユーザーまたはアプリケーションによる変更ではなく、受験者の設定のすべての変更に適用されます。複数のユーザーやアプリケーションで同時に変更を行える場合、予期しない結果が生じる可能性があります。
XML プロトコルJunos、その間に何も付けなかった開始タグと終了タグを返して、受験者の設定がロックされた <rpc-reply> </rpc-reply> と確認します。
<rpc-reply xmlns:junos="URL"> </rpc-reply>
XML プロトコル Junosサーバーが設定をロックできない場合は、タグは失敗の理由を示す要素 <rpc-reply> <xnm:error> を囲む代わりにします。この障害が発生した理由には、以下が含まれます。
別のユーザーまたはアプリケーションがすでに受験者の構成をロック済みです。このエラー メッセージは、ユーザーまたはアプリケーションのログイン ID を報告します。
受験者の設定には、まだコミットされていない変更も含まれています。変更をコミットするには、 XMLプロトコルを使用した受験者設定Junosを参照してください。コミットされていない変更を破棄するには、 XML プロトコルを使用した設定のJunosを参照してください。
一度に受験者の構成をロックできるアプリケーションは 1 つのみです。他のユーザーやアプリケーションは、ロックされている間に受験者の構成を読み取る、または自分のプライベート コピーを変更できます。「受験者の設定のロックとロック解除」または <unlock-configuration/> 「Junos XMLプロトコルを使用したプライベート コピーの作成 」で説明されているとおり、Junos XMLプロトコル セッションが終了するか、クライアント アプリケーションがタグによって設定をロック解除するまで、ロックは保持されます。
クライアント アプリケーションのロックを解除する前に、または変更をコミットする前に何らかの理由で Junos XML プロトコル セッションが終了した場合、その変更は自動的に破棄されます。受験者とコミットされた設定には変更はありません。
受験者の設定のロックを解除する
クライアント アプリケーションが受験者の設定をロックしている限り、他のアプリケーションやユーザーは受験者を変更できません。受験者の設定をロック解除するには、クライアント アプリケーションに <unlock-configuration/> タグがタグに含 <rpc> まれます。
<rpc>
<unlock-configuration/>
</rpc>
XML プロトコル Junosサーバーは、開始タグと終了タグを間に何も返して、設定のロックが正常に解除されたことを <rpc-reply> </rpc-reply> 確認します。
<rpc-reply xmlns:junos="URL"> </rpc-reply>
XML プロトコル Junosサーバーが設定のロックを解除できない場合は、タグは失敗の理由を示す要素 <rpc-reply> <xnm:error> を囲む必要があります。
設定のプライベート コピーの作成
受験者の設定のプライベート コピーを作成するために、クライアント アプリケーションは、内に囲まれたタグ <private/> とタグを <rpc> 送信 <open-configuration> します。
<rpc>
<open-configuration>
<private/>
</open-configuration>
</rpc>
次に、クライアント アプリケーションは、通常の受験者の設定と同じ操作をプライベート コピーで実行できます。
プライベート コピーを変更した後、通常の受験者の設定に関して、Junos OS を実行しているデバイスでアクティブな設定への変更をコミットできます <commit-configuration> 。しかし、プライベート コピーのコミット操作にはいくつかの制限があります。詳細については、「 xml プロトコルを使用した設定のプライベート コピーのJunos する 」を参照してください。
プライベート コピーをコミットせずに破棄するには、クライアント アプリケーションがタグ要素に囲 <close-configuration/> まれたタグを <rpc> 送信します。
<rpc>
<close-configuration/>
</rpc>
プライベート コピーに対する変更は失われます。プライベート コピーへの変更は、XML プロトコル セッションのJunosがコミットされる前に何らかの理由で終了した場合にも失われます。タグ要素を使用しないプライベート コピーへの変更を保存 <commit-configuration> はできません。
Junos OS リリース 18.2R1から、Junos XML プロトコル操作は、受験者設定のプライベート コピーを開く際に「」警告メッセージを <open-configuration> uncommitted changes will be discarded on exit 送信しない。ただし、Junos OSを閉じると、未コミットの変更は破棄されます。
次の例は、設定のプライベート コピーを作成する方法を示しています。XML Junosサーバーに含まれる通知には、セッション終了前に変更がコミットされていない場合、プライベートコピーから変更が破棄されるという確認応答があります。
