XML プロトコル Junos セッションを開始

クライアント・アプリケーションは、PIを使用することで始 <?xml?> まります。

メモ：

次の例(およびクライアント アプリケーションから送信されるタグ要素のこのドキュメントのすべての例で)では、テキストで説明されているタグ シーケンスの部分を強調するために、大胆なフォントが使用されています。

属性は次のとおりです。現在のバージョンの Junos XML 管理プロトコルで許容される属性値のリストについては、「 ソフトウェア互換性の検証 」 を参照してください。

• バージョン — クライアント アプリケーションから送信されたタグ要素を持つ XML のバージョンはに準拠しています。

• エンコーディング — クライアントアプリケーションが使用して理解できる標準化された文字セット

次のクライアント アプリケーション <?xml?> の PI version="1.0" の例では、この属性は、アプリケーションが XML 1.0 仕様に準拠した大分タグ要素かどうかを示しています。この encoding="us-ascii" 属性は、クライアント アプリケーションが American National Standards Institute(ANSI)によって標準化された 7 ビット ASCII 文字セットを使用している状態を示しています。ANSI標準の詳細については、 を参照 http://www.ansi.org/ 。

メモ：

アプリケーションが<?xml?><junoscript>開始タグの前にPIを送信できない場合、Junos XMLプロトコル サーバーはエラー メッセージを送信して、セッションと接続を即座に閉じます。

次に、クライアント アプリケーションは開始タグを <junoscript> 送信し、次の構文を使用します。

属性は次のとおりです。現在のバージョンの Junos XML 管理プロトコルで許容される属性値のリストについては、「 ソフトウェア互換性の検証 」を 参照してください。

version	(必須)クライアント アプリケーションが使用しているJunos XML 管理プロトコルのバージョンを指定します。
hostname	(オプション)クライアント アプリケーションが実行されているマシンの名前を指定します。この情報は、問題を診断する場合にのみ使用されます。xmlプロトコルJunosは、信頼できるホストの関係を確立したり、クライアントホスト名に応じてJunos XMLプロトコルサーバーの動作を変更したりするためのサポートは含されません。
junos:key	(オプション)XML プロトコル サーバー Junos要求は、子の構成要素が親要素の識別子かどうかを示します。許容される唯一の価値は「鍵」です。詳細については、 XMLプロトコル を使用した構成要素の識別子インジケータの要求Junosを参照してください。
release	(オプション)クライアント アプリケーションJunos OS設計されているアプリケーション リリース(Junos XML API)を特定します。この属性の値は、クライアント アプリケーションが Junos XML API のそのバージョンもサポートする Junos XML プロトコル サーバーと正常に相互運用Junos示しています。言い換えると、クライアント アプリケーションはその API からリクエスト タグ要素を送信し、そこから応答タグ要素を解析する方法を知っていることを示しています。アプリケーションにこの属性が含されていない場合、Junos XML プロトコル サーバーは、サポートする Junos XML API からタグ要素を送信します。 属性の値については、 release バージョン番号の標準表記Junos OS使用します。たとえば、値 20.4R1は、 リリース 20.4 の初期Junos OSを表します。

次の例では、<junoscript>version="1.0"クライアント アプリケーションの開始タグの例では、この属性は XML プロトコル バージョン 1.0 Junosを使用している状態を示しています。属性hostname="client1"は、クライアント アプリケーションが client1 と呼ばれるマシンで実行されている状態を示します。属性release="20.4R1"は、スイッチ、ルーター、またはセキュリティ デバイスがデバイス リリース 20.4 の初期バージョンJunos OS示しています。

メモ：

アプリケーションが<?xml?><junoscript>開始タグの前にPIを送信できない場合、Junos XMLプロトコル サーバーは次のようなエラー メッセージを送信し、セッションと接続を即座に終了します。

タグの詳細については、「 <xnm:error> XMLプロトコル セッションのエラーまたは警告Junosを参照してください。

XML プロトコル Junos セッションが開始すると、XML プロトコル サーバー Junos、PI <?xml?> と開始タグが送信 <junoscript> されます。

PI の構文は <?xml?> 次のとおりです。

属性は次のとおりです。現在のバージョンの Junos XML 管理プロトコルで許容される属性値のリストについては、「 ソフトウェア互換性の検証 」 を参照してください。

バージョン	XML プロトコル サーバーから送信されたタグ要素がJunos XML バージョンに準拠している
エンコーディング	XMLプロトコルサーバーが使用する標準化Junos文字セットは

次の例のJunos XML <?xml?> version="1.0" プロトコル サーバーのPIでは、この属性は、サーバーが XML 1.0仕様に準拠している大分タグ要素を示しています。属性 encoding="us-ascii" は、サーバーが ANSI で標準化された 7 ビット ASCII 文字セットを使用している状態を示しています。ANSI規格の詳細については、 を参照 http://www.ansi.org/ 。

PI <junoscript> をリ<?xml?>フォームした後、サーバーは開始タグを送信します。これは次の形式です(タグは複数の行に表示され、読み取り専用に表示されます)。

属性は次のとおりです。

ホスト	XMLプロトコル サーバーで実行されているJunosデバイスの名前。
Os	XMLプロトコルサーバーが実行されているデバイスJunos オペレーティング システム。値は常に JUNOS です。
リリース	XMLプロトコル サーバーがJunos OSのバージョンの識別子Junos、理解するように設計されています。これは、ユーザーが XML プロトコル サーバーを実行しているデバイスJunos当然ながら使用されます。属性の値は、ソフトウェア release バージョン番号に標準表記ジュニパーネットワークス使用します。たとえば、値 20.4R1は、リリース 20.4 のJunos OSを表します。
Schemalocation	階層化された構成の XML スキーマ言語表現の XML Junos OS名前空間。
バージョン	XMLプロトコル サーバー Junos使用している XML 管理プロトコルJunosバージョン。
Xmlns	名前に <junoscript> プレフィックスがある(つまり、XMLタグ要素のデフォルトの名前空間)タグ要素で囲まれたタグ要素Junos XML名前空間。値は、フォームの URL で http://xml.juniper.net/xnm/version/xnm、 version 1.1 などの文字列です。
xmlns:junos	名前にプレフィックスが付くタグ要素で囲<junoscript>junos:まれたタグ要素の XML 名前空間。値は、フォームの URL http://xml.juniper.net/junos/release-code/junosrelease-code で、フォームのリリースを表す標準文字列Junos OS。たとえば、値 20.4R1は、 リリース 20.4 の初期Junos OS表しています。

Junos XML <junoscript> version プロトコル サーバーの開始タグの次の例では、この属性はサーバーが Junos XML プロトコル バージョン 1.0 hostname を使用している状態を示し、属性はルーターの名前がビッグ デバイスかどうかを示しています。および os 属性は release 、デバイスがデバイスのリリース 20.4 の初期バージョン Junos OS示しています。この xmlns 属性は、XML タグ要素のデフォルトのJunos名前空間が http://xml.juniper.net/xnm/1.1/xnm .属性 xmlns:junos は、プレフィックスが付くタグ要素の名前空間が junos: http://xml.juniper.net/junos/20.4R1/junos .タグは複数の行に表示され、読み取れるのみです。

要素と<?xml?><junoscript>交換することで、クライアント アプリケーションと Junos XML プロトコル サーバーは、XML プロトコル セッション中に使用されるソフトウェアの異なるバージョンを実行Junos判断できます。バージョンが異なって互換性がない場合があります。XML プロトコルの表記規則によってJunosのソフトウェアを実行する当事者が、非互換性を処理する方法を決定します。完全に自動化されたパフォーマンスを実現するには、クライアント アプリケーションに、ソフトウェアのバージョンが現在の XML プロトコル サーバーよりも後にあるかどうかを判断するコードJunosします。アプリケーションのバージョンが最新の場合に適切なオプションを選択し、対応する応答を実装します。

• バージョンの変更Junosを無視し、XMLプロトコルサーバーへの対応に合わせてクライアントアプリケーションの動作Junos変更しません。バージョンの変更Junos、サーバーとクライアントの互換性がないわけではないため、これはよく有効なアプローチとなります。

• 標準動作を、標準 XML プロトコル サーバーと互換性Junos変更します。たとえば、クライアント アプリケーションが Junos OS の新しいバージョンを実行している場合は、Junos XML プロトコル サーバーのバージョンの Junos OS で使用可能なソフトウェア機能を表すタグ要素のみを送信できます。

• XML プロトコル Junosを終了し、接続を終了します。これは、XML プロトコル サーバーのソフトウェア バージョンをJunos現実的ではないと判断した場合に適しています。手順については、「 XML プロトコル セッションの 終了Junos接続を閉じる 」を参照してください。

表 1 は、Junos XML 管理プロトコルのバージョン 1.0 における Junos XML プロトコル セッション初期化中にバージョン情報を搬送するために使用する PI または開始タグおよび属性を指定します。

表 1: Junos XML プロトコル バージョン 1.0 PI および開始タグ

ソフトウェアとバージョン	PI またはタグ	属性
XML 1.0	<?xml?>	version="1.0"
ANSI 標準 7 ビット ASCII 文字セット	<?xml?>	encoding="us-ascii"
Junos XML プロトコル 1.0	<junoscript>	version="1.0"
Junos OS リリース	<junoscript>	release="m.nZb"例えば：release="10.3R1"