Junos XML プロトコルを使用して、特定の数の設定オブジェクトを要求する
Junos OSを実行しているデバイスとのJunos XMLプロトコルセッションでは、特定のタイプの特定の数の設定オブジェクトに関する情報を要求するために、クライアントアプリケーションはタグ要素を発行 <get-configuration> し、設定階層のすべてのレベルを表すタグ要素をルート(タグ要素で <configuration> 表される)からオブジェクトタイプの即時の親レベルまで囲みます。空のタグは要求されたオブジェクトタイプを表し、タグには以下の属性が含まれています。
count返すオブジェクトの数を指定します。start返す最初のオブジェクトのインデックス番号を指定します(最初のオブジェクトは1、2番目のオブジェクトは2など)
アプリケーションが階層内の最初のオブジェクトのみを要求する場合は、 属性が count="1" 含まれており、 属性は start 省略されます。アプリケーションは、リクエスト全体をタグ要素で <rpc> 囲みます。
<rpc>
<get-configuration>
<configuration>
<!-- opening tags for each parent of the object -->
<object-type count="count" start="index"/>
<!-- closing tags for each parent of the object -->
</configuration>
</get-configuration>
</rpc>
count JSON 形式の設定データを要求する場合、 および start 属性はサポートされていません。
Junos XML プロトコル サーバーは、 属性で指定されたオブジェクトから始まり、連続して実行される要求されたオブジェクトを start 返します。アプリケーションが Junos XML タグ付き出力(デフォルト)を要求すると、Junos XML プロトコル サーバーは、 属性で指定されたオブジェクトから始まり、連続して実行する要素内 <configuration> の要求されたオブジェクトと <rpc-reply> タグ要素を start 返します。
各オブジェクトに対して、サーバーには 2 つの 属性が含まれています。
junos:positionをクリックして、オブジェクトの数値インデックスを指定します。junos:totalをクリックして、 階層に存在するオブジェクトの総数を報告します。
次の Junos XML 出力例では、識別子タグ要素が と呼ばれます <name>。開始 <configuration> タグの属性については、 Junos XMLプロトコルセッションにおける設定情報リクエストのソースの指定を参照してください。
<rpc-reply xmlns:junos="URL">
<configuration attributes>
<!-- opening tags for each parent of the object type -->
<first-object junos:position="index1" junos:total="total">
<name>identifier-for-first-object</name>
<!-- other child tag elements of the first object -->
</first-object>
<second-object junos:position="index2" junos:total="total">
<name>identifier-for-second-object</name>
<!-- other child tag elements of the second object -->
</second-object>
<!-- additional objects -->
<!-- closing tags for each parent of the object type -->
</configuration>
</rpc-reply>
および 属性はjunos:position、クライアントがタグ要素に属性<get-configuration>を含めてformat="text"フォーマットされたASCII出力を要求した場合には表示されません(Junos XMLプロトコルセッションの設定データの出力形式の指定で説明されているjunos:totalとおり)。
出力のソース(候補またはアクティブ構成)を指定するには、アプリケーションは、開始タグ、その開始<get-configuration><junoscript>タグ、またはその両方に属性を含めることができます。詳細については、 Junos XMLプロトコルセッションにおける設定情報リクエストのソースの指定を参照してください。
アプリケーションは、同じタグ要素に適切なタグ要素を含めることで、同じまたは他のタイプの追加構成要素を <get-configuration> 要求することもできます。詳細については、 Junos XML プロトコルを使用した複数の構成要素の要求を参照してください。
以下の例では、 階層レベルで3番目と4番目のJunosユーザーアカウントを要求する方法を [edit system login] 示しています。出力は候補コンフィギュレーションからのものであり、Junos XML タグ要素(デフォルト)でタグ付けされています。
