NETCONF を使用して、指定された型の構成オブジェクトの識別子を要求します。
Junos OS を実行しているデバイスとの NETCONF セッションで、階層内の特定のタイプの各構成オブジェクトの識別子のみを示す出力を要求する場合、クライアント アプリケーションは、ルート(タグ要素で<configuration>
表される)からオブジェクト タイプの即時親レベルまで、設定階層のすべてのレベルを表すタグ要素を囲むタグ要素を出力<filter>
します。オブジェクト型は、空<name/>
のタグを囲むコンテナ タグ要素によって表されます。(タグ要素は<name>
、実際の識別子タグ要素の名前が異なる場合でも、常に使用できます。実際の名前も有効です。リクエスト全体がタグ要素で<rpc>
囲まれています。
<rpc> <get-config> <source> <!-- tag specifying the source configuration --> </source> <filter type="subtree"> <configuration> <!-- opening tags for each parent of the object type --> <object-type> <name/> </object-type> <!-- closing tags for each parent of the object type --> </configuration> </filter> </get-config> </rpc> ]]>]]>
タグ要素の <source>
詳細については、「 NETCONF を使用した構成情報要求のソースの指定」を参照してください。
複数の識別子を持つオブジェクト型の識別子のみを要求することはできません。ただし、このような多くのオブジェクトでは、識別子が唯一の子タグ要素であるため、完全な情報を要求すると、識別子のみを要求するのと同じ出力が生成されます。手順については、「 NETCONF を使用して、指定したタイプのすべての構成オブジェクトを要求する」を参照してください。
NETCONF サーバーは、要求されたオブジェクト <data>
を返し、 <rpc-reply>
タグ要素 (ここでは、識別子タグ要素が呼び出 <name>
されるオブジェクト)。開始 <configuration>
タグの属性の詳細については、「 NETCONF を使用した構成情報要求のソースの指定」を参照してください。
<rpc-reply xmlns="URN" xmlns:junos="URL"> <data> <configuration attributes> <!-- opening tags for each parent of the object type --> <first-object> <name>identifier-for-first-object</name> </first-object> <second-object> <name>identifier-for-second-object</name> </second-object> <!-- additional objects --> <!-- closing tags for each parent of the object type --> </configuration> </data> </rpc-reply> ]]>]]>
アプリケーションは、同じタグ要素に適切なタグ要素を含めて、同じまたは他のタイプの追加構成要素を <get-config>
要求することもできます。詳細については、 NETCONF を使用して複数の構成要素を同時に要求するを参照してください。
次の例では、候補構成の階層レベルで設定された各 BGP ネイバーの識別子を [edit protocols bgp group next-door-neighbors]
要求する方法を示しています。