このページで
Junos XML プロトコル サーバーへのリクエストの送信
Junos OSを実行するデバイスとのJunos XMLプロトコルセッションでは、クライアントアプリケーションは、開始 <rpc>
タグ、特定のリクエストを表す1つ以上のタグ要素、および閉じる </rpc>
タグをその順序で発行してリクエストを開始します。
<rpc> <!--tag elements representing a request--> </rpc>
アプリケーションは、各リクエストを独自の開始 <rpc>
タグと終了 </rpc>
タグのペアで囲みます。各リクエストは、準拠しており、正しく注文されたタグ要素のみを含めることで、形式の整った XML ドキュメントを構成する必要があります。Junos XML プロトコル サーバーは、タグ ストリーム内のタグ要素間で発生する改行文字、スペース、またはその他の空白文字は無視しますが、タグ要素内に空白文字を保持します。
必要に応じて、クライアント アプリケーションは、各リクエストの開始<rpc>
タグにフォームattribute-name="value"
の属性を 1 つ以上含めることができます。Junos XMLプロトコルサーバーは、応答を囲む開始<rpc-reply>
タグで、変更されていない各属性をエコーします。
クライアント アプリケーションは、一意の識別子を割り当てる各開始 <rpc>
要求タグに属性を含めることで、要求と応答を関連付けるためにこの機能を使用できます。Junos XML プロトコル サーバーは、開始 <rpc-reply>
タグの属性をエコーして、開始するリクエストへの応答を簡単にマッピングできます。クライアント アプリケーションは、次の注意に記載されている場合を除き、属性名を自由に定義できます。
xmlns:junos
属性名は予約済みです。Junos XML プロトコル サーバーは、開始<rpc-reply>
タグに適切な値に属性を設定するため、クライアント アプリケーションは開始<rpc>
タグで出力しないでください。
運用リクエストと設定リクエストは概念的には別々のクラスに属しますが、Junos XML プロトコル セッションには、CLI の運用モードと設定モードに対応する異なるモードはありません。各リクエストタグは独自 <rpc>
のタグ内に囲まれるため、クライアントアプリケーションは運用リクエストと設定リクエストを自由に代替できます。クライアントアプリケーションは、3つのリクエストクラスを作成できます。
運用リクエスト
運用リクエスト は、Junos OSを実行しているデバイスのステータスに関する情報のリクエストです。運用リクエストは、Junos OS CLI運用モードコマンドに対応します。Junos XML APIは、多くのCLIコマンドのリクエストタグを定義します。たとえば、タグは <get-interface-information>
コマンドに show interfaces
対応し、タグは <get-chassis-inventory>
コマンドと同じ情報を show chassis hardware
要求します。
次の RPC は、インターフェイス ge-2/3/0 に関する詳細情報を要求します。
<rpc> <get-interface-information> <interface-name>ge-2/3/0</interface-name> <detail/> </get-interface-information> </rpc>
運用要求の詳細については、 Junos XMLプロトコルを使用した運用情報の要求を参照してください。現在の Junos OS リリースで使用可能な Junos XML リクエスト タグ要素の詳細については、 Junos XML API 運用開発者リファレンス と XML API エクスプローラーを参照してください。
設定情報のリクエスト
構成情報の要求 は、デバイスの候補構成、プライベート構成、一時的な構成、またはコミットされた構成(現在、ルーティング、スイッチング、またはセキュリティ プラットフォームでアクティブに使用されている構成)に関する情報のリクエストです。候補構成にコミットされていない変更がある場合、候補とコミットされた設定は分岐します。
Junos XML プロトコルは、構成情報の取得操作 <get-configuration>
を定義します。Junos XML APIは、設定階層のすべてのコンテナおよびリーフステートメントのタグ要素を定義します。
以下の例は、候補コンフィギュレーションの階層レベルに関する [edit system login]
情報を要求する方法を示しています。
<rpc> <get-configuration> <configuration> <system> <login/> </system> </configuration> </get-configuration> </rpc>
設定情報の要求の詳細については、 Junos XMLプロトコルを使用した設定データの要求を参照してください。Junos XML 構成要素の概要については、 Junos XML API 構成開発者リファレンス と XML API エクスプローラーを参照してください。
設定変更要求
設定変更要求 は、設定を変更するか、変更をコミットしてJunos OSを実行するデバイス上でアクティブに使用するためのリクエストです。Junos XML プロトコルは、設定情報を変更する操作を <load-configuration>
定義します。Junos XML APIは、Junos OS設定ガイドで説明されているCLI設定ステートメントごとにタグ要素を定義します。
以下の例は、候補設定の 階層レベルで [edit system login]
と呼ばれるadmin
新しい Junos OS ユーザー アカウントを作成する方法を示しています。
<rpc> <load-configuration> <configuration> <system> <login> <user> <name>admin</name> <full-name>Administrator</full-name> <class>superuser</class> </user> </login> </system> </configuration> </load-configuration> </rpc>
設定変更要求の詳細については、 Junos XMLプロトコルを使用した設定変更の要求およびJunos XMLプロトコル を 使用した受験者設定のコミットを参照してください。Junos XML 構成要素の概要については、 Junos XML API 構成開発者リファレンス と XML API エクスプローラーを参照してください。