<get-configuration>
使用
<rpc> <get-configuration [changed="changed"] [commit-scripts="( apply | apply-no-transients | view )"] [compare=("configuration-revision" [configuration-revision="revision-id"] | "rollback" [rollback="[0-49]"])] [database="(candidate | committed)"] [database-path=$junos-context/commit-context/database-path] [format="( json | set | text | xml )"] [inherit="( defaults | inherit )" [groups="groups"] [interface-ranges="interface-ranges"]] [(junos:key | key )="key"] > <!-- tag elements for the configuration element to display --> </get-configuration> </rpc>
説明
NETCONF または Junos XML プロトコル サーバーから構成データを要求します。属性は、表示するデータのソースとフォーマットを指定します。
クライアント アプリケーションが Junos XML プロトコル <open-configuration>
操作を発行して、操作を実行する前に特定の構成データベースを <get-configuration>
開くと、サーバーはオープン構成データベースから構成データを返します。それ以外の場合、サーバーは属性を含めることでアクティブな設定が明示的に要求されない限り、候補の設定から設定データを database="committed"
返します。
クライアント・アプリケーションは、構成階層全体またはそのサブセットを要求できます。
設定階層全体を表示するには、空
<get-configuration/>
のタグを発行します。構成要素(階層レベルまたは設定オブジェクト)を表示するには、タグ要素内でタグ要素を
<get-configuration>
発行し、ルート(タグ要素で<configuration>
表される)から表示するレベルまたはオブジェクトまで、設定階層のすべてのレベルを表します。階層レベルまたは識別子を持たない設定オブジェクトを表すために、空のタグとして出力します。1 つ以上の識別子を持つオブジェクトを表すために、他の特性を表すタグ要素ではなく、コンテナ タグ要素と識別子タグ要素のみを発行します。
一時的な構成データベースのインスタンスから構成データを取得するには、クライアント アプリケーションが操作を発行する前に、適切な子タグで操作を <open-configuration>
使用して一時的なインスタンスを開く <get-configuration>
必要があります。という操作を使用して一時的な設定データを取得する <get-configuration>
場合、サポートされている属性は format
および key
のみです。
Junos OS リリース 13.1 以降、NETCONF または Junos XML プロトコル セッション内で、論理システム ユーザーは Junos XML <get-configuration>
操作を使用して、子設定タグを使用して特定の論理システム設定階層を要求し、論理システム設定全体を要求できます。論理システム構成全体を要求すると、RPC の応答にはルート タグが <configuration>
含まれます。Junos OS リリース 13.1 以前は、 <configuration>
ルート タグは省略されます。
属性
changed |
属性が 属性は、変更された設定要素へのパス内のすべての親タグ要素の開始タグ(トップレベルの開始 属性を
コミット時間警告の例は、デバイスが再起動されるまで設定要素が実際に適用されていないことを説明するメッセージです。この警告は、サーバーが返すタグ文字列に表示され、タグ要素に囲まれたコミットの成功を コミットする前に |
commit-scripts |
NETCONF または Junos XML プロトコル サーバーに、コミット スクリプト スタイルの XML データを表示することを要求します。属性の値が出力を決定します。許容される値は次のとおりです。
|
compare |
NETCONF または Junos XML プロトコル サーバーに、アクティブ構成または候補構成と以前にコミットされた構成 (比較構成) の違いを表示することを要求します。 属性を 属性は
属性を 候補のコンフィギュレーションをアクティブなコンフィギュレーションと比較すると、このという操作は
メモ:
Junos OSリリース16.2R2以降、候補とアクティブな設定を比較し、XMLまたはJSON形式の違いを表示する場合、比較が違いを返さない場合、または比較が非ネイティブ設定データのみの違いを返す場合、デバイス |
database |
データを表示する設定を以下のいずれかとして指定します。
両方が含まれている場合、属性 |
database-path |
コミットスクリプト内では、この属性はセッションの事前継承候補設定へのパスを指定します。許容できる値は. 通常の設定セッションの場合、コミット スクリプトは、通常の継承前候補の設定を取得します。プライベート設定セッションの場合、コミットスクリプトはプライベートの事前継承候補設定を取得します。 と 属性の両方を |
format |
NETCONF または Junos XML プロトコル サーバーが設定データを返す形式を指定します。許容される値は次のとおりです。
メモ:
Junos OS リリース 21.1R1 およびリリース 22.3R1 Junos OS Evolved以降、NETCONF セッションは、不要なスペース、タブ、および改行を削除したそれぞれのフォーマットを返す および |
groups |
属性が 属性の唯一の |
inherit |
NETCONF または Junos XML プロトコル サーバーが、設定グループとインターフェイス範囲で定義されたステートメントをどのように表示するかを指定します。属性を 許容される値は次のとおりです。
|
interface-ranges |
属性が 属性の唯一の |
junos:key | key |
属性が |
リリース情報
これは、Junos XML 管理プロトコルの操作です。Junos XML プロトコル セッションでサポートされ、機能交換で http://xml.juniper.net/netconf/junos/1.0 URI を識別する Junos OS を実行するデバイス上の NETCONF セッションで、ジュニパーネットワークス独自の拡張機能としてサポートされています。
interface-ranges
Junos OSリリース10.3R1で追加された属性。
commit-scripts
Junos OSリリース12.1に追加された属性値apply
とapply-no-transients
database-path
Junos OSリリース12.2で追加された属性。
format
Junos OS リリース 14.2 で追加された属性値 json
。
format
Junos OS リリース 15.1 で追加された属性値 set
。
Junos OSリリース16.1以降、Junos OSを実行するデバイスは、シリアル化の新しいデフォルト実装を使用して、JSON形式の設定データを出力します。
Junos OSリリース16.1R4、16.2R2、および17.1R1以降、JSON形式で出力されるJunos OS設定データの整数は引用符で囲まれていません。
compare
configuration-revision
Junos OS リリース 20.4R1 およびリリース 20.4R1 Junos OS Evolvedに追加された属性値。
format
json-minified
Junos OS リリース 21.1R1 およびリリース 22.3R1 Junos OS Evolvedでの NETCONF セッションに対してのみ追加された属性値とxml-minified
。