<load-configuration>
使用
<rpc> <load-configuration configuration-revision="revision-id"/> <load-configuration rescue="rescue"/> <load-configuration rollback="index"/> <load-configuration url="url" [action="(merge | override | replace | update)"] [format="(text | xml)"] /> <load-configuration url="url" [action="(merge | override | update)"] format="json" /> <load-configuration url="url" action="set" format="text"/> <load-configuration [action="(merge | override | replace | update)"] [format="xml"]> <configuration> <!-- tag elements for configuration elements to load --> </configuration> </load-configuration> <load-configuration [action="(merge | override | replace | update)"] format="text"> <configuration-text> <!-- formatted ASCII configuration statements to load --> </configuration-text> </load-configuration> <load-configuration [action="(merge | override | update)"] format="json"> <configuration-json> <!-- JSON configuration data to load --> </configuration-json> </load-configuration> <load-configuration action="set" format="text"> <configuration-set> <!-- configuration mode commands to load --> </configuration-set> </load-configuration> </rpc>
説明
NETCONF または Junos XML プロトコル サーバーの構成データを候補の構成データベースまたはオープン構成データベースに読み込んでもらう必要があります。
クライアント アプリケーションが Junos XML プロトコル <open-configuration>
操作を発行して、操作を実行する前に特定の構成データベースを <load-configuration>
開くと、サーバーは構成データをオープンな構成データベースに読み込みます。それ以外の場合、サーバーはコンフィギュレーション・データを候補コンフィギュレーションに読み込みます。
次のいずれかの方法で読み込むデータを提供します。
空
<load-configuration/>
のタグのconfiguration-revision
属性を、以前にコミットされた設定の設定リビジョン識別子に設定します。指定された設定は、候補コンフィギュレーションを完全に置き換えます。空
<load-configuration/>
のタグのrescue
属性を 値rescue
に設定します。レスキュー設定は、候補コンフィギュレーションを完全に置き換えます。空
<load-configuration/>
のタグのrollback
属性を、以前にコミットした設定のロールバックインデックスに設定します。デバイスは、直近にコミットされた設定と、最大 49 個の過去の設定のコピーを保存します。指定された設定は、候補コンフィギュレーションを完全に置き換えます。空
<load-configuration/>
のタグのurl
属性を、読み込む設定データを含むファイルのパス名に設定します。属性をformat
、 、text
またはxml
にjson
設定すると、対応する形式の JavaScript Object Notation(JSON)、書式設定された ASCII テキスト、または Junos XML タグ要素(デフォルト)で設定が読み込まれます。設定モードコマンドとして設定データを提供するには、 属性をaction="set"
含め、属性をformat
省略するか、 に値text
を設定します。次の例では、 属性は
url
、設定データを/tmp/add.confファイルから読み込む必要があることを識別します。<load-configuration url="/tmp/add.conf" format="text"/>
設定データを、開始
<load-configuration>
タグと終了タグ内でデータストリームとして囲</load-configuration>
みます。設定データをフォーマットされたASCIIテキストとして提供する場合は、データをタグ要素で<configuration-text>
囲み、 に属性text
をformat
設定します。設定データを Junos XML タグ要素として提供する場合は、データを<configuration>
タグ要素で囲み、属性をformat
省略するか、 に値xml
を設定します。設定データを設定モードコマンドとして提供する場合は、データをタグ要素で<configuration-set>
囲み、属性をaction
にset
設定し、属性をformat
省略するか、 を にtext
設定します。設定データを JSON で提供する場合は、そのデータを<configuration-json>
タグ要素で囲み、属性をformat
にjson
設定します。
属性
action |
特に、ターゲットの設定データベースと読み込まれた設定に矛盾するステートメントが含まれている場合に、設定データを読み込む方法を指定します。 一時的な設定データベースは、指定されたリリースでサポートされているデバイスで以下
許容される値は次の通りです。
|
configuration-revision |
設定リビジョン識別子を参照して、以前にコミットされた設定を読み込みます。指定された設定は、候補コンフィギュレーションを完全に置き換えます。 |
format |
設定データに使用する形式を指定します。許容される値は次のとおりです。
|
rescue |
レスキュー設定が現在の候補コンフィギュレーションを置き換えることを指定します。有効な値は「レスキュー」のみです。
メモ:
Junos OS リリース 18.1R1 以降では、RPC を使用 |
rollback |
数値ロールバック インデックスを参照して、以前にコミットされた設定を読み込みます。有効な値は、0(直近にコミットされたコンフィギュレーションではゼロ)から、保存された以前のコンフィギュレーションの数より1少ない値(最大49)。です。
メモ:
Junos OS リリース 18.1R1 以降では、RPC を使用 |
url |
読み込む設定データを含むファイルのフルパス名を指定します。値には、ローカル ファイル パス、FTP の場所、またはハイパーテキスト転送プロトコル(HTTP)URL を指定できます。
いずれの場合も、変数の既定値pathはユーザー名のホーム ディレクトリです。絶対パスを指定するために、アプリケーションはパスを文字 %2F で開始します。例えば、ftp://username:password@hostname/%2Fpath/filename |
リリース情報
これは、Junos XML 管理プロトコルの操作です。Junos XML プロトコル セッションでサポートされ、機能交換で http://xml.juniper.net/netconf/junos/1.0 URI を識別する Junos OS を実行するデバイス上の NETCONF セッションで、ジュニパーネットワークス独自の拡張機能としてサポートされています。
action
Junos OS リリース 11.4 で追加された属性値 set
。
format
Junos OS リリース 16.1 で追加された属性値 json
。
configuration-revision
Junos OSリリース20.4R1およびリリース20.4R1 Junos OS Evolved追加された属性。