Junos XML プロトコルを使用して、他の変更と同時に構成要素のアクティベーション状態を変更する
Junos OS を実行しているデバイスとの Junos XML プロトコル セッションでは、クライアント アプリケーションは、適切な属性または演算子 inactive
を or active
属性または演算子と組み合わせることによって、エレメント上で他の操作を実行すると同時にエレメントを非アクティブ化または再アクティブ化できます(削除を除く)。エレメントのアクティブ化または非アクティブ化に関する基本情報は、 Junos XML プロトコルを使用した構成要素のアクティベーション状態の変更を参照してください。
非アクティブ化またはアクティブ化する要素を定義するために、クライアント アプリケーションには、Junos XML プロトコルを使用した構成要素の作成、変更、削除の説明に従って、親レベルの基本タグ要素または設定ステートメントが含まれています。Junos XML タグ要素を使用して要素を表す場合、アプリケーションには、or active="active"
属性とタグ内のその他の適切な属性が<load-configuration>
含まれますinactive="inactive"
。書式設定されたASCIIテキストを使用する場合、アプリケーションは or active
演算子をinactive
他の演算子と組み合わせます。
手順については、次のセクションを参照してください。
要素を置き換え、アクティブ化の状態を設定します。
エレメントを置き換えて同時に非アクティブ化またはアクティブ化するには、クライアント・アプリケーションにエレメントのすべての特性を表すタグ・エレメントまたはステートメントが組み込まれます(エレメントを定義するための構文に関する完全な情報については、 Junos XML プロトコルを使用した構成データでのエレメントの置換を参照してください)。).クライアント アプリケーションは、次の例で説明する属性と演算子を使用して、置き換えられ、アクティブ化または非アクティブ化されている要素を示します。
置換要素に Junos XML タグ要素を使用する
Junos XML タグ要素を使用して要素を表す場合、クライアント アプリケーションにはタグ要素に属性が<load-configuration>
含まれますaction="replace"
。
<rpc> <!-- For a file --> <load-configuration action="replace" url="file"/> <!-- For a data stream --> <load-configuration action="replace"> <!-- Junos XML tag elements --> </load-configuration> </rpc>
置換要素の開始タグでは、アプリケーションには属性と or active="active"
属性の 2 つの属性replace="replace"
がinactive="inactive"
含まれています。要素に対して定義されているすべての子のタグ要素が含まれています。以下では、識別子タグ要素が呼び出されます<name>
。
<configuration> <!-- opening tag for each parent of the element --> <element replace="replace" (inactive="inactive" | active="active")> <name>identifier</name> <!-- if element has an identifier --> <!-- tag elements for each child of the element --> </element> <!-- closing tag for each parent of the element --> </configuration>
置換要素に書式設定されたASCIIテキストを使用する
フォーマットされたASCIIテキストを使用して要素を表す場合、クライアントアプリケーションにはタグに action="replace"
次の属性と format="text"
属性が <load-configuration>
含まれます。
<rpc> <!-- For a file --> <load-configuration action="replace" format="text" url="file"/> <!-- For a data stream --> <load-configuration action="replace" format="text"> <!-- formatted ASCII configuration statements --> </load-configuration> </rpc>
アプリケーションは、or active:
演算子をinactive:
新しい要素の上の行に配置し、演算子を新しい要素のreplace:
直前に配置します。要素のすべての子に対して定義されているすべての子ステートメントが含まれています。
<configuration-text> /* statements for parent levels */ /* For an object with an identifier */ (inactive | active): replace: object identifier { /* Child configuration statements */ } /* For a hierarchy level or object without an identifier */ (inactive | active): replace: element { /* Child configuration statements */ } /* closing braces for parent levels */ </configuration-text>
要素を並べ替え、アクティブ化の状態を設定する
順序付け済みリスト内のエレメントを並べ替え、同時に非アクティブ化またはアクティブ化するには、参照エレメントのinsert
属性と ID 属性を or active
属性とinactive
組み合わせます。以下では、移動要素の識別子タグ要素が呼び出されます<name>
。開始タグは読みやすさのみを目的として 2 行に表示されます。
<configuration> <!-- opening tag for each parent of the set --> <ordered-set insert="( before | after )" reference-identifier="value" (inactive="inactive" | active="active")> <name>identifier-for-moving-object</name> </ordered-set> <!-- closing tag for each parent of the set --> </configuration>
設定データを表すために書式設定されたASCIIテキストが使用されている場合、並べ替え操作は使用できません。
エレメントの並べ替えの詳細については、「 Junos XML プロトコルを使用した構成データ内のエレメントの並べ替え」を参照してください。
オブジェクトの名前を変更し、アクティブ化の状態を設定する
オブジェクトの名前を変更し(1 つ以上の識別子の値を変更)、同時にオブジェクトを非アクティブ化またはアクティブにするには、アプリケーションは新しい名前の属性と識別子属性を or active
属性とinactive
組み合わせますrename
。
オブジェクトに1つの識別子(ここで呼ばれる <name>
)がある場合、構文は次のようになります(開始タグは読みやすさのみを目的として2行に表示されます)。
<configuration> <!-- opening tag for each parent of the object --> <object rename="rename" name="new-name" \ (inactive="inactive" | active="active")> <name>current-name</name> </object> <!-- closing tag for each parent of the object --> </configuration>
オブジェクトが複数の識別子を持ち、1つだけが変更されている場合、構文は次のようになります(開始タグは読みやすさのみを目的として複数行に表示されます)。
<configuration> <!-- opening tag for each parent of the object --> <object rename="rename" changing-identifier="new-name" \ unchanging-identifier="current-name" \ (inactive="inactive" | active="active")> <changing-identifier>current-name</changing-identifier> <unchanging-identifier>current-name</unchanging-identifier> </object> <!-- closing tag for each parent of the object --> </configuration>
フォーマットされたASCIIテキストを使用して設定データを表す場合、名前変更操作は使用できません。
エレメントの名前変更の詳細については、「 Junos XML プロトコルを使用した構成データ内のオブジェクトの名前変更」を参照してください。
例:オブジェクトの置き換えと非アクティブ化
次の例では、呼び出されたG3
グループの候補構成の階層レベルで情報[edit protocols bgp]
を置き換え、また、候補がコミットされたときに実際の構成で使用しないようにグループを非アクティブにする方法を示しています。
次の例では、フォーマットされたASCIIテキストを使用して同じ 変更を行う方法を示しています。