Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
このページで
 

<get-configuration>

使用

説明

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

属性が junos:changed="changed" 変更された各設定要素の開始タグに表示されるように指定します。

属性は、変更された設定要素へのパス内のすべての親タグ要素の開始タグ(トップレベルの開始 <configuration> タグを含む)に表示されます。変更された構成要素が単一の(空の)タグで表される場合、属性が junos:changed="changed" タグに表示されます。変更された要素がコンテナー タグ要素で表される場合、属性 junos:changed="changed" は開くコンテナー タグに表示され、コンテナ タグ要素で囲まれた各子タグ要素にも表示されます。

属性を database 属性と組み合わせて、 changed="changed" 候補またはアクティブ構成のいずれかを要求できます。

  • 候補コンフィギュレーションが要求された場合( database="candidate" 属性が含まれているか、属性 database が完全に省略されている)、最後のコミット操作の後に候補コンフィギュレーションに追加された要素は 属性で junos:changed="changed" マークされます。

  • アクティブなコンフィギュレーションが要求された場合( database="committed" 属性が含まれています)、最新のコミットによってアクティブなコンフィギュレーションに追加された要素には、 属性が junos:changed="changed" 付けられます。

    メモ:

    コミット操作が成功すると、サーバーはすべてのタグ要素から属性を junos:changed="changed" 削除します。ただし、コミット中に警告が生成された場合、属性は削除されません。この場合、属性は junos:changed="changed" 、コミット操作の前に変更されたタグ要素と、コミット後に変更された要素に表示されます。

コミット時間警告の例は、デバイスが再起動されるまで設定要素が実際に適用されていないことを説明するメッセージです。この警告は、サーバーが返すタグ文字列に表示され、タグ要素に囲まれたコミットの成功を <xnm:warning> 確認します。

コミットする前に junos:changed="changed" 変更された要素から属性を削除するには、警告の原因を排除するために必要なアクションを実行し、再度設定をコミットします。

commit-scripts

NETCONF または Junos XML プロトコル サーバーに、コミット スクリプト スタイルの XML データを表示することを要求します。属性の値が出力を決定します。許容される値は次のとおりです。

  • apply-コミット スクリプトの変更が適用された設定(一時変更と非一時変更の両方を含む)を表示します。オプションを使用する場合、出力はCLI出力と | display commit-scripts 同等です。

  • apply-no-transients-コミット スクリプトの変更が適用された設定を表示しますが、一時的な変更は除外します。オプションを使用する場合、出力はCLI出力と | display commit-scripts no-transients 同等です。

  • viewコミットスクリプトへの入力であるXML形式で設定を表示します。これは、 、 、 groups="groups"の属性を使用した設定のinherit="inherit"表示とchanged="changed"同じです。オプションを使用する場合、出力はCLI出力と| display commit-scripts view同等です。

compare

NETCONF または Junos XML プロトコル サーバーに、アクティブ構成または候補構成と以前にコミットされた構成 (比較構成) の違いを表示することを要求します。

属性を compare 属性 database と組み合わせて、候補コンフィギュレーションまたはアクティブ・コンフィギュレーションが以前にコミットされたコンフィギュレーションと比較されるかどうかを示すことができます。属性を省略した database 場合、比較では候補コンフィギュレーションが使用されます。

属性は compare 、比較設定の参照に使用されるメソッドを示す以下の値を受け入れます。

  • configuration-revision— 属性で定義する設定リビジョン識別子文字列で比較設定を configuration-revision="revision-id" 参照します。

  • rollback—属性で定義するロールバックインデックスで比較設定を rollback="rollback-number" 参照します。

属性を compare 含め、対応する configuration-revision または rollback 属性を省略するか、無効な設定リビジョン識別子を提供する場合、サーバーは最後にコミットされた設定を比較設定として使用します。

候補のコンフィギュレーションをアクティブなコンフィギュレーションと比較すると、このという操作は compare XML出力を返します。それ以外の比較では、パッチ形式を使用して出力をテキストとして返します。候補コンフィギュレーションをアクティブなコンフィギュレーションと比較する場合、要求に属性に適切な値を含めることで、テキスト、XML、または JSON 形式の違いを format 表示することができます。Junos OS リリース 15.1R1 以降の XML 形式の違いを表示でき、Junos OS リリース 16.1R1 以降の JSON 形式の違いを表示できます。

メモ:

Junos OSリリース16.2R2以降、候補とアクティブな設定を比較し、XMLまたはJSON形式の違いを表示する場合、比較が違いを返さない場合、または比較が非ネイティブ設定データのみの違いを返す場合、デバイス <configuration> はXML出力でタグを省略し、JSON出力でオブジェクトを省略 configuration します。 たとえば、OpenConfig データ モデルに関連付けられた設定データなどです。

database

データを表示する設定を以下のいずれかとして指定します。

  • candidate-候補構成。

  • committed—アクティブな設定(最後にコミットされた設定)。

両方が含まれている場合、属性 databasedatabase-path 属性よりも優先されます。

database-path

コミットスクリプト内では、この属性はセッションの事前継承候補設定へのパスを指定します。許容できる値は.$junos-context/commit-context/database-path

通常の設定セッションの場合、コミット スクリプトは、通常の継承前候補の設定を取得します。プライベート設定セッションの場合、コミットスクリプトはプライベートの事前継承候補設定を取得します。

と 属性の両方をdatabasedatabase-path含める場合、 属性がdatabase優先されます。

format

NETCONF または Junos XML プロトコル サーバーが設定データを返す形式を指定します。許容される値は次のとおりです。

  • json設定ステートメントは、JSON(JavaScript Object Notation)を使用してフォーマットされます。Junos OSリリース16.1以降、Junos OSを実行するデバイスは、シリアル化の新しいデフォルト実装を使用して、JSON形式の設定データを出力します。

    メモ:

    Junos OSリリース16.1R4、16.2R2、および17.1R1以降、JSON形式で出力されるJunos OS設定データの整数は引用符で囲まれていません。以前のリリースでは、JSON 設定データの整数は文字列として扱われ、引用符で囲まれていました。

  • set— 設定ステートメントは、Junos OS 設定モード set コマンドとしてフォーマットされます。

  • text—設定ステートメントは、改行文字、タブ、その他の空白、中括弧、大括弧を使用してステートメント間の階層関係を示すために、ASCIIテキストとしてフォーマットされます。これは、Junos OSを実行するデバイスに保存された設定ファイルで使用される形式で、CLI show configuration コマンドで表示されます。

  • xml- 設定ステートメントは、対応する Junos XML タグ要素で表されます。これは、属性が省略された場合の format デフォルト値です。

メモ:

Junos OS リリース 21.1R1 およびリリース 22.3R1 Junos OS Evolved以降、NETCONF セッションは、不要なスペース、タブ、および改行を削除したそれぞれのフォーマットを返す および xml-minified フォーマットを追加でサポートjson-minifiedしています。

groups

属性が junos:group="group-name" 、設定グループから継承された各設定要素の開始タグに表示されるように指定します。変数は group-name 、その要素が継承された構成グループの名前を指定します。

属性の唯一の groups 許容可能な値は. groups属性を指定する groups 場合は、属性も指定する inherit 必要があります。

inherit

NETCONF または Junos XML プロトコル サーバーが、設定グループとインターフェイス範囲で定義されたステートメントをどのように表示するかを指定します。属性をinherit省略すると、出力は、 、 、 <apply-groups>、および <apply-groups-except> タグ要素を使用<groups>してユーザー定義の設定グループを表し、タグ要素を使用<interface-range>してユーザー定義のインターフェイス範囲を表します。junos-defaultsグループで定義されたステートメントにタグ要素は含まれません。

許容される値は次のとおりです。

  • defaults出力には 、<apply-groups>および <apply-groups-except> タグ要素は含<groups>まれていませんが、代わりに、ユーザー定義のグループから継承されたタグ要素と、継承するタグ要素の子として junos-defaults グループから継承されたタグ要素が表示されます。

  • inherit出力には、 、 <apply-groups><apply-groups-except>、および <interface-range> タグ要素は含<groups>まれていませんが、代わりに、ユーザー定義のグループおよび範囲から継承されたタグ要素を継承するタグ要素の子として表示します。出力には、junos-defaultsグループで定義されたステートメントのタグ要素は含まれていません。

interface-ranges

属性が junos:interface-ranges="source-interface-range" 、インターフェイス範囲から継承された各設定要素の開始タグに表示されるように指定します。変数は source-interface-range 、インターフェイス範囲の名前を指定します。

属性の唯一の interface-ranges 許容可能な値は. interface-ranges属性を指定する interface-ranges 場合は、属性も指定する inherit 必要があります。

junos:key | key

属性がjunos:key="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-scriptsJunos OSリリース12.1に追加された属性値applyapply-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設定データの整数は引用符で囲まれていません。

compareconfiguration-revision Junos OS リリース 20.4R1 およびリリース 20.4R1 Junos OS Evolvedに追加された属性値。

formatjson-minified Junos OS リリース 21.1R1 およびリリース 22.3R1 Junos OS Evolvedでの NETCONF セッションに対してのみ追加された属性値とxml-minified