gNOI サービスの概要

概要 Junos デバイスは、このトピックで説明する gNOI サービスと RPC をサポートしています。

gRPCネットワーク運用インターフェイス(gNOI)は、ネットワークデバイスで運用コマンドを実行するためのサービスを定義します。OpenConfig は、proto 定義ファイル内の各サービスの操作(RPC)とデータ構造(メッセージ)を定義します。gNOI RPC の全リストを含む proto ファイルは、 https://github.com/openconfig/gnoi の OpenConfig gNOI GitHub リポジトリにあります。Junos デバイスは、以下のセクションで説明するように、サービスと RPC のサブセットをサポートします。

サポートされるサービスの概要

表 1 は、Junos デバイスでサポートされる gNOI サービスの概要を示しています。表は、proto ファイルの特定のバージョンのサポートが開始されるリリースを示しています。

表 1:サポートされている gNOI サービス
Proto	ファイルバージョン	のサポート開始サービスリリース
`CertificateManagement`	Junos OS Evolved リリース 22.2R1	0.2.0
`Diag`	Junos OS Evolved リリース 22.2R1	0.1.0
`File`	Junos OS Evolved リリース 22.2R1	0.1.0
`OS`	Junos OS Evolved リリース 22.2R1	0.1.1
`System`	Junos OS Evolved リリース 22.2R1	1.0.0

認定書管理サービス

表 2:サポートされている cert.proto RPC
リリースで導入された	RPC	の説明
`CanGenerateCSR()`	ターゲットデバイスにクエリーを実行して、指定されたキータイプ、キーサイズ、証明書タイプを持つ証明書署名要求(CSR)を生成できるかどうかを確認します。サポートされている値: キータイプ:KT_RSA 主要サイズ:1024、2048、4096 証明書の種類:CT_X509 gNOI サーバーが特定の `True` 鍵タイプ、鍵サイズ、および証明書タイプをサポートしているかどうかを返します。	Junos OS Evolved 23.1R1
`GenerateCSR()`	証明書署名要求(CSR)を生成して返します。	Junos OS Evolved 22.2R1
`GetCertificates()`	ターゲットデバイスに読み込まれたローカル証明書を返します。	Junos OS Evolved 22.2R1
`Install()`	CSR要求を作成し、CSRに基づいて証明書を生成し、新しい証明書IDを使用して証明書を読み込むことで、ターゲットデバイスに新しい証明書を読み込みます。	Junos OS Evolved 22.2R1
`LoadCertificate()`	対象のデバイスで認証機関(CA)によって署名された証明書を読み込みます。	Junos OS Evolved 22.2R1
`LoadCertificateAuthorityBundle()`	ターゲットデバイス上の CA 証明書バンドルを読み込みます。	Junos OS Evolved 22.2R1
`RevokeCertificates()`	ターゲットデバイスで指定された証明書 ID を持つ証明書を取り消します。	Junos OS Evolved 23.1R1
`Rotate()`	CSR要求を作成し、CSRに基づいて証明書を生成し、既存の証明書IDを使用して証明書を読み込むことで、ターゲットデバイス上の既存の証明書を置き換えます。	Junos OS Evolved 22.2R1

診断(診断)サービス

表 3:サポートされている diag.proto RPC
リリースで導入された	RPC	の説明
`StartBERT()`	一連のポートで BERT を起動します。Junos デバイスは、gNOI BERTs に対して以下の PRBS パターンをサポートしています。 PRBS7 PRBS9 PRBS15 PRBS23 PRBS31	Junos OS Evolved 22.2R1
`StopBert()`	一連のポートで、すでに進行中の BERT を停止します。	Junos OS Evolved 22.2R1
`GetBERTResult()`	BERT の実行中または完了後に BERT の結果を取得します。	Junos OS Evolved 22.2R1

ファイルサービス

表 4:サポートされている file.proto RPC
リリースで導入された	RPC	の説明
`Get()`	ターゲットからファイルの内容を読み取ってストリームします。ファイルは順次メッセージによってストリーミングされ、各メッセージには最大 64KB のデータが含まれます。最後のメッセージは、送信されたデータのハッシュを含むストリームを閉じる前に送信されます。この操作は、ファイルが存在しない場合、またはファイルを読み取るエラーがある場合にエラーを返します。	Junos OS Evolved 22.2R1
`Put()`	ターゲット上のファイルにデータをストリームします。ファイルは、最大64KBのデータを含む各メッセージに順次メッセージで送信されます。データのハッシュを含む最後のメッセージを送信する必要があります。この操作は、場所が存在しない場合、またはデータの書き込みエラーがある場合にエラーを返します。チェックサムを受信しなかった場合、ターゲットは部分的に送信されたファイルを削除します。障害が発生しても、同じ名前の既存のファイルは変更されません。	Junos OS Evolved 22.2R1
`Remove()`	ターゲットから指定されたファイルを削除します。この操作は、ファイルが存在しない場合、ファイル・パスがディレクトリーに解決された場合、または除去操作でエラーが発生した場合にエラーを返します。	Junos OS Evolved 22.2R1
`Stat()`	ターゲットデバイス上のファイルに関するメタデータを返します。この操作は、ファイルが存在しない場合、またはメタデータにアクセスするエラーがある場合にエラーを返します。	Junos OS Evolved 22.2R1

オペレーティングシステム(OS)サービス

表 5:サポートされている os.proto RPC
リリースで導入された	RPC	の説明
`Activate()`	次回の再起動時に使用する OS バージョンを設定します。 `Activate()` フラグが省略されたり、に設定されている場合 `no_reboot` にターゲットを再起動します `False`。再起動が要求されたOSバージョンを起動できない場合、ターゲットは以前のOSパッケージにロールバックします。メモ： Junosデバイスは、メッセージ内の `standby_supervisor` フィールドを `ActivateRequest` サポートしていません。	Junos OS Evolved 22.2R1
`Install()`	ターゲットにソフトウェアイメージを転送します。メモ： Junosデバイスは、メッセージ内の `standby_supervisor` フィールドを `TransferRequest` サポートしていません。	Junos OS Evolved 22.2R1
`Verify()`	実行中の OS バージョンを確認します。この RPC は、ターゲットが正常に起動されるまで、複数回呼び出される場合があります。メモ： Junos デバイスは VerifyResponse をサポート `verify_standby` していません。	Junos OS Evolved 22.2R1

システムサービス(Ping および Traceroute)

表 6:ネットワークのトラブルシューティングに対応した system.proto RPC
リリースで導入された	RPC	の説明
`Ping()`	デバイスに Ping を送信します。RPC は `Ping()` IPv4 および IPv6 ping をサポートします。この RPC は、ping の完了後に ping の結果をストリーミングします。デフォルトパケット数:5	Junos OS Evolved 22.2R1
`Traceroute()`	ターゲットデバイスで traceroute コマンドを実行し、結果をストリーミングバックします。デフォルトホップカウント:30	Junos OS Evolved 22.2R1

システムサービス(再起動)

表 7:再起動用にサポートされている system.proto RPC
リリースで導入された	RPC	の説明
`Reboot()`	ターゲットを再起動します。ターゲットに対して一度に 1 回だけ再起動要求を実行できます。オプションで、将来の再起動に遅延を設定し、サブコンポーネントを個別に再起動し、再起動の開始時にメッセージを追加することができます。遅延はナノ秒単位で設定されます。 Junos デバイスは、以下の再起動方法をサポートします。コールド(1) パワーダウン(2) 停止(3) 電源投入(7)	Junos OS Evolved 22.2R1
`RebootStatus()`	再起動のステータスを返します。	Junos OS Evolved 22.2R1
`CancelReboot()`	保留中の再起動要求をキャンセルします。	Junos OS Evolved 22.2R1

システムサービス(ソフトウェアアップグレード)

表 8:ソフトウェアアップグレードに対応した system.proto RPC
リリースで導入された	RPC	の説明
`SetPackage()`	ターゲットデバイスにソフトウェアイメージをインストールします。	Junos OS Evolved 22.2R1

システムサービス(ルーティングエンジンスイッチオーバー)

表 9:ルーティングエンジンスイッチオーバーでサポートされている system.proto RPC
リリースで導入された	RPC	の説明
`SwitchControlProcessor()`	現在のルーティングエンジンから指定されたルーティングエンジンに切り替えます。現在のルーティングエンジンと指定されたルーティングエンジンが同じ場合、それは NOOP です。ターゲットが存在しない場合、RPC はエラーを返します。メモ： Junos デバイスはに`SwitchControlProcessorResponse`対応`control_processor` していません。	Junos OS Evolved 22.2R1

このページで

gNOI サービスの概要

サポートされるサービスの概要

認定書管理サービス

診断(診断)サービス

ファイル サービス

オペレーティングシステム(OS)サービス

システム サービス

システム サービス(Ping および Traceroute)

システム サービス(再起動)

システム サービス(ソフトウェア アップグレード)