YANG モデルでは、機能の設定、ルータの運用状態の取得、およびアクションの実行が行われます。

（注）	gRPC YANG パスまたは JSON データは、YANG 名前空間ではなく、YANG モジュール名に基づいています。

(snippet)
module Cisco-IOS-XR-aaa-locald-cfg {

  /*** NAMESPACE / PREFIX DEFINITION ***/

  namespace "http://cisco.com/ns/yang/Cisco-IOS-XR-aaa-locald-cfg";


  prefix "aaa-locald-cfg";

  /*** LINKAGE (IMPORTS / INCLUDES) ***/

  import Cisco-IOS-XR-types { prefix "xr"; }

  import Cisco-IOS-XR-aaa-lib-cfg { prefix "a1"; }

  /*** META INFORMATION ***/

  organization "Cisco Systems, Inc.";
										.........................
										......................... (truncated)

例：AAA の運用 YANG モデル

運用データの取得に使用される YANG モデルは -oper と表記されます。

 (snippet)
module Cisco-IOS-XR-aaa-locald-oper {

  /*** NAMESPACE / PREFIX DEFINITION ***/

  namespace "http://cisco.com/ns/yang/Cisco-IOS-XR-aaa-locald-oper";


  prefix "aaa-locald-oper";

  /*** LINKAGE (IMPORTS / INCLUDES) ***/

  import Cisco-IOS-XR-types { prefix "xr"; }

  include Cisco-IOS-XR-aaa-locald-oper-sub1 {
    revision-date 2015-01-07;
  }

  /*** META INFORMATION ***/

  organization "Cisco Systems, Inc.";
				........................
				........................ (truncated)

（注）	1 つのモジュールにサブモジュールをいくつでも組み込むことができますが、各サブモジュールが属すことができるのは 1 つのモジュールのみです。すべての標準モジュールおよびサブモジュールの名前は一意である必要があります。

 (snippet)
clear ospfv3 1 vrf vrf1 statistics neighbor 2.2.2.2
RPC message based on the new ospfv3 yang model- 
 <rpc message-id="101" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
    <act-ospfv3-instance-vrf xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-ipv6-ospfv3-act">
      <instance>
        <instance-identifier>1</instance-identifier>
         <vrf>
          <vrf-name>vrf1</vrf-name>
          <stats>
           <neighbor>
            <neighbor-id>2.2.2.2</neighbor-id>
           </neighbor>
          </stats>
         </vrf>
      </instance>
    </act-ospfv3-instance-vrf>
 </rpc>

YANG データ モデルはノードのある階層型のツリーベース構造で表現できます。この表現により、モデルを簡単に理解できるようになります。

各機能には、スキーマから合成された定義済みの YANG モデルがあります。ツリー形式のモデルは次のとおりです。

• トップ レベル ノードおよびサブツリー

• 他の YANG モデル内でノードを拡張するサブツリー

• カスタム RPC

module: Cisco-IOS-XR-cdp-cfg
   +--rw cdp
      +--rw timer?               uint32
      +--rw advertise-v1-only?   empty
      +--rw enable?              boolean
      +--rw hold-time?           uint32
      +--rw log-adjacency?       empty
augment /a1:interface-configurations/a1:interface-configuration:
   +--rw cdp
      +--rw enable?   empty

augment "/a1:interface-configurations/a1:interface-configuration" {
    container cdp {
      description "Interface specific CDP configuration";
      leaf enable {
        type empty;
        description "Enable or disable CDP on an interface";
      }
    }
    description
      "This augment extends the configuration data of
      'Cisco-IOS-XR-ifmgr-cfg'";
  }
 

module: Cisco-IOS-XR-cdp-oper
   +--ro cdp
      +--ro nodes
         +--ro node* [node-name]
            +--ro neighbors
            |  +--ro details
            |  |  +--ro detail*
            |  |     +--ro interface-name?   xr:Interface-name
            |  |     +--ro device-id?        string
            |  |     +--ro cdp-neighbor*
            |  |        +--ro detail
            |  |        |  +--ro network-addresses
            |  |        |  |  +--ro cdp-addr-entry*
            |  |        |  |     +--ro address
            |  |        |  |        +--ro address-type?   Cdp-l3-addr-protocol
            |  |        |  |        +--ro ipv4-address?   inet:ipv4-address
            |  |        |  |        +--ro ipv6-address?   In6-addr
            |  |        |  +--ro protocol-hello-list
            |  |        |  |  +--ro cdp-prot-hello-entry*
            |  |        |  |     +--ro hello-message?   yang:hex-string
            |  |        |  +--ro version?               string
            |  |        |  +--ro vtp-domain?            string
            |  |        |  +--ro native-vlan?           uint32
            |  |        |  +--ro duplex?                Cdp-duplex
            |  |        |  +--ro system-name?           string
            |  |        +--ro receiving-interface-name?   xr:Interface-name
            |  |        +--ro device-id?                  string
            |  |        +--ro port-id?                    string
            |  |        +--ro header-version?             uint8
            |  |        +--ro hold-time?                  uint16
            |  |        +--ro capabilities?               string
            |  |        +--ro platform?                   string

............................................... (truncated)

この機能は、YANG モデルのユーザビリティに影響を与えるネイティブ ACL YANG モデルで特定されたいくつかの問題に対応します。次のネイティブ ACL YANG モデルでは、利便性と標準規格への準拠が改善されています。

• Cisco-IOS-XR-es-acl-cfg

• Cisco-IOS-XR-ipv4-acl-cfg

• Cisco-IOS-XR-ipv6-acl-cfg

この機能拡張の一部として、次の問題が解決されます。

• 改訂の日付と説明の不足

  問題：改訂が ACL モデルの YANG ファイルで変更されると、新しい改訂に関連する変更が正しく記述されない。

  解決策：以前のバージョンの情報を削除しなくても、以降の各バージョンで行った変更の説明が含まれるようになりました。

  Cisco-IOS-XR-ipv4-acl-cfg.yang の例：

  
   revision "2018-04-03" {
      description
        "6.5.1 revision. Correct enum value for Next-hop-type.";
    }       
            
    revision "2018-03-23" {
      description
        "6.5.1 revision. Removing none-next-type.";
    } 
  

• 文字列の無制限の使用

  問題：ACL ネイティブ モデルは string 型として定義されているリーフを使用するけれども、文字列の長さが定義されていないか、正しくない。

  解決策：パターンと長さのチェックが string 型を使用するリーフに追加されました。これにより、NETCONF は、コミット時に ACL の検証に依存するのではなく、これらのチェックを制御できます。

  次の例では、文字列の長さは 255 文字に制限され、英数字のみが許可されています。

  typedef my-base-str-type { type string {
  length "1..255";
  pattern "[0-9a-fA-F]*";
  } }

• 適切な説明文の不足

  問題：ネイティブ ACL モデルのほとんどのリーフには、適切な説明が入力されていない説明フィールドがあるため、YANG モデルの使いやすさと理解に影響している。

  解決策：リーフの説明フィールドが更新され、有用な情報を提供するようになりました。

• ACL 範囲リーフ間での検証の不足と一貫性のない動作

  問題：YANG モデルでは、上限値、下限値、および演算子リーフが指定されたコンテナでさまざまなリーフの組み合わせをサポートしている。その結果、CLI の観点から一部の設定が無効になる場合がある。

  解決策：ネイティブ ACL モデルは、YANG モデルでサポートされているさまざまなリーフの組み合わせを含めるように改善されました。また、すべての ACL 範囲のリーフ間の解析動作が一貫性を維持できるように配置されています。

• プロトコル演算子の入力と出力間の不整合

  問題：NETCONF 出力がユーザ入力と一致する必要がある。

  解決策：プロトコル演算子リーフを任意のものとするように変更し、equal に設定する必要はなくなりました。

NETCONF は、ネットワーク デバイスの設定をインストール、操作、または削除するためのメカニズムです。コンフィギュレーション データとプロトコル メッセージに Extensible Markup Language（XML）ベースのデータ符号化を使用します。NETCONF がポート 22 経由で XML サブシステムにアクセスできるようにするには、ssh server capability netconf-xml コマンドを使用します。NETCONF は、シンプルな RPC（リモート プロシージャ コール）ベースのメカニズムを使用してクライアントとサーバ間の通信を促進します。クライアントはネットワーク マネージャの一部として実行されているスクリプトやアプリケーションです。サーバは、ルータなどのネットワーク デバイスです。

NETCONF レイヤ

NETCONF は 4 つのレイヤに分割できます。

• コンテンツ レイヤ：設定および通知データが含まれます

• 動作レイヤ：XML で符号化されたパラメータによる RPC メソッドとして起動される一連の基本プロトコル動作を定義します

• メッセージ レイヤ：RPC と通知を符号化するためのシンプルな、トランスポート非依存のフレーミング メカニズムを提供します

• セキュア トランスポート レイヤ：クライアントとサーバ間の通信パスを提供します

NETCONF の詳細については、RFC 6241 を参照してください。

gRPC はオープンソースの RPC フレームワークです。これはプロトコル バッファ（Protobuf）に基づいたオープンソースのバイナリ シリアル化プロトコルです。gRPC は、XML などの構造化されたデータをシリアル化するための柔軟で効率的な自動メカニズムですが、小型で使いやすくなっています。ユーザは、.proto ファイルにプロトコル バッファ メッセージ タイプを定義することで構造を定義する必要があります。各プロトコル バッファ メッセージは、一連の名前と値のペアを含む情報の小型の論理レコードです。

gRPC は要求および応答をバイナリでエンコードします。gRPC は、Protobuf とともに他のコンテンツ タイプに拡張可能です。gRPC の Protobuf バイナリ データ オブジェクトは HTTP/2 を介して転送されます。

（注）	gRPC を有効にする前に TLS を設定することをお勧めします。gRPC プロトコルを有効にすると、TCP で TLS が有効になっていないデフォルトの HTTP/2 トランスポートが使用されます。gRPC では、すべての gRPC 要求に対して AAA 認証および認可が義務付けられています。TLS が設定されていない場合、認証クレデンシャルはネットワーク上で暗号化されずに転送されます。非 TLS モードは、セキュアな内部ネットワークでのみ使用できます。

gRPC はクライアントとサーバ間の分散型のアプリケーションやサービスをサポートします。gRPC はサーバとクライアント間の設定データと運用データを交換するためにデバイス管理サービスを構築するインフラストラクチャを提供します。そのデータの構造は YANG モデルによって定義されます。

Cisco gRPC IDL はプロトコル バッファ インターフェイス定義言語（IDL）を使用して、サービス方式を定義し、パラメータを定義し、プロトコル バッファ メッセージ タイプとしてタイプを返します。gRPC 要求はエンコードされ、JSON を使用してルータに送信されます。クライアントは、IDL で定義される RPC コールを起動してルータをプログラミングできます。

syntax = "proto3";
 
package IOSXRExtensibleManagabilityService;
 
service gRPCConfigOper {
 
    rpc GetConfig(ConfigGetArgs) returns(stream ConfigGetReply) {};
  
    rpc MergeConfig(ConfigArgs) returns(ConfigReply) {};
 
    rpc DeleteConfig(ConfigArgs) returns(ConfigReply) {};
 
    rpc ReplaceConfig(ConfigArgs) returns(ConfigReply) {};
 
    rpc CliConfig(CliConfigArgs) returns(CliConfigReply) {};
 
    rpc GetOper(GetOperArgs) returns(stream GetOperReply) {};
 
    rpc CommitReplace(CommitReplaceArgs) returns(CommitReplaceReply) {};
} 
message ConfigGetArgs {
     int64 ReqId = 1;
     string yangpathjson = 2;
}
 
message ConfigGetReply {
    int64 ResReqId = 1;
    string yangjson = 2;
    string errors = 3;
}
 
message GetOperArgs {
     int64 ReqId = 1;
     string yangpathjson = 2;
}
 
message GetOperReply {
    int64 ResReqId = 1;
    string yangjson = 2;
    string errors = 3;
}
 
message ConfigArgs {
    int64 ReqId = 1;
    string yangjson = 2;
 
}
 
message ConfigReply {
    int64 ResReqId = 1;
    string errors = 2;
}
 
message CliConfigArgs {
    int64 ReqId = 1;
    string cli = 2;
}
 
message CliConfigReply {
    int64 ResReqId = 1;
    string errors = 2;
}

message CommitReplaceArgs {
     int64 ReqId = 1;
     string cli = 2;
     string yangjson = 3;
}

message CommitReplaceReply {
     int64 ResReqId = 1;
     string errors = 2;
}

service gRPCExec {
    rpc ShowCmdTextOutput(ShowCmdArgs) returns(stream ShowCmdTextReply) {};
    rpc ShowCmdJSONOutput(ShowCmdArgs) returns(stream ShowCmdJSONReply) {};
    rpc ActionJSON(ActionJSONArgs) returns(stream ActionJSONReply) {};
}

message ShowCmdArgs {
     int64 ReqId = 1;
     string cli = 2;
}
 
message ShowCmdTextReply {
    int64 ResReqId =1;
    string output = 2;
    string errors = 3;
}

message ActionJSONArgs {
	int64 ReqId = 1;
	string yangpathjson = 2;
}

message ActionJSONReply {
	int64 ResReqId = 1;
	string yangjson = 2;
	string errors = 3;
}

service OpenConfiggRPC {
     rpc SubscribeTelemetry(SubscribeRequest) returns (stream SubscribeResponse) {};
     rpc UnSubscribeTelemetry(CancelSubscribeReq) returns (SubscribeResponse) {};
     rpc GetModels(GetModelsInput) returns (GetModelsOutput) {};
}

message GetModelsInput {
     uint64  requestId   = 1;
     string  name        = 2;
    string  namespace   = 3;
    string  version     = 4;
    enum MODLE_REQUEST_TYPE {
         SUMMARY = 0;
         DETAIL  = 1;
     }
     MODLE_REQUEST_TYPE requestType = 5;
}

message GetModelsOutput {
     uint64  requestId   = 1;
     message ModelInfo {
         string  name        = 1;
         string  namespace   = 2;
        string  version     = 3;
         GET_MODEL_TYPE  modelType = 4;
         string modelData = 5;
     }
     repeated ModelInfo models = 2;
     OC_RPC_RESPONSE_TYPE responseCode = 3;
     string msg = 4;
}