コマンドJunos OSおよびコマンド出力を XML タグ要素Junosマップする
XML API Junos XML は、設定ステートメントおよび動作モード コマンドJunos OS XML 表現です。ネットワーク設定階層内のすべてのステートメントに XML に相当しJunos OS、ユーザーが発行するコマンドの多くは動作モードでCLIされます。XML 対応マップを持つ各動作モード コマンドJunos対応するマップをリクエスト タグ 要素、必要に応じて応答タグ 要素にマッピングします。
リクエスト タグ要素は、NETCONF および XML プロトコル セッション内のリモート プロシージャ コール(RPC)で使用されJunos XML プロトコル セッションで、デバイスで実行中のデバイスに情報を要求Junos OS。サーバーは、応答タグ要素内でJunos XML タグ要素を使用して応答を返します。たとえば、コマンドは show interfaces リクエスト タグにマッピング <get-interface-information> され、サーバーは応答タグを <interface-information> 返します。
次のセクションでは、コマンド、コマンド オプション、コマンド出力を XML タグ要素に関連付Junosについて説明します。
コマンド出力を XML 要素Junosマッピング
Junos OS コマンドライン インターフェイス(CLI)で、デフォルトでフォーマットされたASCII | display xml テキストとしてではなく、コマンド出力をJunos XMLタグ要素として表示するには、コマンドの後に オプションを含める必要があります。Junos OS の構成または運用データを記述するタグ要素は Junos XML API に属し、NETCONF および Junos XML 管理プロトコルの操作によって取得および操作できる Junos OS コンテンツを定義します。
show chassis hardware次の例は、Junos OSリリース9.3<chassis-inventory>を実行しているM20ルーター上で発行されたコマンドからの出力を示しています(開始タグは、読み取り専用として2行に表示されます)。これは、RPC リクエストに対するサーバーの応答と同<get-chassis-inventory>じです。
user@host> show chassis hardware | display xml
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/9.3R1/junos">
<chassis-inventory \
xmlns="http://xml.juniper.net/junos/9.3R1/junos-chassis">
<chassis junos:style="inventory">
<name>Chassis</name>
<serial-number>00118</serial-number>
<description>M20</description>
<chassis-module>
<name>Backplane</name>
<version>REV 06</version>
<part-number>710-001517</part-number>
<serial-number>AB5911</serial-number>
</chassis-module>
<chassis-module>
<name>Power Supply A</name>
<!-- other child tags of <chassis-module> -->
</chassis-module>
<!-- other child tags of <chassis> -->
</chassis>
</chassis-inventory>
</rpc-reply>
XML リクエスト タグ要素Junosへのコマンドのマッピング
使用可能な Junos OS 動作モード コマンドおよび同等の Junos XML RPC リクエスト タグに関する情報は、 Junos XML API Explorer - 運用タグ ツールおよび Junos OS CLI。このツールを使用して、コマンドを検証し、コマンドを同等の Junos XML RPC リクエスト タグと子タグに関連付け、さまざまなプロトコル リリースで想定される応答タグJunos OSできます。
XML リクエスト タグ要素Junos XML 対応の動作モード コマンドの xml リクエスト タグ要素Junos表示Junos OS CLI。動作モード コマンドJunos XML RPC リクエスト タグを表示するには、 コマンドを入力して コマンドにパイプ接続 display xml rpc します。
次の例では、 コマンドの RPC タグを表示 show route します。
user@host> show route | display xml rpc
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/10.1I0/junos">
<rpc>
<get-route-information>
</get-route-information>
</rpc>
<cli>
<banner></banner>
</cli>
</rpc-reply>
リリース Junos OS 20.3R1 から、一部の Junos XML RPC リクエスト タグの名前が更新され、XML API 全体の一貫性Junos確認されます。Junos OS を実行しているデバイスは、下位互換性を維持するために古いリクエスト タグ名を引き続き受け入れされますが、今後も新しい名前を使用することをお勧めします。特定の Junos OS リリースの動作モード コマンドに対して Junos XML RPC リクエスト タグを検証するには、 Junos XML API Explorer - 運用 タグ ツール を参照してください。
変数値を使用したコマンド オプションのマッピング
多くの CLI コマンドには、そのコマンドが影響を受けるオブジェクトやレポートを識別するオプションが含まれています。このオプションでは、そのオブジェクトと同タイプの他のオブジェクトとを区別します。場合によっては、CLI で識別子の前に固定形式のキーワードを付けはしない場合がありますが、XML 表記規則では、Junos XML API がすべてのオプションのタグ要素を定義する必要があります。運用リクエストタグ要素の各識別子(および他の子タグ要素)の名前を確認するには、適切なD DTDまたはJunos XML API運用開発者リファレンス内のタグ要素のエントリーを参照するか、または | display xml rpc CLIでコマンドおよびコマンド オプションを発行してオプションを追加します。
次の例は、2 つのJunos XML タグ要素にCLI可変形式オプションを備CLI XML タグ要素を示しています。コマンドでは show interfaces 、t3-5/1/0:0 はインターフェイスの名前です。コマンドでは show bgp neighbor 、10.168.1.222 は、関連するデバイスBGP ピアです。
コマンドおよびコマンド オプションを実行Junos追加すると、コマンドの XML RPC タグの url とオプションを CLI に表示できます | display xml rpc。
user@host> show interfaces t3-5/1/0:0 | display xml rpc
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos">
<rpc>
<get-interface-information>
<interface-name>t3-5/1/0:0</interface-name>
</get-interface-information>
</rpc>
<cli>
<banner></banner>
</cli>
</rpc-reply>
固定形式コマンド オプションのマッピング
一部CLIコマンドbriefdetailには、出力に含める詳細情報の量を指定する文字列など、固定された形式のオプションが含まれています。通常Junos XML API では、このようなオプションが空のタグにマッピングされます。名前はオプション名と一致します。
次の例は、 Junos呼ばれる固定形式オプションを持つ、 コマンドの XML show isis adjacency タグ要素の例を示しています detail。
アプリケーションのタグを表示するには、以下のCLI。
user@host> show isis adjacency detail | display xml rpc
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos">
<rpc>
<get-isis-adjacency-information>
<detail/>
</get-isis-adjacency-information>
</rpc>
<cli>
<banner></banner>
</cli>
</rpc-reply>