gNOIサービスの概要

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

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

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

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

表1:サポートされているgNOIサービス
サービス	リリース開始サポート	プロトファイルバージョン
`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
`Layer2`	Junos OSおよびJunos OS Evolvedリリース24.2R1	0.1.0
`LinkQualification`	Junos OS Evolved 25.2X100D20	1.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 BERTに対して以下のPRBSパターンをサポートしています。 PRBS7 PRBS9 PRBS15 PRBS23 PRBS31	Junos OS Evolved 22.2R1
`StopBert()`	一連のポートですでに進行中のBERTを停止します。	Junos OS Evolved 22.2R1
`GetBERTResult()`	BERT中または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

レイヤー2サービス

表5:サポートされているlayer2.proto RPC
RPC	説明	リリースで導入
`ClearLLDPInterface()`	指定されたインターフェイスのすべてのLLDPネイバーをクリアします。	Junos OSおよびJunos OS Evolved 24.2R1

リンク資格サービス

表6:サポートされているLinkQualification RPC
RPC	説明	リリースで導入
`Capabilities‎()`	デバイスがテストを実行するための要件を満たしているかどうかを返します。	Junos OS Evolved 25.2X100D20
`Create()`	一連のインターフェイスでPBLQテストを開始します。	Junos OS Evolved 25.2X100D20
`Get()`	テストの結果を返します。	Junos OS Evolved 25.2X100D20
`List()`	指定されたインターフェイスで使用可能なテストの結果を一覧表示します。	Junos OS Evolved 25.2X100D20
`Delete()`	指定されたテストとその結果を削除します。テストが進行中の場合、この RPC はテストをキャンセルしてから削除します。	Junos OS Evolved 25.2X100D20

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

表7:サポートされているos.proto RPC
RPC	説明	リリースで導入
`Activate()`	次回の再起動時に使用するソフトウェアバージョンを設定します。 `Activate()no_reboot`フラグが省略されているか、`False`に設定されている場合、ターゲットを再起動します。再起動で要求されたソフトウェアバージョンの起動に失敗した場合、ターゲットは以前のバージョンにロールバックします。注: Junosデバイスは、`ActivateRequest`メッセージの`standby_supervisor` フィールドをサポートしていません。注: Junos OS Evolved リリース 25.2R1 より前は、 `Activate()` は現在の設定をソフトウェアと照合して検証し、ソフトウェアをインストールし、ソフトウェアバージョンを次のブートバージョンとして設定します。	Junos OS Evolved 22.2R1
`Install()`	ソフトウェアインストールパッケージをターゲットに転送し、ソフトウェアに対する設定を検証し、ソフトウェアをインストール(ステージング)します。指定したソフトウェアイメージがデバイスに既にインストールされている場合は、現在の設定をソフトウェアイメージと照らし合わせて検証し、検証済みの設定をそのソフトウェアバージョンに関連付けられた実行中の設定として保存します。注: Junosデバイスは、`TransferRequest`メッセージの`standby_supervisor` フィールドをサポートしていません。注: Junos OS Evolvedリリース25.2R1より前は、 `Install()` はソフトウェアインストールパッケージをターゲットにのみ転送します。	Junos OS Evolved 22.2R1
`Verify()`	実行中のソフトウェアのバージョンを確認してください。このRPCは、ターゲットが成功するまで起動中に複数回呼び出されることがあります。注: Junosデバイスは、VerifyResponseの `verify_standby` をサポートしていません。	Junos OS Evolved 22.2R1

システムサービス(pingおよびtraceroute)

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

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

表 9: 再起動時にサポートされている 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

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

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

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

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