NETCONF サーバーへのリクエストの送信
NETCONF サーバーへのリクエストを開始するには、クライアント アプリケーションから開始タグが送信され、その後に特定のリクエストを表す 1 つ以上のタグ要素が送信され、その後に終了タグが <rpc> </rpc> 続きます。
<rpc>
<!-- tag elements representing a request -->
</rpc>
]]>]]>
アプリケーションは、各リクエストを、独自の開始タグと終了タグの個別のペア <rpc> で囲 </rpc> み込まれます。各リクエストには、準拠したタグ要素と正しく順序付けられたタグ要素のみを含め、適切に形成された XML 文書を構成する必要があります。NETCONF サーバーは、タグ ストリーム内のタグ要素の間で発生する新しい行の文字、スペース、その他の空白文字を無視しますが、タグ要素内の空白は保持します。
必要に応じて、クライアント アプリケーションは、各リクエストの開始タグにフォームの属性 attribute-name="value" <rpc> を 1 つ以上含めできます。NETCONF サーバーは、応答を囲む開始タグに変更されず <rpc-reply> 、各属性がエコーされます。
クライアント アプリケーションは、この機能を使用して、一意の識別子を割り当てる各開始要求タグに属性を含めて、リクエストと応答 <rpc> を関連付けできます。NETCONF サーバーには開始タグの属性が表示され、応答を開始するリクエスト <rpc-reply> に簡単に関連付けできます。NETCONF 仕様は、この属性の message-id 名前を指定します。
運用リクエストと設定リクエストは概念的に別々のクラスに属しますが、NETCONF セッションには、個別の動作モードと設定モードCLI対応する個別のモードはありません。各リクエスト タグ要素は独自のタグ内に囲まれたので、クライアント アプリケーションは、操作と設定のリクエストを自由に <rpc> 代替できます。クライアント アプリケーションは、次の 3 つのクラスのリクエストを作成できます。
運用リクエスト
運用リクエストは、Junos OS を実行しているデバイスのステータスに関する情報を要求する要求です。 運用リクエストは、Junos OS CLIモード コマンドに対応しています。XML API 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>
]]>]]>
運用リクエストの詳細については、「 NETCONF を使用した運用情報のリクエスト 」を参照してください。現在の Junos OS リリースで使用可能な Junos XML リクエスト タグ 要素の詳細については、 Junos XML API 運用 開発者リファレンス および XML API Explorer を 参照してください。
設定情報リクエスト
設定情報の リクエストは、デバイスの受験者の構成、プライベート設定、一時的な設定、またはコミットされた設定(現在スイッチング、ルーティング、またはセキュリティ プラットフォームでアクティブに使用されている設定)に関する情報を要求します。受験者とコミットされた設定は、コミットされていない変更を受験者の設定に対して行う場合に、違いを生み出します。
NETCONF プロトコルは、設定情報を取得 <get-config> するための操作を定義します。XML API Junos XML API は、設定階層内のすべてのコンテナおよびリーフ ステートメントにタグ要素を定義します。
次の例は、受験者の設定の階層レベルから情報を要求 [edit system login] する方法を示しています。
<rpc>
<get-config>
<source>
<candidate/>
</source>
<filter type="subtree">
<configuration>
<system>
<login/>
</system>
</configuration>
</filter>
</get-config>
</rpc>
]]>]]>
設定情報のリクエストの詳細については、「 NETCONF を使用した設定データの要求 」を参照してください。使用可能な構成タグ要素の概要については、「 XML API Configuration Developer Reference Junos XML API Explorer 」 を参照してください。
設定変更要求
設定変更要求は 、設定を変更したり、変更をコミットして、デバイスで実行中のデバイスでアクティブに使用Junos OS。NETCONF プロトコルは、設定情報 <edit-config> を変更 <copy-config> する操作とを定義します。XML API Junosは、すべてのアプリケーション設定ガイドに記載CLIタグ要素を定義Junos OSします。
次の例では、受験者の設定の階層レベルJunos OS新しいアカウントとユーザー アカウントを作成 admin [edit system login] する方法を示しています。
<rpc>
<edit-config>
<target>
<candidate/>
</target>
<config>
<configuration>
<system>
<login>
<user>
<name>admin</name>
<full-name>Administrator</full-name>
<class>superuser</class>
</user>
</login>
<login/>
</system>
</configuration>
</config>
</edit-config>
</rpc>
]]>]]>
設定変更要求の詳細については、「 NETCONF を使用した設定の編集 」を参照してください。XML 設定タグ要素Junosの概要については、「 XML API Configuration Developer Reference Junos XML API Explorer 」 を参照してください。