Junos XML プロトコルを使用したレスキュー設定の取得
レスキュー設定は、有効な非デフォルト設定を復元する必要がある場合に備えて保存される設定です。(レスキュー設定を作成するには、Junos XML プロトコル セッションの Junos XML <request-save-rescue-configuration> タグ要素または request system configuration rescue save CLI の運用モード コマンドを使用します。詳細については、 Junos XML API 運用開発者リファレンス または CLI エクスプローラーを参照してください)。
Junos OS を実行するデバイスとの Junos XML プロトコル セッションでは、クライアント アプリケーションは要素内の Junos XML <get-rescue-information> タグ要素を放射してレスキュー設定を <rpc> 要求します。この操作は、 動作モード コマンドと show system configuration rescue 同じです。
Junos XML タグ付き出力を要求するには、アプリケーションに値xmlを<format>持つタグ要素が含まれているか、タグ要素を<format>省略します(Junos XML 出力がデフォルトです)。
<rpc>
<get-rescue-information/>
</rpc>
Junos XML プロトコル サーバーは、応答を 、 、<rescue-information>および <configuration> タグ要素で<rpc-reply>囲みます。<load-success/>タグは実装の副作用であり、結果には影響しません。開始<configuration>タグの属性については、 Junos XMLプロトコルセッションにおける設定情報リクエストのソースの指定を参照してください。
<rpc-reply xmlns:junos="URL">
<rescue-information>
<load-success/>
<configuration attributes>
<!-- tag elements representing the rescue configuration -->
</configuration>
</rescue-information>
</rpc-reply>
フォーマットされたASCII出力を要求するために、アプリケーションには 値textを<format>持つタグ要素が含まれています。
<rpc>
<get-rescue-information>
<format>text</format>
</get-rescue-information>
</rpc>
Junos XML プロトコル サーバーは、その応答を 、 、 <rescue-information><configuration-information>、および <configuration-output> タグ要素で<rpc-reply>囲みます。Junos OS設定ステートメントで使用されるフォーマットされたASCII表記の詳細については、 Junos XMLプロトコルセッションにおける設定データの出力形式の指定を参照してください。
<rpc-reply xmlns:junos="URL">
<rescue-information>
<load-success/>
<configuration-information>
<configuration-output>
<!-- formatted ASCII text representing the rescue configuration -->
</configuration-output>
</configuration-information>
</rescue-information>
</rpc-reply>
Junos OSリリース16.1以降、JSON形式でレスキュー設定を要求するために、アプリケーションには 要素内の値jsonを<format>持つタグ要素が<get-rescue-information>含まれています。Junos OS リリース 16.1 以前は、開始<get-rescue-information>タグに 属性をformat="json"含めることで、JSON 形式のデータが要求されます。
<rpc>
<get-rescue-information>
<format>json</format>
</get-rescue-information>
</rpc>
属性をformat="json"使用して形式を指定する場合、Junos XML プロトコル サーバーはその応答を<rpc-reply>要素で囲み、トップレベルの JSON メンバーのフィールド名は 、 、出力された構成データは"rescue-information"シリアル化に古い実装を使用します。要素を<format>json</format>使用して JSON 形式のデータを要求すると、Junos XML プロトコル サーバーはその応答を 、 <rescue-information>、 <configuration-information>、タグ<json-output>要素で<rpc-reply>囲み、トップレベルの JSON メンバーのフィールド名は 、 、出力された構成データは"configuration"シリアル化に新しい実装を使用します。
<rpc-reply xmlns:junos="URL">
<rescue-information>
<load-success/>
<configuration-information>
<json-output>
{
"configuration" : {
<!-- JSON data representing the rescue configuration -->
}
}
</json-output>
</configuration-information>
</rescue-information>
</rpc-reply>
jsonを
<format>持つタグ要素が
<get-rescue-information>含まれています。