Junos XML プロトコルを使用して設定データをリクエストする
Junos Junos OS を実行しているデバイスと XML プロトコル セッションを開き、ルーティング、スイッチング、またはセキュリティー プラットフォームの設定データを要求する場合、クライアント アプリケーションは要素をタグで囲います。 <get-configuration> <rpc> オプションの属性を設定することで、クライアント アプリケーションは、XML プロトコル サーバーから返される設定情報の送信元とフォーマットJunos指定できます。適切なオプションの子タグ要素を含め、アプリケーションは設定全体または設定の特定の部分を要求できます。基本的な構文は次のとおりです。
<rpc>
<!-- If requesting the complete configuration -->
<get-configuration [optional attributes]/>
<!-- If requesting part of the configuration -->
<get-configuration [optional attributes]>
<configuration>
<!-- tag elements representing the data to return -->
</configuration>
</get-configuration>
</rpc>
一時的な設定データベースの特定のインスタンスに設定データを表示するには、リクエストを実行する前に、適切な子タグを使用した操作を使用して一時的なインスタンスを開く必要があります <open-configuration> <get-configuration> 。
Junos OS リリース 13.1 から、Junos XML プロトコル セッション内で、論理システム ユーザーは Junos XML プロトコル操作を使用して、子構成タグを使用した特定の論理システム構成階層を要求し、論理システム設定全体を要求できます。 <get-configuration> 論理システム設定全体を要求する場合、RPC 応答にはルート タグ <configuration> が含まれます。リリース 13.1 Junos OSの前には、 <configuration> ルート タグが除外されました。
XML プロトコル Junosは、その応答をタグ要素で <rpc-reply> 囲み込む必要があります。これには、設定が最後に変更またはコミットされた日を示す先頭にプレフィックスが付いた属性と、それをコミットしたユーザーが含まれます(属性は、読み取れるのために構文ステートメントの複数行に表示されます junos: <configuration> )。属性の詳細については、 XMLプロトコル セッションでの設定情報リクエストの送信元の指定 Junos を参照してください。
<rpc-reply xmlns:junos="URL">
<!-- If the application requests Junos XML tag elements -->
<configuration junos:(changed | commit)-seconds="seconds" \
junos:(changed | commit)-localtime="YYYY-MM-DD hh:mm:ss TZ" \
[junos:commit-user="username"]>
<!-- Junos XML tag elements representing configuration elements -->
</configuration>
<!-- If the application requests formatted ASCII text -->
<configuration-text>
<!-- formatted ASCII configuration statements -->
</configuration-text>
<!-- If the application requests configuration mode set commands -->
<configuration-set>
<!-- configuration mode commands -->
</configuration-set>
<!-- If the application requests JSON format -->
<configuration-json>
<!-- JSON configuration data -->
</configuration-json>
</rpc-reply>
xml Junos 要素がタグ要素内で返された場合、対応する構成要素は Junos OS 構成ガイドに文書化されていません。また、ジュニパーネットワークス によって正式にサポートされています <undocumented> 。多くの場合、囲まれた要素はサポート担当者だけがデバッグに使用します。小さい数のケースでは、エレメントはサポートされなくなったか、設定階層の別の領域に移動されましたが、下位互換性を維持するために現在の場所に表示されます。
7 ビット ASCII 文字セット外の文字を含む運用データまたは設定データを表示する場合、Junos OS は、同等の UTF-8 10 進文字参照を使用してこれらの文字をエスケープし、エンコードします。詳細については、「 デバイスで実行するデバイスの文字エンコーディングについて 」をJunos OS。
、 タグの要素の参照ページについては、 XML API 運用デベロッパー リファレンス をJunos <configuration> <configuration-json> <configuration-set> <configuration-text> <undocumented> 参照してください。
リクエストを行う前に、クライアント アプリケーションで受験者の設定をロックする場合、読み取りリクエストの実行後にロックを解除する必要があります。他のユーザーとアプリケーションは、ロックされたまま設定を変更することはできません。詳しくは、 受験者設定のロックとロック解除 または XML プロトコルを使用したプライベート コピー Junos 参照してください。
次のトピックでは、クライアント アプリケーションが XML プロトコル サーバーから返される送信元、形式、およびJunosする方法について説明します。
アプリケーションは、その他の設定関連情報(設定階層の XML スキーマ表現や、以前にコミットした設定に関する情報など)を要求することもできます。詳細については、以下を参照してください。