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