[要約] RFC 8346は、Layer 3トポロジーのためのYANGデータモデルを提供しています。その目的は、ネットワーク機器の設定や管理において、Layer 3トポロジー情報を効果的に表現することです。
Internet Engineering Task Force (IETF) A. Clemm
Request for Comments: 8346 Huawei
Category: Standards Track J. Medved
ISSN: 2070-1721 Cisco
R. Varga
Pantheon Technologies SRO
X. Liu
Jabil
H. Ananthakrishnan
Packet Design
N. Bahadur
Bracket Computing
March 2018
A YANG Data Model for Layer 3 Topologies
レイヤー3トポロジのYANGデータモデル
Abstract
概要
This document defines a YANG data model for Layer 3 network topologies.
このドキュメントでは、レイヤ3ネットワークトポロジのYANGデータモデルを定義します。
Status of This Memo
本文書の状態
This is an Internet Standards Track document.
これはInternet Standards Trackドキュメントです。
This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841.
このドキュメントは、IETF（Internet Engineering Task Force）の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ（IESG）による公開が承認されました。インターネット標準の詳細については、RFC 7841のセクション2をご覧ください。
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc8346.
このドキュメントの現在のステータス、エラータ、およびフィードバックの提供方法に関する情報は、https：//www.rfc-editor.org/info/rfc8346で入手できます。
Copyright Notice
著作権表示
Copyright (c) 2018 IETF Trust and the persons identified as the document authors. All rights reserved.
Copyright（c）2018 IETF Trustおよびドキュメントの作成者として識別された人物。全著作権所有。
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.
この文書は、BCP 78およびIETF文書に関するIETFトラストの法的規定（https://trustee.ietf.org/license-info）の対象であり、この文書の発行日に有効です。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。
Table of Contents
目次
1. Introduction ....................................................3
2. Key Words .......................................................3
3. Definitions and Acronyms ........................................4
4. Model Structure .................................................5
5. Layer 3 Unicast Topology Model Overview .........................6
6. Layer 3 Unicast Topology YANG Module ............................7
7. Interactions with Other YANG Modules ...........................15
8. IANA Considerations ............................................15
9. Security Considerations ........................................16
10. References ....................................................17
10.1. Normative References .....................................17
10.2. Informative References ...................................19
Appendix A. Companion YANG Data Model for Implementations Not
Compliant with NMDA ..................................20
Appendix B. Extending the Model ..................................24
B.1. Example OSPF Topology .....................................24
B.1.1. Model Overview ........................................24
B.1.2. OSPF Topology YANG Module .............................26
Appendix C. An Example ...........................................29
Acknowledgments ...................................................34
Contributors ......................................................34
Authors' Addresses ................................................35
This document introduces a YANG [RFC7950] [RFC6991] data model for Layer 3 (L3) network topologies, specifically Layer 3 Unicast. The model allows an application to have a holistic view of the topology of a Layer 3 network, all contained in a single conceptual YANG datastore. The data model builds on top of, and augments, the data model for network topologies defined in [RFC8345].
このドキュメントでは、レイヤー3（L3）ネットワークトポロジ、特にレイヤー3ユニキャストのYANG [RFC7950] [RFC6991]データモデルを紹介します。このモデルにより、アプリケーションはレイヤー3ネットワークのトポロジの全体像を把握でき、すべてが単一の概念的なYANGデータストアに含まれます。データモデルは、[RFC8345]で定義されているネットワークトポロジのデータモデルの上に構築され、それを補強します。
This document also shows how the model can be further refined to cover different Layer 3 Unicast topology types. For this purpose, an example model is introduced that covers OSPF [RFC2328]. This example is intended purely for illustrative purpose; we expect that a complete OSPF model will be more comprehensive and refined than the example shown in this document.
このドキュメントでは、モデルをさらに改良して、さまざまなレイヤー3ユニキャストトポロジタイプをカバーする方法も示します。この目的のために、OSPF [RFC2328]をカバーするモデル例が紹介されています。この例は、純粋に例示を目的としています。完全なOSPFモデルは、このドキュメントに示されている例よりも包括的で洗練されていると予想されます。
There are multiple applications for a topology data model. A number of use cases have been defined in Section 6 of [USECASE-REQS]. For example, nodes within the network can use the data model to capture their understanding of the overall network topology and expose it to a network controller. A network controller can then use the instantiated topology data to compare and reconcile its own view of the network topology with that of the network elements that it controls. Alternatively, nodes within the network could propagate this understanding to compare and reconcile this understanding either amongst themselves or with help of a controller. Beyond the network element itself, a network controller might even use the data model to represent its view of the topology that it controls and expose it to applications north of itself.
トポロジデータモデルには複数のアプリケーションがあります。 [USECASE-REQS]のセクション6では、多くのユースケースが定義されています。たとえば、ネットワーク内のノードは、データモデルを使用して、ネットワークトポロジ全体の理解を取り込み、それをネットワークコントローラーに公開できます。次に、ネットワークコントローラーは、インスタンス化されたトポロジデータを使用して、ネットワークトポロジーの独自のビューを、それが制御するネットワーク要素のビューと比較および調整できます。あるいは、ネットワーク内のノードは、この理解を伝播して、それらの間で、またはコントローラーの助けを借りて、この理解を比較および調整できます。ネットワークコントローラー自体のほかに、ネットワークコントローラーはデータモデルを使用して、制御するトポロジーのビューを表し、それ自体の北にあるアプリケーションに公開する場合もあります。
The data model for Layer 3 Unicast topologies defined in this document is specified in the YANG module "ietf-l3-unicast-topology". This YANG module augments the general network topology model defined in [RFC8345] with information specific to Layer 3 Unicast. In this way, the general topology model is extended to be able to meet the needs of Layer 3 Unicast topologies.
このドキュメントで定義されているレイヤ3ユニキャストトポロジのデータモデルは、YANGモジュール「ietf-l3-unicast-topology」で指定されています。このYANGモジュールは、[RFC8345]で定義されている一般的なネットワークトポロジモデルを、レイヤー3ユニキャストに固有の情報で補強します。このようにして、一般的なトポロジモデルは、レイヤ3ユニキャストトポロジのニーズを満たすことができるように拡張されます。
Information that is kept in the Traffic Engineering Database (TED) will be specified in a separate model [YANG-TE] and is outside the scope of this specification.
トラフィックエンジニアリングデータベース（TED）に保持される情報は、別のモデル[YANG-TE]で指定され、この仕様の範囲外です。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
キーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「NOT RECOMMENDED」、「MAY」、「OPTIONALこのドキュメントの「」は、BCP 14 [RFC2119] [RFC8174]で説明されているように解釈されます。
This document defines a YANG data model and thus uses many terms defined in YANG [RFC7950] and NETCONF [RFC6241]. Some terms, such as "datastore" and "data tree", are repeated here for clarity and context.
このドキュメントでは、YANGデータモデルを定義しているため、YANG [RFC7950]およびNETCONF [RFC6241]で定義されている多くの用語を使用しています。 「データストア」や「データツリー」などのいくつかの用語は、ここではわかりやすくするために繰り返し使用されています。
Datastore: A conceptual place to store and access information. A datastore might be implemented, for example, using files, a database, flash memory locations, or combinations thereof. A datastore maps to an instantiated YANG data tree (definition adopted from [RFC8342]).
データストア：情報を保存してアクセスするための概念的な場所。データストアは、たとえば、ファイル、データベース、フラッシュメモリの場所、またはそれらの組み合わせを使用して実装できます。データストアは、インスタンス化されたYANGデータツリーにマップします（[RFC8342]から採用された定義）。
Data subtree: An instantiated data node and the data nodes that are hierarchically contained within it.
データサブツリー：インスタンス化されたデータノードと、その中に階層的に含まれているデータノード。
IS-IS: Intermediate System to Intermediate System protocol
IS-IS：Intermediate System to Intermediate Systemプロトコル
LSP: Label Switched Path
LSP：ラベルスイッチドパス
NETCONF: Network Configuration Protocol
NETCONF：ネットワーク構成プロトコル
NMDA: Network Management Datastore Architecture
NMDA：ネットワーク管理データストアアーキテクチャ
OSPF: Open Shortest Path First (a link-state routing protocol)
OSPF：Open Shortest Path First（リンクステートルーティングプロトコル）
URI: Uniform Resource Identifier
うり： うにふぉｒｍ れそうｒせ いでんちふぃえｒ
TED: Traffic Engineering Database
TED：交通工学データベース
YANG: YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols [RFC7950].
YANG：YANGは、構成データ、状態データ、リモートプロシージャコール、およびネットワーク管理プロトコル[RFC7950]の通知をモデル化するために使用されるデータモデリング言語です。
The Layer 3 Unicast topology model is defined by YANG module "l3-unicast-topology". The relationship of this module with other YANG modules is roughly depicted in the figure below.
レイヤ3ユニキャストトポロジモデルは、YANGモジュール「l3-unicast-topology」によって定義されています。このモジュールと他のYANGモジュールとの関係は、下の図に大まかに示されています。
+-----------------------------+
| +-----------------------+ |
| | ietf-network | |
| +----------^------------+ |
| | |
| +-----------------------+ |
| | ietf-network-topology | |
| +----------+------------+ |
+-------------^---------------+
|
|
+------------^-------------+
| ietf-l3-unicast-topology |
+------------^-------------+
|
|
+-----------^-----------+
| example-ospf-topology |
+-----------------------+
Figure 1: Overall Model Structure
図1：モデル全体の構造
YANG modules "ietf-network" and "ietf-network-topology" collectively define the basic network topology model [RFC8345]. YANG module "ietf-l3-unicast-topology" augments those models with additional definitions needed to represent Layer 3 Unicast topologies. This module in turn can be augmented by YANG modules with additional definitions for specific types of Layer 3 Unicast topologies, such as OSPF and IS-IS topologies.
YANGモジュール「ietf-network」と「ietf-network-topology」は、基本的なネットワークトポロジモデル[RFC8345]をまとめて定義します。 YANGモジュール「ietf-l3-unicast-topology」は、レイヤー3ユニキャストトポロジを表すために必要な追加の定義でこれらのモデルを補強します。このモジュールは、OSPFトポロジーやIS-ISトポロジーなど、特定のタイプのレイヤー3ユニキャストトポロジーの追加定義を使用して、YANGモジュールによって拡張できます。
The YANG modules "ietf-network" and "ietf-network-topology" are designed to be used in conjunction with implementations that support the Network Management Datastore Architecture (NMDA) defined in [RFC8342]. Accordingly, the same is true for the YANG modules that augment it. In order to allow implementations to use the model even in cases when NMDA is not supported, companion YANG modules (that SHOULD NOT be supported by implementations that support NMDA) are defined in Appendix A.
YANGモジュール「ietf-network」と「ietf-network-topology」は、[RFC8342]で定義されているネットワーク管理データストアアーキテクチャ（NMDA）をサポートする実装と組み合わせて使用するように設計されています。したがって、それを補強するYANGモジュールについても同じことが言えます。 NMDAがサポートされていない場合でも実装がモデルを使用できるようにするために、コンパニオンYANGモジュール（NMDAをサポートする実装ではサポートされるべきではない）が付録Aで定義されています。
The Layer 3 Unicast topology model is defined by YANG module "ietf-l3-unicast-topology". Its structure is depicted in the following diagram. The notation syntax follows [RFC8340]. For purposes of brevity, notifications are not depicted.
レイヤ3ユニキャストトポロジモデルは、YANGモジュール「ietf-l3-unicast-topology」によって定義されています。その構造を次の図に示します。表記構文は[RFC8340]に従います。簡潔にするため、通知は表示されていません。
module: ietf-l3-unicast-topology
augment /nw:networks/nw:network/nw:network-types:
+--rw l3-unicast-topology!
augment /nw:networks/nw:network:
+--rw l3-topology-attributes
+--rw name? string
+--rw flag* l3-flag-type
augment /nw:networks/nw:network/nw:node:
+--rw l3-node-attributes
+--rw name? inet:domain-name
+--rw flag* node-flag-type
+--rw router-id* rt-types:router-id
+--rw prefix* [prefix]
+--rw prefix inet:ip-prefix
+--rw metric? uint32
+--rw flag* prefix-flag-type
augment /nw:networks/nw:network/nt:link:
+--rw l3-link-attributes
+--rw name? string
+--rw flag* link-flag-type
+--rw metric1? uint64
+--rw metric2? uint64
augment /nw:networks/nw:network/nw:node/nt:termination-point:
+--rw l3-termination-point-attributes
+--rw (termination-point-type)?
+--:(ip)
| +--rw ip-address* inet:ip-address
+--:(unnumbered)
| +--rw unnumbered-id? uint32
+--:(interface-name)
+--rw interface-name? string
The module augments the original "ietf-network" and "ietf-network-topology" modules as follows:
このモジュールは、元の「ietf-network」および「ietf-network-topology」モジュールを次のように拡張します。
o A new network topology type is introduced, l3-unicast-topology. The corresponding container augments the network-types of the "ietf-network" module.
o 新しいネットワークトポロジタイプであるl3-unicast-topologyが導入されました。対応するコンテナは、「ietf-network」モジュールのネットワークタイプを拡張します。
o Additional topology attributes are introduced, defined in a grouping that augments the "network" list of the network module. The attributes include a name for the topology and a set of flags (represented by a leaf-list). Each type of flag is represented by a separate identity. This allows additional flags to be introduced in augmenting modules using additional identities without needing to revise this module.
o 追加のトポロジ属性が導入され、ネットワークモジュールの「ネットワーク」リストを補強するグループで定義されています。属性には、トポロジの名前と一連のフラグ（リーフリストで表される）が含まれます。フラグの各タイプは、個別のIDで表されます。これにより、このモジュールを修正する必要なく、追加のIDを使用して拡張モジュールに追加のフラグを導入できます。
o Additional data objects for nodes are introduced by augmenting the "node" list of the network module. New objects include a set of flags and a list of prefixes. Each prefix includes an IP prefix, a metric, and a prefix-specific set of flags.
o ノードの追加のデータオブジェクトは、ネットワークモジュールの「ノード」リストを拡張することによって導入されます。新しいオブジェクトには、フラグのセットとプレフィックスのリストが含まれます。各プレフィックスには、IPプレフィックス、メトリック、およびプレフィックス固有のフラグのセットが含まれます。
o Links (in the "ietf-network-topology" module) are augmented with a set of parameters that allow a link to be associated with a link name, another set of flags, and a link metric.
o リンク（「ietf-network-topology」モジュール内）は、リンクをリンク名、フラグの別のセット、およびリンクメトリックに関連付けることができるパラメータのセットで拡張されます。
o Termination points (in the "ietf-network-topology" module) are augmented with a choice of IP address, identifier, or name.
o 終端ポイント（「ietf-network-topology」モジュール内）には、IPアドレス、識別子、または名前の選択が追加されています。
In addition, the module defines a set of notifications to alert clients of any events concerning links, nodes, prefixes, and termination points. Each notification includes an indication of the type of event, the topology from which it originated, and the affected node, link, prefix, or termination point. Also, as a convenience to applications, additional data of the affected node, link, prefix, or termination point is included. While this makes notifications larger in volume than they need to be, it avoids the need for subsequent retrieval of context information that might have changed in the meantime.
さらに、モジュールは一連の通知を定義して、リンク、ノード、プレフィックス、および終了ポイントに関するイベントをクライアントに警告します。各通知には、イベントのタイプ、イベントの発生元のトポロジ、影響を受けるノード、リンク、プレフィックス、または終了ポイントが含まれます。また、アプリケーションの便宜上、影響を受けるノード、リンク、プレフィックス、または終端ポイントの追加データが含まれています。これにより、通知の量が必要以上に大きくなりますが、それまでの間変更された可能性のあるコンテキスト情報を後で取得する必要がなくなります。
This YANG module makes reference to the following documents: [RFC2863] and [RFC8343].
このYANGモジュールは、次のドキュメントを参照します：[RFC2863]および[RFC8343]。
<CODE BEGINS> file "ietf-l3-unicast-topology@2018-02-26.yang"
module ietf-l3-unicast-topology {
yang-version 1.1;
namespace
"urn:ietf:params:xml:ns:yang:ietf-l3-unicast-topology";
prefix "l3t";
import ietf-network {
prefix "nw";
}
import ietf-network-topology {
prefix "nt";
}
import ietf-inet-types {
prefix "inet";
}
import ietf-routing-types {
prefix "rt-types";
}
organization
"IETF I2RS (Interface to the Routing System) Working Group";
contact
"WG Web: <https://datatracker.ietf.org/wg/i2rs/>
WG List: <mailto:i2rs@ietf.org>
Editor: Alexander Clemm
<mailto:ludwig@clemm.org>
Editor: Jan Medved
<mailto:jmedved@cisco.com>
Editor: Robert Varga
<mailto:robert.varga@pantheon.tech>
Editor: Xufeng Liu
<mailto:xufeng.liu.ietf@gmail.com>
Editor: Nitin Bahadur
<mailto:nitin_bahadur@yahoo.com>
Editor: Hariharan Ananthakrishnan
<mailto:hari@packetdesign.com>";
description
"This module defines a model for Layer 3 Unicast
topologies.
Copyright (c) 2018 IETF Trust and the persons identified as authors of the code. All rights reserved.
Copyright（c）2018 IETF Trustおよびコードの作成者として識別された人物。全著作権所有。
Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info).
ソースおよびバイナリ形式での再配布および使用は、変更の有無にかかわらず、IETF文書に関連するIETFトラストの法的規定のセクション4.cに記載されているSimplified BSD Licenseに従い、それに含まれるライセンス条項に従って許可されます（ https://trustee.ietf.org/license-info）。
This version of this YANG module is part of
RFC 8346; see the RFC itself for full legal notices.";
revision "2018-02-26" {
description
"Initial revision.";
reference
"RFC 8346: A YANG Data Model for Layer 3 Topologies";
}
identity flag-identity {
description "Base type for flags";
}
｝
typedef l3-event-type {
type enumeration {
enum "add" {
description
"A Layer 3 node, link, prefix, or termination point has
been added";
}
enum "remove" {
description
"A Layer 3 node, link, prefix, or termination point has
been removed";
}
enum "update" {
description
"A Layer 3 node, link, prefix, or termination point has
been updated";
}
}
description "Layer 3 event type for notifications";
}
typedef prefix-flag-type {
type identityref {
base "flag-identity";
}
description "Prefix flag attributes";
}
typedef node-flag-type {
type identityref {
base "flag-identity";
}
description "Node flag attributes";
}
typedef link-flag-type {
type identityref {
base "flag-identity";
}
description "Link flag attributes";
}
typedef l3-flag-type {
type identityref {
base "flag-identity";
}
description "L3 flag attributes";
}
grouping l3-prefix-attributes {
description
"L3 prefix attributes";
leaf prefix {
type inet:ip-prefix;
description
"IP prefix value";
}
leaf metric {
type uint32;
description
"Prefix metric";
}
leaf-list flag {
type prefix-flag-type;
description
"Prefix flags";
}
}
grouping l3-unicast-topology-type {
description "Identifies the topology type to be L3 Unicast.";
container l3-unicast-topology {
presence "indicates L3 Unicast topology";
description
"The presence of the container node indicates L3 Unicast
topology";
}
}
grouping l3-topology-attributes {
description "Topology scope attributes";
container l3-topology-attributes {
description "Contains topology attributes";
leaf name {
type string;
description
"Name of the topology";
}
leaf-list flag {
type l3-flag-type;
description
"Topology flags";
}
}
}
grouping l3-node-attributes {
description "L3 node scope attributes";
container l3-node-attributes {
description
"Contains node attributes";
leaf name {
type inet:domain-name;
description
"Node name";
}
leaf-list flag {
type node-flag-type;
description
"Node flags";
}
leaf-list router-id {
type rt-types:router-id;
description
"Router-id for the node";
}
list prefix {
key "prefix";
description
"A list of prefixes along with their attributes";
uses l3-prefix-attributes;
}
}
}
grouping l3-link-attributes {
description
"L3 link scope attributes";
container l3-link-attributes {
description
"Contains link attributes";
leaf name {
type string;
description
"Link Name";
}
leaf-list flag {
type link-flag-type;
description
"Link flags";
}
leaf metric1 {
type uint64;
description
"Link Metric 1";
}
leaf metric2 {
type uint64;
description
"Link Metric 2";
}
}
}
grouping l3-termination-point-attributes {
description "L3 termination point scope attributes";
container l3-termination-point-attributes {
description
"Contains termination point attributes";
choice termination-point-type {
description
"Indicates the termination point type";
case ip {
leaf-list ip-address {
type inet:ip-address;
description
"IPv4 or IPv6 address.";
}
}
case unnumbered {
leaf unnumbered-id {
type uint32;
description
"Unnumbered interface identifier.
The identifier will correspond to the ifIndex value
of the interface, i.e., the ifIndex value of the
ifEntry that represents the interface in
implementations where the Interfaces Group MIB
(RFC 2863) is supported.";
reference
"RFC 2863: The Interfaces Group MIB";
}
}
case interface-name {
leaf interface-name {
type string;
description
"Name of the interface. The name can (but does not
have to) correspond to an interface reference of a
containing node's interface, i.e., the path name of a
corresponding interface data node on the containing
node reminiscent of data type interface-ref defined
in RFC 8343. It should be noted that data type
interface-ref of RFC 8343 cannot be used directly,
as this data type is used to reference an interface
in a datastore of a single node in the network, not
to uniquely reference interfaces across a network.";
reference
"RFC 8343: A YANG Data Model for Interface Management";
}
}
}
}
}
augment "/nw:networks/nw:network/nw:network-types" {
description
"Introduces new network type for L3 Unicast topology";
uses l3-unicast-topology-type;
}
augment "/nw:networks/nw:network" {
when "nw:network-types/l3t:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description
"L3 Unicast for the network as a whole";
uses l3-topology-attributes;
}
augment "/nw:networks/nw:network/nw:node" {
when "../nw:network-types/l3t:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description
"L3 Unicast node-level attributes ";
uses l3-node-attributes;
}
augment "/nw:networks/nw:network/nt:link" {
when "../nw:network-types/l3t:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description
"Augments topology link attributes";
uses l3-link-attributes;
}
augment "/nw:networks/nw:network/nw:node/"
+"nt:termination-point" {
when "../../nw:network-types/l3t:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description "Augments topology termination point configuration";
uses l3-termination-point-attributes;
}
notification l3-node-event {
description
"Notification event for L3 node";
leaf l3-event-type {
type l3-event-type;
description
"Event type";
}
uses nw:node-ref;
uses l3-unicast-topology-type;
uses l3-node-attributes;
}
notification l3-link-event {
description
"Notification event for L3 link";
leaf l3-event-type {
type l3-event-type;
description
"Event type";
}
uses nt:link-ref;
uses l3-unicast-topology-type;
uses l3-link-attributes;
}
notification l3-prefix-event {
description
"Notification event for L3 prefix";
leaf l3-event-type {
type l3-event-type;
description
"Event type";
}
uses nw:node-ref;
uses l3-unicast-topology-type;
container prefix {
description
"Contains L3 prefix attributes";
uses l3-prefix-attributes;
}
}
notification termination-point-event {
description
"Notification event for L3 termination point";
leaf l3-event-type {
type l3-event-type;
description
"Event type";
}
uses nt:tp-ref;
uses l3-unicast-topology-type;
uses l3-termination-point-attributes;
}
}
<CODE ENDS>
<コード終了>
As described in Section 4, the model defined in this document builds on top of, and augments, the YANG modules defined in [RFC8345]. Specifically, the "ietf-l3-unicast-topology" module augments the "ietf-network" and "ietf-network-topology" modules. In addition, the model makes use of data types defined in [RFC6991].
セクション4で説明されているように、このドキュメントで定義されているモデルは、[RFC8345]で定義されているYANGモジュールの上に構築され、拡張されています。具体的には、「ietf-l3-unicast-topology」モジュールは「ietf-network」および「ietf-network-topology」モジュールを補強します。さらに、モデルは[RFC6991]で定義されたデータ型を利用します。
The model defined in this document is a protocol-independent YANG data model with Layer 3 topology information. It is separate from and not linked with data models that are used to configure routing protocols or routing information, e.g., "ietf-routing" [RFC8022] and "ietf-rib-extension" [YANG-RIB]. That said, the model does import a type definition from model "ietf-routing-types" [RFC8294].
このドキュメントで定義されているモデルは、プロトコルに依存しないYANGデータモデルであり、レイヤ3トポロジ情報を備えています。 「ietf-routing」[RFC8022]や「ietf-rib-extension」[YANG-RIB]など、ルーティングプロトコルやルーティング情報の構成に使用されるデータモデルとは別のものであり、リンクされていません。とはいえ、モデルはモデル「ietf-routing-types」[RFC8294]から型定義をインポートします。
The model complies with the requirements for the ephemeral state found in [RFC8242]. For ephemeral topology data that is server provided, the process tasked with maintaining topology information will load information from the routing process (such as OSPF) into the data model without relying on a configuration datastore.
モデルは、[RFC8242]にある一時的な状態の要件に準拠しています。サーバーが提供する一時的なトポロジデータの場合、トポロジ情報の維持を担当するプロセスは、構成データストアに依存することなく、ルーティングプロセス（OSPFなど）からデータモデルに情報をロードします。
This document registers the following namespace URIs in the "IETF XML Registry" [RFC3688]:
このドキュメントでは、「IETF XMLレジストリ」[RFC3688]に次の名前空間URIを登録しています。
URI: urn:ietf:params:xml:ns:yang:ietf-l3-unicast-topology Registrant Contact: The IESG. XML: N/A; the requested URI is an XML namespace.
URI：urn：ietf：params：xml：ns：yang：ietf-l3-unicast-topology登録者の連絡先：IESG。 XML：なし。要求されたURIはXML名前空間です。
URI: urn:ietf:params:xml:ns:yang:ietf-l3-unicast-topology-state Registrant Contact: The IESG. XML: N/A; the requested URI is an XML namespace.
URI：urn：ietf：params：xml：ns：yang：ietf-l3-unicast-topology-state登録者の連絡先：IESG。 XML：なし。要求されたURIはXML名前空間です。
This document registers the following YANG modules in the "YANG Module Names" registry [RFC6020]:
このドキュメントでは、「YANGモジュール名」レジストリ[RFC6020]に次のYANGモジュールを登録しています。
Name: ietf-l3-unicast-topology
Namespace: urn:ietf:params:xml:ns:yang:ietf-l3-unicast-topology
Prefix: l3t
Reference: RFC 8346
Name: ietf-l3-unicast-topology-state
Namespace: urn:ietf:params:xml:ns:yang:ietf-l3-unicast-topology-state
Prefix: l3t-s
Reference: RFC 8346
The YANG modules specified in this document define a schema for data that is designed to be accessed via network management protocols such as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer is the secure transport layer, and the mandatory-to-implement secure transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer is HTTPS, and the mandatory-to-implement secure transport is TLS [RFC5246].
このドキュメントで指定されているYANGモジュールは、NETCONF [RFC6241]やRESTCONF [RFC8040]などのネットワーク管理プロトコルを介してアクセスするように設計されたデータのスキーマを定義します。最下層のNETCONF層はセキュアなトランスポート層であり、実装に必須のセキュアなトランスポートはセキュアシェル（SSH）[RFC6242]です。最も低いRESTCONF層はHTTPSであり、実装に必須のセキュアなトランスポートはTLS [RFC5246]です。
The NETCONF access control model [RFC8341] provides the means to restrict access for particular NETCONF or RESTCONF users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content.
NETCONFアクセス制御モデル[RFC8341]は、特定のNETCONFまたはRESTCONFユーザーのアクセスを、利用可能なすべてのNETCONFまたはRESTCONFプロトコル操作およびコンテンツの事前構成されたサブセットに制限する手段を提供します。
In general, Layer 3 Unicast topologies are system-controlled and provide ephemeral topology information. In an NMDA-compliant server, they are only part of <operational>, which provides read-only access to clients, so they are less vulnerable. That said, the YANG modules do in principle allow information to be configurable.
一般に、レイヤ3ユニキャストトポロジはシステム制御され、一時的なトポロジ情報を提供します。 NMDA準拠のサーバーでは、これらはクライアントに読み取り専用アクセスを提供する<operational>の一部にすぎないため、脆弱性は低くなります。とは言っても、YANGモジュールは原則として情報を構成可能にします。
There are a number of data nodes defined in these YANG modules that are writable/creatable/deletable (i.e., config true, which is the default). These data nodes may be considered sensitive or vulnerable in some network environments. Write operations (e.g., edit-config) to these data nodes without proper protection can have a negative effect on network operations. These are the subtrees and data nodes and their sensitivity/vulnerability in the "ietf-l3-unicast-topology" module:
これらのYANGモジュールには、書き込み/作成/削除が可能なデータノードがいくつか定義されています（つまり、config true、デフォルトです）。これらのデータノードは、一部のネットワーク環境では機密または脆弱であると見なされる場合があります。適切な保護なしにこれらのデータノードに書き込み操作（edit-configなど）を行うと、ネットワーク操作に悪影響を与える可能性があります。これらは、「ietf-l3-unicast-topology」モジュールのサブツリーとデータノード、およびそれらの感度/脆弱性です。
o l3-topology-attributes: A malicious client could attempt to sabotage the configuration of any of the contained attributes, i.e., the name or the flag data nodes.
o l3-topology-attributes：悪意のあるクライアントが、含まれている属性、つまり名前やフラグデータノードの構成を妨害しようとする可能性があります。
o l3-node-attributes: A malicious client could attempt to sabotage the configuration of important node attributes, such as the router-id or node prefix.
o l3-node-attributes：悪意のあるクライアントが、ルーターIDやノードプレフィックスなどの重要なノード属性の構成を妨害しようとする可能性があります。
o l3-link-attributes: A malicious client could attempt to sabotage the configuration of important link attributes, such as name, flag, and metrics of the link.
o l3-link-attributes：悪意のあるクライアントが、リンクの名前、フラグ、メトリックなどの重要なリンク属性の構成を妨害しようとする可能性があります。
o l3-termination-point-attributes: A malicious client could attempt to sabotage the configuration information of a termination point, such as the termination point's IP address and interface name.
o l3-termination-point-attributes：悪意のあるクライアントが、ターミネーションポイントのIPアドレスやインターフェイス名など、ターミネーションポイントの構成情報を妨害しようとする可能性があります。
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <https://www.rfc-editor.org/info/rfc2119>.
[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、DOI 10.17487 / RFC2119、1997年3月、<https://www.rfc-editor.org/info/ rfc2119>。
[RFC2328] Moy, J., "OSPF Version 2", STD 54, RFC 2328, DOI 10.17487/RFC2328, April 1998, <https://www.rfc-editor.org/info/rfc2328>.
[RFC2328] Moy、J。、「OSPFバージョン2」、STD 54、RFC 2328、DOI 10.17487 / RFC2328、1998年4月、<https://www.rfc-editor.org/info/rfc2328>。
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, <https://www.rfc-editor.org/info/rfc2863>.
[RFC2863] McCloghrie、K。およびF. Kastenholz、「The Interfaces Group MIB」、RFC 2863、DOI 10.17487 / RFC2863、2000年6月、<https://www.rfc-editor.org/info/rfc2863>。
[RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, <https://www.rfc-editor.org/info/rfc3688>.
[RFC3688] Mealling、M。、「The IETF XML Registry」、BCP 81、RFC 3688、DOI 10.17487 / RFC3688、2004年1月、<https://www.rfc-editor.org/info/rfc3688>。
[RFC5246] Dierks, T. and E. Rescorla, "The Transport Layer Security (TLS) Protocol Version 1.2", RFC 5246, DOI 10.17487/RFC5246, August 2008, <https://www.rfc-editor.org/info/rfc5246>.
[RFC5246] Dierks、T。およびE. Rescorla、「The Transport Layer Security（TLS）Protocol Version 1.2」、RFC 5246、DOI 10.17487 / RFC5246、2008年8月、<https://www.rfc-editor.org/info / rfc5246>。
[RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", RFC 6020, DOI 10.17487/RFC6020, October 2010, <https://www.rfc-editor.org/info/rfc6020>.
[RFC6020] Bjorklund、M。、編、「YANG-ネットワーク構成プロトコル（NETCONF）のデータモデリング言語」、RFC 6020、DOI 10.17487 / RFC6020、2010年10月、<https：//www.rfc-editor。 org / info / rfc6020>。
[RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., and A. Bierman, Ed., "Network Configuration Protocol (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, <https://www.rfc-editor.org/info/rfc6241>.
[RFC6241] Enns、R。、編、Bjorklund、M。、編、Schoenwaelder、J。、編、およびA. Bierman、編、「Network Configuration Protocol（NETCONF）」、RFC 6241、DOI 10.17487 / RFC6241、2011年6月、<https://www.rfc-editor.org/info/rfc6241>。
[RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, <https://www.rfc-editor.org/info/rfc6242>.
[RFC6242] Wasserman、M。、「Using the NETCONF Protocol over Secure Shell（SSH）」、RFC 6242、DOI 10.17487 / RFC6242、2011年6月、<https://www.rfc-editor.org/info/rfc6242>。
[RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6991, DOI 10.17487/RFC6991, July 2013, <https://www.rfc-editor.org/info/rfc6991>.
[RFC6991] Schoenwaelder、J。、編、「Common YANG Data Types」、RFC 6991、DOI 10.17487 / RFC6991、2013年7月、<https://www.rfc-editor.org/info/rfc6991>。
[RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", RFC 7950, DOI 10.17487/RFC7950, August 2016, <https://www.rfc-editor.org/info/rfc7950>.
[RFC7950] Bjorklund、M。、編、「The YANG 1.1 Data Modeling Language」、RFC 7950、DOI 10.17487 / RFC7950、2016年8月、<https://www.rfc-editor.org/info/rfc7950>。
[RFC7951] Lhotka, L., "JSON Encoding of Data Modeled with YANG", RFC 7951, DOI 10.17487/RFC7951, August 2016, <https://www.rfc-editor.org/info/rfc7951>.
[RFC7951] Lhotka、L。、「YANGでモデル化されたデータのJSONエンコーディング」、RFC 7951、DOI 10.17487 / RFC7951、2016年8月、<https://www.rfc-editor.org/info/rfc7951>。
[RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, <https://www.rfc-editor.org/info/rfc8040>.
[RFC8040] Bierman、A.、Bjorklund、M。、およびK. Watsen、「RESTCONFプロトコル」、RFC 8040、DOI 10.17487 / RFC8040、2017年1月、<https://www.rfc-editor.org/info/rfc8040 >。
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8174] Leiba、B。、「RFC 2119キーワードの大文字と小文字のあいまいさ」、BCP 14、RFC 8174、DOI 10.17487 / RFC8174、2017年5月、<https://www.rfc-editor.org/info/ rfc8174>。
[RFC8294] Liu, X., Qu, Y., Lindem, A., Hopps, C., and L. Berger, "Common YANG Data Types for the Routing Area", RFC 8294, DOI 10.17487/RFC8294, December 2017, <https://www.rfc-editor.org/info/rfc8294>.
[RFC8294] Liu、X.、Qu、Y.、Lindem、A.、Hopps、C。、およびL. Berger、「ルーティングエリアの一般的なYANGデータタイプ」、RFC 8294、DOI 10.17487 / RFC8294、2017年12月、 <https://www.rfc-editor.org/info/rfc8294>。
[RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration Access Control Model", STD 91, RFC 8341, DOI 10.17487/RFC8341, March 2018, <https://www.rfc-editor.org/info/rfc8341>.
[RFC8341] Bierman、A。およびM. Bjorklund、「Network Configuration Access Control Model」、STD 91、RFC 8341、DOI 10.17487 / RFC8341、2018年3月、<https://www.rfc-editor.org/info/rfc8341 >。
[RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., and R. Wilton, "Network Management Datastore Architecture (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, <https://www.rfc-editor.org/info/rfc8342>.
[RFC8342] Bjorklund、M.、Schoenwaelder、J.、Shafer、P.、Watsen、K。、およびR. Wilton、「Network Management Datastore Architecture（NMDA）」、RFC 8342、DOI 10.17487 / RFC8342、2018年3月、< https://www.rfc-editor.org/info/rfc8342>。
[RFC8345] Clemm, A., Medved, J., Varga, R., Bahadur, N., Ananthakrishnan, H., and X. Liu, "A YANG Data Model for Network Topologies", RFC 8345, DOI 10.17487/RFC8345, March 2018, <https://www.rfc-editor.org/info/rfc8345>.
[RFC8345] Clemm、A.、Medved、J.、Varga、R.、Bahadur、N.、Ananthakrishnan、H。、およびX. Liu、「ネットワークトポロジのYANGデータモデル」、RFC 8345、DOI 10.17487 / RFC8345 、2018年3月、<https://www.rfc-editor.org/info/rfc8345>。
[RFC8022] Lhotka, L. and A. Lindem, "A YANG Data Model for Routing Management", RFC 8022, DOI 10.17487/RFC8022, November 2016, <https://www.rfc-editor.org/info/rfc8022>.
[RFC8022] Lhotka、L。およびA. Lindem、「ルーティング管理のためのYANGデータモデル」、RFC 8022、DOI 10.17487 / RFC8022、2016年11月、<https://www.rfc-editor.org/info/rfc8022> 。
[RFC8242] Haas, J. and S. Hares, "Interface to the Routing System (I2RS) Ephemeral State Requirements", RFC 8242, DOI 10.17487/RFC8242, September 2017, <https://www.rfc-editor.org/info/rfc8242>.
[RFC8242] Haas、J。およびS. Hares、「Interface to the Routing System（I2RS）Ephemeral State Requirements」、RFC 8242、DOI 10.17487 / RFC8242、2017年9月、<https://www.rfc-editor.org/ info / rfc8242>。
[RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, <https://www.rfc-editor.org/info/rfc8340>.
[RFC8340] Bjorklund、M。およびL. Berger、編、「YANG Tree Diagrams」、BCP 215、RFC 8340、DOI 10.17487 / RFC8340、2018年3月、<https://www.rfc-editor.org/info/ rfc8340>。
[RFC8343] Bjorklund, M., "A YANG Data Model for Interface Management", RFC 8343, DOI 10.17487/RFC8343, March 2018, <https://www.rfc-editor.org/info/rfc8343>.
[RFC8343] Bjorklund、M。、「A YANG Data Model for Interface Management」、RFC 8343、DOI 10.17487 / RFC8343、March 2018、<https://www.rfc-editor.org/info/rfc8343>。
[USECASE-REQS] Hares, S. and M. Chen, "Summary of I2RS Use Case Requirements", Work in Progress, draft-ietf-i2rs-usecase-reqs-summary-03, November 2016.
[USECASE-REQS] Hares、S.およびM. Chen、「Summary of I2RS Use Case Requirements」、Work in Progress、draft-ietf-i2rs-usecase-reqs-summary-03、2016年11月。
[YANG-RIB] Lindem, A. and Y. Qu, "RIB YANG Data Model", Work in Progress, draft-acee-rtgwg-yang-rib-extend-06, January 2018.
[YANG-RIB] Lindem、A。およびY. Qu、「RIB YANGデータモデル」、作業中、draft-acee-rtgwg-yang-rib-extend-06、2018年1月。
[YANG-TE] Liu, X., Bryskin, I., Beeram, V., Saad, T., Shah, H., and O. Gonzalez de Dios, "YANG Data Model for Traffic Engineering (TE) Topologies", Work in Progress, draft-ietf-teas-yang-te-topo-15, February 2018.
[YANG-TE] Liu、X.、Bryskin、I.、Beeram、V.、Saad、T.、Shah、H。、およびO. Gonzalez de Dios、「YANG Data Model for Traffic Engineering（TE）Topologies」、 Work in Progress、draft-ietf-teas-yang-te-topo-15、2018年2月。
Appendix A. Companion YANG Data Model for Implementations Not Compliant with NMDA
付録A. NMDAに準拠していない実装のコンパニオンYANGデータモデル
The YANG module "ietf-l3-unicast-topology" defined in this document augments two modules defined in [RFC8345]: "ietf-network" and "ietf-network-topology". These two modules were designed to be used in conjunction with implementations that support the Network Management Datastore Architecture (NMDA) defined in [RFC8342]. In order to allow implementations to use the model in cases when NMDA is not supported, [RFC8345] defines two companion modules, "ietf-network- state" and "ietf-network-topology-state", that represent state models of networks and network topologies, respectively.
このドキュメントで定義されているYANGモジュール「ietf-l3-unicast-topology」は、[RFC8345]で定義されている「ietf-network」と「ietf-network-topology」の2つのモジュールを補強します。これら2つのモジュールは、[RFC8342]で定義されているネットワーク管理データストアアーキテクチャ（NMDA）をサポートする実装と組み合わせて使用するように設計されています。 NMDAがサポートされていない場合に実装がモデルを使用できるようにするために、[RFC8345]は、ネットワークの状態モデルを表す「ietf-network-state」と「ietf-network-topology-state」の2つのコンパニオンモジュールを定義します。それぞれネットワークトポロジー。
In order to be able to use the model for Layer 3 topologies defined in this document in conjunction with implementations not compliant with NMDA, a corresponding companion module needs to be introduced as well. This companion module, "ietf-l3-unicast-topology-state", mirrors "ietf-l3-unicast-topology". However, the module augments "ietf-network-state" and "ietf-network-topology-state" (instead of "ietf-network" and "ietf-network-topology"), and all of its data nodes are non-configurable.
このドキュメントで定義されているレイヤ3トポロジのモデルをNMDAに準拠していない実装と組み合わせて使用できるようにするには、対応するコンパニオンモジュールも導入する必要があります。このコンパニオンモジュール「ietf-l3-unicast-topology-state」は、「ietf-l3-unicast-topology」を反映しています。ただし、モジュールは「ietf-network-state」と「ietf-network-topology-state」を拡張し（「ietf-network」と「ietf-network-topology」の代わりに）、そのすべてのデータノードは構成できません。
Similar considerations apply to any module that augments "ietf-l3- unicast-topology", such as the example module defined in Appendix B (i.e., example-ospf-topology). For implementations that are not compliant with NMDA, companion modules that represent state information and that are non-configurable will need to be introduced. These modules augment "ietf-l3-unicast-topology-state" instead of "ietf-l3-unicast-topology". Companion modules for the example module defined in Appendix B are not provided (since it is just an example).
付録Bで定義されているサンプルモジュール（example-ospf-topologyなど）など、「ietf-l3- unicast-topology」を拡張するすべてのモジュールに同様の考慮事項が適用されます。 NMDAに準拠していない実装では、状態情報を表し、構成できないコンパニオンモジュールを導入する必要があります。これらのモジュールは、「ietf-l3-unicast-topology」の代わりに「ietf-l3-unicast-topology-state」を拡張します。付録Bで定義されているサンプルモジュールのコンパニオンモジュールは提供されていません（これは単なる例であるため）。
Like "ietf-network-state" and "ietf-network-topology-state", "ietf-l3-unicast-topology" SHOULD NOT be supported by implementations that support NMDA. The module is therefore defined in an appendix.
「ietf-network-state」や「ietf-network-topology-state」と同様に、「ietf-l3-unicast-topology」は、NMDAをサポートする実装ではサポートされるべきではない（SHOULD NOT）。したがって、モジュールは付録で定義されています。
The definition of the module follows below. As the structure of the module mirrors that of its underlying module, the YANG tree is not depicted separately.
モジュールの定義は以下のとおりです。モジュールの構造はその基礎となるモジュールの構造を反映しているため、YANGツリーは個別に描かれていません。
<CODE BEGINS> file "ietf-l3-unicast-topology-state@2018-02-26.yang"
module ietf-l3-unicast-topology-state {
yang-version 1.1;
namespace
"urn:ietf:params:xml:ns:yang:ietf-l3-unicast-topology-state";
prefix "l3t-s";
import ietf-network-state {
prefix "nw-s";
}
import ietf-network-topology-state {
prefix "nt-s";
}
import ietf-l3-unicast-topology {
prefix "l3t";
}
organization
"IETF I2RS (Interface to the Routing System) Working Group";
contact
"WG Web: <https://datatracker.ietf.org/wg/i2rs/>
WG List: <mailto:i2rs@ietf.org>
Editor: Alexander Clemm
<mailto:ludwig@clemm.org>
Editor: Jan Medved
<mailto:jmedved@cisco.com>
Editor: Robert Varga
<mailto:robert.varga@pantheon.tech>
Editor: Xufeng Liu
<mailto:xufeng.liu.ietf@gmail.com>
Editor: Nitin Bahadur
<mailto:nitin_bahadur@yahoo.com>
Editor: Hariharan Ananthakrishnan
<mailto:hari@packetdesign.com>";
description
"This module defines a model for Layer 3 Unicast topology
state, representing topology that either is learned or
results from applying topology that has been configured per
the 'ietf-l3-unicast-topology' model, mirroring the
corresponding data nodes in this model.
This model mirrors 'ietf-l3-unicast-topology' but contains only read-only state data. The model is not needed when the underlying implementation infrastructure supports the Network Management Datastore Architecture (NMDA).
このモデルは「ietf-l3-unicast-topology」を反映していますが、読み取り専用の状態データのみが含まれています。基盤となる実装インフラストラクチャがネットワーク管理データストアアーキテクチャ（NMDA）をサポートしている場合、モデルは必要ありません。
Copyright (c) 2018 IETF Trust and the persons identified as authors of the code. All rights reserved.
Copyright（c）2018 IETF Trustおよびコードの作成者として識別された人物。全著作権所有。
Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info).
ソースおよびバイナリ形式での再配布および使用は、変更の有無にかかわらず、IETF文書に関連するIETFトラストの法的規定のセクション4.cに記載されているSimplified BSD Licenseに従い、それに含まれるライセンス条項に従って許可されます（ https://trustee.ietf.org/license-info）。
This version of this YANG module is part of RFC 8346;
see the RFC itself for full legal notices.";
revision "2018-02-26" {
description
"Initial revision.";
reference
"RFC 8346: A YANG Data Model for Layer 3 Topologies";
}
augment "/nw-s:networks/nw-s:network/nw-s:network-types" {
description
"Introduce new network type for L3 Unicast topology";
uses l3t:l3-unicast-topology-type;
}
augment "/nw-s:networks/nw-s:network" {
when "nw-s:network-types/l3t-s:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description
"L3 Unicast for the network as a whole";
uses l3t:l3-topology-attributes;
}
augment "/nw-s:networks/nw-s:network/nw-s:node" {
when "../nw-s:network-types/l3t-s:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description
"L3 Unicast node-level attributes ";
uses l3t:l3-node-attributes;
}
augment "/nw-s:networks/nw-s:network/nt-s:link" {
when "../nw-s:network-types/l3t-s:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description
"Augments topology link attributes";
uses l3t:l3-link-attributes;
}
augment "/nw-s:networks/nw-s:network/nw-s:node/"
+"nt-s:termination-point" {
when "../../nw-s:network-types/l3t-s:l3-unicast-topology" {
description
"Augmentation parameters apply only for networks with
L3 Unicast topology";
}
description "Augments topology termination point configuration";
uses l3t:l3-termination-point-attributes;
}
notification l3-node-event {
description
"Notification event for L3 node";
leaf l3-event-type {
type l3t:l3-event-type;
description
"Event type";
}
uses nw-s:node-ref;
uses l3t:l3-unicast-topology-type;
uses l3t:l3-node-attributes;
}
notification l3-link-event {
description
"Notification event for L3 link";
leaf l3-event-type {
type l3t:l3-event-type;
description
"Event type";
}
uses nt-s:link-ref;
uses l3t:l3-unicast-topology-type;
uses l3t:l3-link-attributes;
}
notification l3-prefix-event {
description
"Notification event for L3 prefix";
leaf l3-event-type {
type l3t:l3-event-type;
description
"Event type";
}
uses nw-s:node-ref;
uses l3t:l3-unicast-topology-type;
container prefix {
description
"Contains L3 prefix attributes";
uses l3t:l3-prefix-attributes;
}
}
notification termination-point-event {
description
"Notification event for L3 termination point";
leaf l3-event-type {
type l3t:l3-event-type;
description
"Event type";
}
uses nt-s:tp-ref;
uses l3t:l3-unicast-topology-type;
uses l3t:l3-termination-point-attributes;
}
}
<CODE ENDS>
<コード終了>
The model can be extended for specific Layer 3 Unicast types. Examples include OSPF and IS-IS topologies. This appendix introduces a YANG module that defines a simple topology model for OSPF. This module is intended to serve as an example that illustrates how the general topology model can be refined across multiple levels. It does not constitute a full-fledged OSPF topology model, which may be more comprehensive and refined than the model that is described here.
モデルは、特定のレイヤー3ユニキャストタイプに拡張できます。例には、OSPFおよびIS-ISトポロジが含まれます。この付録では、OSPFの簡単なトポロジモデルを定義するYANGモジュールを紹介します。このモジュールは、一般的なトポロジモデルを複数のレベルでどのように改善できるかを示す例として機能することを目的としています。ここで説明するモデルよりも包括的で洗練された、本格的なOSPFトポロジモデルを構成するものではありません。
The following model shows how the Layer 3 Unicast topology model can be extended, in this case, to cover OSPF topologies. For this purpose, a set of augmentations are introduced in a separate YANG module, "example-ospf-topology", whose structure is depicted in the following diagram. As before, the notation syntax follows [RFC8340]. Note that one of the lines has been wrapped to adhere to the 72-character line limitation of RFCs.
次のモデルは、この場合、レイヤ3ユニキャストトポロジモデルを拡張して、OSPFトポロジをカバーする方法を示しています。この目的のために、一連の拡張機能が別のYANGモジュール「example-ospf-topology」に導入されています。その構造を次の図に示します。以前と同様に、表記構文は[RFC8340]に従います。 RFCの72文字の行制限に準拠するために、行の1つが折り返されていることに注意してください。
module: example-ospf-topology
augment /nw:networks/nw:network/nw:network-types/
l3t:l3-unicast-topology:
+--rw ospf!
augment /nw:networks/nw:network/l3t:l3-topology-attributes:
+--rw ospf-topology-attributes
+--rw area-id? area-id-type
augment /nw:networks/nw:network/nw:node/l3t:l3-node-attributes:
+--rw ospf-node-attributes
+--rw (router-type)?
| +--:(abr)
| | +--rw abr? empty
| +--:(asbr)
| | +--rw asbr? empty
| +--:(internal)
| | +--rw internal? empty
| +--:(pseudonode)
| +--rw pseudonode? empty
+--rw dr-interface-id? uint32
augment /nw:networks/nw:network/nt:link/l3t:l3-link-attributes:
+--rw ospf-link-attributes
augment /l3t:l3-node-event:
+---- ospf!
+---- ospf-node-attributes
+---- (router-type)?
| +--:(abr)
| | +---- abr? empty
| +--:(asbr)
| | +---- asbr? empty
| +--:(internal)
| | +---- internal? empty
| +--:(pseudonode)
| +---- pseudonode? empty
+---- dr-interface-id? uint32
augment /l3t:l3-link-event:
+---- ospf!
+---- ospf-link-attributes
The module augments "ietf-l3-unicast-topology" as follows:
このモジュールは、「ietf-l3-unicast-topology」を次のように拡張します。
o A new topology type for an OSPF topology is introduced.
o OSPFトポロジの新しいトポロジタイプが導入されました。
o Additional topology attributes are defined in a new grouping that augments l3-topology-attributes of the "ietf-l3-unicast-topology" module. The attributes include an OSPF area-id identifying the OSPF area.
o 追加のトポロジ属性は、「ietf-l3-unicast-topology」モジュールのl3-topology-attributesを補強する新しいグループで定義されます。属性には、OSPFエリアを識別するOSPFエリアIDが含まれます。
o Additional data objects for nodes are introduced by augmenting the l3-node-attributes of the "ietf-l3-unicast-topology" module. New objects include router-type and dr-interface-id for pseudonodes.
o ノードの追加のデータオブジェクトは、「ietf-l3-unicast-topology」モジュールのl3-node-attributesを拡張することによって導入されます。新しいオブジェクトには、疑似ノードのルータータイプとdr-interface-idが含まれます。
o Links are augmented with OSPF link attributes.
o リンクには、OSPFリンク属性が追加されています。
In addition, the module extends notifications for events concerning Layer 3 nodes and links with OSPF attributes.
さらに、モジュールは、レイヤー3ノードおよびOSPF属性とのリンクに関するイベントの通知を拡張します。
It should be noted that the model defined here represents topology and is intended as an example. It does not define how to configure OSPF routers or interfaces.
ここで定義されているモデルはトポロジーを表し、例として意図されていることに注意してください。 OSPFルーターまたはインターフェースの構成方法は定義していません。
The OSPF Topology YANG module is specified below. As mentioned, the module is intended as an example for how the Layer 3 Unicast topology model can be extended to cover OSPF topologies, but it is not normative. Accordingly, the module is not delimited with <CODE BEGINS> and <CODE ENDS> tags.
OSPFトポロジのYANGモジュールを以下に示します。前述のように、このモジュールは、レイヤー3ユニキャストトポロジモデルを拡張してOSPFトポロジをカバーする方法の例として意図されていますが、これは規範的ではありません。したがって、モジュールは<CODE BEGINS>および<CODE ENDS>タグで区切られません。
file "example-ospf-topology@2017-12-16.yang"
module example-ospf-topology {
yang-version 1.1;
namespace "urn:example:example-ospf-topology";
prefix "ex-ospft";
import ietf-yang-types {
prefix "yang";
}
import ietf-network {
prefix "nw";
}
import ietf-network-topology {
prefix "nt";
}
import ietf-l3-unicast-topology {
prefix "l3t";
}
description
"This module is intended as an example for how the
Layer 3 Unicast topology model can be extended to cover
OSPF topologies.";
typedef area-id-type {
type yang:dotted-quad;
description
"Area ID type.";
}
grouping ospf-topology-type {
description
"Identifies the OSPF topology type.";
container ospf {
presence "indicates OSPF Topology";
description
"Its presence identifies the OSPF topology type.";
}
}
augment "/nw:networks/nw:network/nw:network-types/"
+ "l3t:l3-unicast-topology" {
description
"Defines the OSPF topology type.";
uses ospf-topology-type;
}
augment "/nw:networks/nw:network/l3t:l3-topology-attributes" {
when "../nw:network-types/l3t:l3-unicast-topology/" +
"ex-ospft:ospf" {
description
"Augments only for OSPF topology";
}
description
"Augments topology configuration";
container ospf-topology-attributes {
description
"Contains topology attributes";
leaf area-id {
type area-id-type;
description
"OSPF area ID";
}
}
}
augment "/nw:networks/nw:network/nw:node/l3t:l3-node-attributes" {
when "../../nw:network-types/l3t:l3-unicast-topology/" +
"ex-ospft:ospf" {
description
"Augments only for OSPF topology";
}
description
"Augments node configuration";
uses ospf-node-attributes;
}
augment "/nw:networks/nw:network/nt:link/l3t:l3-link-attributes" {
when "../../nw:network-types/l3t:l3-unicast-topology/" +
"ex-ospft:ospf" {
description
"Augments only for OSPF topology";
}
description
"Augments link configuration";
uses ospf-link-attributes;
}
grouping ospf-node-attributes {
description
"OSPF node scope attributes";
container ospf-node-attributes {
description
"Contains node attributes";
choice router-type {
description
"Indicates router type";
case abr {
leaf abr {
type empty;
description
"The node is ABR";
}
}
case asbr {
leaf asbr {
type empty;
description
"The node is ASBR";
}
}
case internal {
leaf internal {
type empty;
description
"The node is internal";
}
}
case pseudonode {
leaf pseudonode {
type empty;
description
"The node is pseudonode";
}
}
}
leaf dr-interface-id {
when "../pseudonode" {
description
"Valid only for pseudonode";
}
type uint32;
default "0";
description
"For pseudonodes, DR interface-id";
}
}
}
grouping ospf-link-attributes {
description
"OSPF link scope attributes";
container ospf-link-attributes {
description
"Contains OSPF link attributes";
}
} // ospf-link-attributes
augment "/l3t:l3-node-event" {
description
"OSPF node event";
uses ospf-topology-type;
uses ospf-node-attributes;
}
augment "/l3t:l3-link-event" {
description
"OSPF link event";
uses ospf-topology-type;
uses ospf-link-attributes;
}
}
This section contains an example of an instance data tree in JSON encoding [RFC7951]. The example instantiates "ietf-l3-unicast-topology" for the topology that is depicted in the following diagram. There are three nodes: D1, D2, and D3. D1 has three termination points: 1-0-1, 1-2-1, and 1-3-1. D2 has three termination points as well: 2-1-1, 2-0-1, and 2-3-1. D3 has two termination points: 3-1-1 and 3-2-1. In addition, there are six links, two between each pair of nodes, with one going in each direction.
このセクションには、JSONエンコード[RFC7951]のインスタンスデータツリーの例が含まれています。この例では、次の図に示すトポロジの「ietf-l3-unicast-topology」をインスタンス化します。 D1、D2、およびD3の3つのノードがあります。 D1には、1-0-1、1-2-1、および1-3-1の3つの終端ポイントがあります。 D2にも3つの終端ポイントがあります。2-1-1、2-0-1、および2-3-1です。 D3には2つの終端ポイントがあります。3-1-1と3-2-1です。さらに、6つのリンクがあり、ノードの各ペア間に2つ、各方向に1つずつあります。
+------------+ +------------+
| D1 | | D2 |
/-\ /-\ /-\ /-\
| | 1-0-1 | |---------------->| | 2-1-1 | |
| | 1-2-1 | |<----------------| | 2-0-1 | |
\-/ 1-3-1 \-/ \-/ 2-3-1 \-/
| /----\ | | /----\ |
+---| |---+ +---| |---+
\----/ \----/
A | A |
| | | |
| | | |
| | +------------+ | |
| | | D3 | | |
| | /-\ /-\ | |
| +----->| | 3-1-1 | |-------+ |
+---------| | 3-2-1 | |<---------+
\-/ \-/
| |
+------------+
Figure 2: A Network Topology Example
図2：ネットワークトポロジの例
The corresponding instance data tree is depicted below. Note that some lines have been wrapped to adhere to the 72-character line limitation of RFCs.
対応するインスタンスデータツリーを以下に示します。 RFCの72文字の行制限に準拠するために一部の行が折り返されていることに注意してください。
{
"ietf-network:networks": {
"network": [
{
"network-types": {
"ietf-l3-unicast-topology:l3-unicast-topology": {}
},
"network-id": "l3-topo-example",
"node": [
{
"node-id": "D1",
"termination-point": [
{
"tp-id": "1-0-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 101
}
},
{
"tp-id": "1-2-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 121
}
},
{
"tp-id": "1-3-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 131
}
}
],
"ietf-l3-unicast-topology:l3-node-attributes": {
"router-id": ["203.0.113.1"]
}
},
{
"node-id": "D2",
"termination-point": [
{
"tp-id": "2-0-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 201
}
},
{
"tp-id": "2-1-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 211
}
},
{
"tp-id": "2-3-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 231
}
}
],
"ietf-l3-unicast-topology:l3-node-attributes": {
"router-id": ["203.0.113.2"]
}
},
{
"node-id": "D3",
"termination-point": [
{
"tp-id": "3-1-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 311
}
},
{
"tp-id": "3-2-1",
"ietf-l3-unicast-topology:
l3-termination-point-attributes": {
"unnumbered-id:": 321
}
}
],
"ietf-l3-unicast-topology:l3-node-attributes": {
"router-id": ["203.0.113.3"]
}
}
],
"ietf-network-topology:link": [
{
"link-id": "D1,1-2-1,D2,2-1-1",
"source": {
"source-node": "D1",
"source-tp": "1-2-1"
}
"destination": {
"dest-node": "D2",
"dest-tp": "2-1-1"
},
"ietf-l3-unicast-topology:l3-link-attributes": {
"metric1": "100"
}
},
{
"link-id": "D2,2-1-1,D1,1-2-1",
"source": {
"source-node": "D2",
"source-tp": "2-1-1"
}
"destination": {
"dest-node": "D1",
"dest-tp": "1-2-1"
},
"ietf-l3-unicast-topology:l3-link-attributes": {
"metric1": "100"
}
},
{
"link-id": "D1,1-3-1,D3,3-1-1",
"source": {
"source-node": "D1",
"source-tp": "1-3-1"
}
"destination": {
"dest-node": "D3",
"dest-tp": "3-1-1"
},
"ietf-l3-unicast-topology:l3-link-attributes": {
"metric1": "100"
}
},
{
"link-id": "D3,3-1-1,D1,1-3-1",
"source": {
"source-node": "D3",
"source-tp": "3-1-1"
}
"destination": {
"dest-node": "D1",
"dest-tp": "1-3-1"
},
"ietf-l3-unicast-topology:l3-link-attributes": {
"metric1": "100"
}
},
{
"link-id": "D2,2-3-1,D3,3-2-1",
"source": {
"source-node": "D2",
"source-tp": "2-3-1"
}
"destination": {
"dest-node": "D3",
"dest-tp": "3-2-1"
},
"ietf-l3-unicast-topology:l3-link-attributes": {
"metric1": "100"
}
},
{
"link-id": "D3,3-2-1,D2,2-3-1",
"source": {
"source-node": "D3",
"source-tp": "3-2-1"
}
"destination": {
"dest-node": "D2",
"dest-tp": "2-3-1"
},
"ietf-l3-unicast-topology:l3-link-attributes": {
"metric1": "100"
}
}
]
}
]
}
}
Figure 3: Instance Data Tree
図3：インスタンスデータツリー
Acknowledgments
謝辞
We wish to acknowledge the helpful contributions, comments, and suggestions that were received from Alia Atlas, Andy Bierman, Benoit Claise, Joel Halpern, Susan Hares, Ladislav Lhotka, Carl Moberg, Carlos Pignataro, Juergen Schoenwaelder, Michal Vasco, and Kent Watsen.
Alia Atlas、Andy Bierman、Benoit Claise、Joel Halpern、Susan Hares、Ladislav Lhotka、Carl Moberg、Carlos Pignataro、Juergen Schoenwaelder、Michal Vasco、Kent Watsenから寄せられた有益な貢献、コメント、提案に感謝いたします。
Contributors
貢献者
The model presented in this document was contributed to by more people than can be listed on the author list. Additional contributors include:
このドキュメントで提示されているモデルは、著者リストに記載されているよりも多くの人々によって提供されました。追加の貢献者は次のとおりです。
o Vishnu Pavan Beeram, Juniper
o Vishnu Pavan Beeram、ジュニパー
o Igor Bryskin, Huawei
o イゴール・ブリスキン、ファーウェイ
o Ken Gray, Cisco
o ケン・グレイ、シスコ
o Aihua Guo, Huawei
o AIはGU O、hu Aを描画します
o Tom Nadeau, Brocade
o トム・ナドー、ブロケード
o Tony Tkacik
o トニー・トック
o Aleksandr Zhdankin, Cisco
o Alexander Zhdankin、Cisco
Authors' Addresses
著者のアドレス
Alexander Clemm Huawei USA - Futurewei Technologies Inc. Santa Clara, CA United States of America
Alexander Clemm Huawei USA-Futurewei Technologies Inc.カリフォルニア州サンタクララアメリカ合衆国
Email: ludwig@clemm.org, alexander.clemm@huawei.com
Jan Medved Cisco
Jan Medved Cisco
Email: jmedved@cisco.com
Robert Varga Pantheon Technologies SRO
Robert Varga Pantheon Technologies SRO
Email: robert.varga@pantheon.tech
Xufeng Liu Jabil
X U Feng L IU JA比率
Email: xufeng.liu.ietf@gmail.com
Hariharan Ananthakrishnan Packet Design
Hariharan Ananthakrishnanパケットデザイン
Email: hari@packetdesign.com
Nitin Bahadur Bracket Computing
Nitin Bahadurブラケットコンピューティング
Email: nitin_bahadur@yahoo.com