Junos XMLプロトコルを使用した特定タイプの設定オブジェクトのリクエスト識別子
Junos OSを実行しているデバイスとのJunos XMLプロトコルセッションで、階層内の特定のタイプの各設定オブジェクトの識別子のみを示す出力を要求するために、クライアントアプリケーションは、 <get-configuration>
ルート(タグ要素で表される <configuration>
)からオブジェクトタイプのすぐ親レベルまでの設定階層のすべてのレベルを表すタグ要素を囲むタグ要素を出力します。空のタグは要求されたオブジェクトタイプを表し、 recurse="false"
属性が含まれています。要求全体が tag 要素で <rpc>
囲まれています。
指定した型のすべてのオブジェクトの識別子を要求するために、クライアント アプリケーションは属性のみを含めます recurse="false"
。
<rpc> <get-configuration> <configuration> <!-- opening tags for each parent of the object type --> <object-type recurse="false"/> <!-- closing tags for each parent of the object type --> </configuration> </get-configuration> </rpc>
指定した数のオブジェクトの識別子を要求するために、クライアント アプリケーションは、Junos XML プロトコルを使用した特定数の構成オブジェクトの要求で説明されている属性とcount
、 属性start
を組み合わせrecurse="false"
ます。
<rpc> <get-configuration> <configuration> <!-- opening tags for each parent of the object type --> <object-type recurse="false" count="count" start="index"/> <!-- closing tags for each parent of the object type --> </configuration> </get-configuration> </rpc>
アプリケーションが Junos XML タグ付き出力(デフォルト)を要求すると、Junos XML プロトコルサーバーは、 および タグ要素内の<configuration>
<rpc-reply>
要求されたオブジェクトを返します。アプリケーションが指定された数のオブジェクトをリクエストした場合、 junos:position
Junos XMLプロトコルを使用した特定数の設定オブジェクトのリクエストで説明されているように、 および junos:total
属性は各オブジェクトの開始タグに含まれます。
次の出力例では、識別子タグ要素は <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> </first-object> <second-object [junos:position="index2" junos:total="total"]> <name>identifier-for-second-object</name> </second-object> <!-- additional instances of the object --> <!-- closing tags for each parent of the object type --> </configuration> </rpc-reply>
junos:position
クライアントが 属性を含めてformat="text"
フォーマットされたASCII出力を要求した場合、またはjunos:total
クライアントがタグ要素に<get-configuration>
属性を含めるformat="json"
ことでJSONフォーマットの出力を要求した場合(Junos XMLプロトコルセッションでの設定データの出力フォーマットの指定を参照)。
出力のソース(候補コンフィギュレーションまたはアクティブ・コンフィギュレーション)を指定するために、アプリケーションは、開始タグ、 <get-configuration>
その開始 <junoscript>
タグ、またはその両方に属性を含めることができます。詳細については、 Junos XMLプロトコルセッションでの設定情報リクエストのソースの指定を参照してください。
アプリケーションは、同じタグ要素に適切なタグ要素を含めることで、同じ <get-configuration>
タイプまたは他のタイプの追加の構成要素を要求することもできます。詳細については、 Junos XMLプロトコルを使用した複数の構成要素のリクエストを参照してください。
次に、 階層レベルで設定された [edit interfaces]
各インターフェイスの識別子を要求する例を示します。出力は候補コンフィギュレーションからのもので、Junos XMLタグ要素でタグ付けされます(デフォルト)。