gRPC エージェントについて
Cisco NX-OS gRPC プロトコルは、ネットワーク デバイスを管理し、その構成データを取得してインストールするためのメカニズムを定義します。プロトコルは、クライアントがデバイス構成を管理するために使用できる完全で正式なアプリケーション プログラミング インターフェイス(API)を公開します。
Cisco NX-OS gRPC プロトコルは、リモート プロシージャ コール(RPC)パラダイムを使用します。このパラダイムでは、外部クライアントが、Google プロトコル バッファ(GPB)で定義された API コールとそのサービス固有の引数を使用してデバイス設定を操作します。これらの GPB 定義 API は、同じ GPB 定義 API コンテキストで応答を返すデバイスへの RPC コールを透過的に引き起こします。
gRPC エージェントは、TLS によるセキュアな転送と、AAA によるユーザー認証と認可を提供します。
Cisco NX-OS gRPC プロトコルの機能上の目的は、特にステートレスとステートフルの両方の構成操作に関して、NETCONF によって提供されるプロトコルをミラーリングして、運用の柔軟性を最大限に高めることです。
Cisco NX-OS gRPC エージェントは、次のプロトコル操作をサポートしています。
-
結果
-
GetConfig
-
GetOper
-
edit-config
-
start-session
-
CloseSession
-
kill-session
gRPC エージェントは、次の 2 種類の操作をサポートしています:
-
ステートレス操作は、セッションを作成せずに単一のメッセージ内で完全に実行されます。
-
ステートフル操作は、複数のメッセージを使用して実行されます。実行される動作のシーケンスは、次のとおりです:
-
セッションを開始します。このアクションは、一意のセッション ID を取得します。
-
セッション ID を使用してセッションタスクを実行します。
-
セッションを終了します。このアクションにより、セッション ID が無効になります。
-
次にあるのは、サポートされている操作です。gRPC エージェントによってエクスポートされる .proto ファイルの RPC 定義については、付録を参照してください。
動作 |
説明 |
---|---|
start-session |
クライアントとサーバー間の新しいセッションを開始し、一意のセッション ID を取得します。 |
edit-config |
指定された YANG データ サブセットをターゲット データストアに書き込みます。 |
GetConfig |
送信元データストアから指定された YANG 構成データのサブセットを取得します。 |
GetOper |
送信元データストアから指定された YANG 動作データを取得します。 |
結果 |
指定された YANG 構成および動作データを送信元データストアから取得します。 |
KillSession |
セッションを強制終了します。 |
CloseSession |
セッションの適切な終了を要求します。 |
GetConfig、GetOper、および Get はステートレス操作であるため、セッション ID は必要ありません。
EditConfig は、ステートレスまたはステートフルのいずれかです。ステートレス操作の場合は、SessionID を 0 に指定します。ステートフル操作の場合、有効な(ゼロ以外の)SessionID が必要です。
gRPC エージェントは、セッションのタイムアウトをサポートします。セッションのアイドル タイムアウトはデバイスで構成できます。アイドル セッションは終了して削除されます。