Junos XMLプロトコルセッションの設定情報リクエストのソースを指定する
Junos OSを実行しているデバイスとのJunos XMLプロトコルセッションでは、クライアントアプリケーションはタグ要素を <get-configuration> 使用してデバイスから設定データを要求します。クライアント・アプリケーションは、候補構成、アクティブ構成 (つまり、デバイス上で最後にコミットされた構成)、または一時的な構成データベースのオープン・インスタンスから情報を要求できます。
クライアント アプリケーションは、属性を適切な値に設定 database することで、候補構成またはアクティブな構成のいずれかから構成情報を返すようにデバイスに指示できます。候補構成に情報を要求するには、クライアント アプリケーションにタグ要素が <get-configuration> 含まれており、属性が database="candidate" 含まれるか、属性を完全に省略します。Junos XML プロトコル サーバーは、属性が含まれている場合を除き、デフォルトで Junos XML タグ付き出力を compare 返します。
<rpc>
<get-configuration/>
<!-- OR -->
<get-configuration>
<!-- tag elements for the configuration elements to return -->
</get-configuration>
</rpc>
アクティブな構成から情報を要求するために、クライアント アプリケーションには、 要素内で <get-configuration> 囲まれた属性を database="committed" 持つタグ要素が <rpc> 含まれています。
<rpc>
<get-configuration database="committed"/>
<!-- OR -->
<get-configuration database="committed">
<!-- tag elements for the configuration elements to return -->
</get-configuration>
</rpc>
タグ要素で囲むタグ要素については、 Junos XMLプロトコルセッションで返す設定データのスコープの指定を参照してください。<get-configuration>
Junos OS リリース 13.1 以降、論理システム ユーザーが 操作を使用して論理システム設定全体を <get-configuration> 要求すると、RPC 応答には root タグが <configuration> 含まれます。Junos OS リリース 13.1 以前は、 <configuration> ルート タグは省略されていました。
一時的な構成データベースの特定のインスタンスから情報を要求するには、クライアント アプリケーションが最初に、適切な子タグを持つ操作を <open-configuration> 使用して一時的なインスタンスを開きます。
<rpc>
<!-- Default instance -->
<open-configuration>
<ephemeral/>
</open-configuration>
<!-- Named instance -->
<open-configuration>
<ephemeral-instance>instance-name</ephemeral-instance>
</open-configuration>
</rpc>
一時的なインスタンスが開いている間、クライアント アプリケーションはその操作を使用して、そのインスタンスからの情報を <get-configuration> 要求します。一時的なインスタンス上のすべての操作が完了すると、クライアント アプリケーションは、操作でインスタンスを <close-configuration/> 閉じます。
<rpc>
<get-configuration/>
<!-- OR -->
<get-configuration>
<!-- tag elements for the configuration elements to return -->
</get-configuration>
</rpc>
<rpc>
<close-configuration/>
</rpc>
Junos XML プロトコル サーバーは、その応答をタグ要素で<rpc-reply>囲みます。<rpc-reply>要素内では、要求された設定の設定データは、Junos XMLタグ付き出力の要素、フォーマットされたASCII出力の要素、<configuration-text>設定モードsetコマンドの要素、<configuration-set>または<configuration-json>JavaScript Object Notation(JSON)で表される設定データの要素内に囲まれます<configuration>。
候補構成または一時的な構成データベースのインスタンスから情報を返す場合、出力には、構成が最後に変更された時間に関する情報が含まれます。設定を Junos XML タグ要素として表示する場合、Junos XML プロトコル サーバーは、この情報を開始 <configuration> タグの属性として含めます(ここでは読みやすさのみを目的として複数行に表示されます)。
<rpc-reply xmlns:junos="URL">
<configuration junos:changed-seconds="seconds" \
junos:changed-localtime="YYYY-MM-DD hh:mm:ss TZ">
<!-- Junos XML tag elements representing configuration elements -->
</configuration>
</rpc-reply>
junos:changed-localtime は、最後に変更された時刻をデバイスのローカルタイムゾーンの日付と時刻で表します。
junos:changed-seconds は、前回の変更時刻を、1970年1月1日の深夜以降の秒数で表しています。
アクティブな設定から情報を返す場合、出力には設定が最後にコミットされた時間に関する情報が含まれます。設定を Junos XML タグ要素として表示する場合、Junos XML プロトコル サーバーは、この情報を開始 <configuration> タグの属性として含めます(ここでは読みやすさのみを目的として複数行に表示されます)。
<rpc-reply xmlns:junos="URL">
<configuration junos:commit-seconds="seconds" \
junos:commit-localtime="YYYY-MM-DD hh:mm:ss TZ" \
junos:commit-user="username">
<!-- Junos XML tag elements representing configuration elements -->
</configuration>
</rpc-reply>
junos:commit-localtime は、コミット時間をデバイスのローカルタイムゾーンの日付と時刻で表します。
junos:commit-seconds は、1970 年 1 月 1 日の深夜以降のコミット時間を秒数で表しています。
junos:commit-user は、コミット操作を要求したユーザーの Junos OS ユーザー名を指定します。
アプリケーションの要求内の属性はdatabase、タグまたは開始<get-configuration>タグに含まれる 1 つ以上の以下の属性<get-configuration/>と組み合わせることができます。
changed:Junos XML プロトコルを使用した構成要素の変更インジケータの要求で説明されています。commit-scriptsは、Junos XMLプロトコルを使用したコミットスクリプトスタイルのXML設定データの要求で説明されています。compare:Junos XML プロトコルを使用したアクティブまたはキャンディデート設定と以前のバージョンの比較で説明されています。formatは、Junos XML プロトコル セッションの設定データの出力形式の指定で説明されています。inheritgroupsおよび および およびinterface-rangesは、 で説明されています。これは、 Junos XMLプロトコルを使用した設定グループの出力形式とインターフェイス範囲の指定に記載されています。
アプリケーションは、識別子の database 指標を要求した後に属性を含めることもできます( Junos XMLプロトコルを使用した構成要素の識別子インジケータの要求で説明されているように)。
次の例では、コミットされた設定全体を要求する方法を示しています。実際の Junos-version 出力では、変数はJunos OSリリース20.4の初期バージョンの20.4R1などの値に置き換えられます。
<get-configuration> 要求すると、RPC 応答には root タグが
<configuration> 含まれます。