Yang for I2RS Protocol
draft-hares-netmod-i2rs-yang-03
The information below is for an old version of the document.
| Document | Type |
This is an older version of an Internet-Draft whose latest revision state is "Expired".
|
|
|---|---|---|---|
| Authors | Susan Hares , Amit Dass | ||
| Last updated | 2017-03-10 (Latest revision 2016-11-16) | ||
| RFC stream | (None) | ||
| Formats | |||
| Stream | Stream state | (No stream defined) | |
| Consensus boilerplate | Unknown | ||
| RFC Editor Note | (None) | ||
| IESG | IESG state | I-D Exists | |
| Telechat date | (None) | ||
| Responsible AD | (None) | ||
| Send notices to | (None) |
draft-hares-netmod-i2rs-yang-03
I2RS working group S. Hares
Internet-Draft Huawei
Intended status: Informational A. Dass
Expires: September 11, 2017 Ericsson
March 10, 2017
Yang for I2RS Protocol
draft-hares-netmod-i2rs-yang-03.txt
Abstract
This document requests yang language additions for the data models
that exist as part of the I2RS control plane datastore. One of these
additions is the ability to mark a portion of the model as having
ephemeral state.
Status of This Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on September 11, 2017.
Copyright Notice
Copyright (c) 2017 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://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.
Hares & Dass Expires September 11, 2017 [Page 1]
Internet-Draft I2RS Protocol Yang March 2017
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.1. Requirements language . . . . . . . . . . . . . . . . . . 3
2.2. I2RS Definitions . . . . . . . . . . . . . . . . . . . . 3
3. yang additions . . . . . . . . . . . . . . . . . . . . . . . 4
3.1. datastore . . . . . . . . . . . . . . . . . . . . . . . . 4
3.2. dstype . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.3. ephemeral . . . . . . . . . . . . . . . . . . . . . . . . 6
3.4. protosup statement . . . . . . . . . . . . . . . . . . . 6
3.4.1. protobase . . . . . . . . . . . . . . . . . . . . . . 7
3.4.2. protoadd . . . . . . . . . . . . . . . . . . . . . . 7
3.5. validation . . . . . . . . . . . . . . . . . . . . . . . 7
3.6. bulkcheck . . . . . . . . . . . . . . . . . . . . . . . . 8
3.7. caching . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.8. nstransport . . . . . . . . . . . . . . . . . . . . . . . 9
4. Change to RFC7950 . . . . . . . . . . . . . . . . . . . . . . 10
4.1. Additions to the Module table . . . . . . . . . . . . . . 10
4.2. Additions to the submodule substatement list . . . . . . 11
4.3. Additions to the container substatement list . . . . . . 13
4.4. Additions to leaf substatement list . . . . . . . . . . . 13
4.5. Additions to leaf-list substatement list . . . . . . . . 14
4.6. Additions to list substatement list . . . . . . . . . . . 15
4.7. Additions to the grouping substatement table . . . . . . 16
4.8. Additions to the rpc substatement list . . . . . . . . . 17
4.9. Additions to the action substatement list . . . . . . . . 18
5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 19
6. Security Considerations . . . . . . . . . . . . . . . . . . . 19
7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 19
8. References . . . . . . . . . . . . . . . . . . . . . . . . . 19
8.1. Normative References: . . . . . . . . . . . . . . . . . . 20
8.2. Informative References . . . . . . . . . . . . . . . . . 20
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 21
1. Introduction
This a proposal for additions to yang 1.1 [RFC7950] to support the
I2RS protocol.
The I2RS architecture [RFC7921] defines the I2RS interface "a
programmatic interface for state transfer in and out of the Internet
routing system". The I2RS protocol is a protocol designed to a
higher level protocol comprised of a set of IETF existing protocols
(NETCONF [RFC6241], RESTCONF [RFC8044], and others) which have been
extended to work together to support a new interface to the routing
system. The I2RS protocol is a "reuse" management protocol which
creates new management protocols by reusing existing protocols and
Hares & Dass Expires September 11, 2017 [Page 2]
Internet-Draft I2RS Protocol Yang March 2017
extending these protocols for new uses, and has been designed to be
implemented in phases [RFC7921].
This document suggests the following additions to Yang to support the
I2RS control plane datastore. [I-D.ietf-i2rs-ephemeral-state]
specifies the I2RS requirements for the ephemeral state.
Section 3 of this document defines optional additions to yang 1.1 to
support I2RS ephemeral control plane datastore. The main addition is
the datastore statement with four new substatements (dstype,
ephemeral, protosup, validation). The protosup substatement has two
valid substatements (protobase, protoadd). The validation
substatement has has three new substatements: bulkchecks, caching,
and nstransport.
Section 4 provides the augmentation to RFC7950 tables for these
optional features.
2. Definitions
2.1. Requirements language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
2.2. I2RS Definitions
The I2RS architecture [RFC7921] defines the following terms:
ephemeral data: is data which does not persist across a reboot
(software or hardware) or a power on/off condition. Ephemeral
data can be configured data or data recorded from operations of
the router. Ephemeral configuration data also has the property
that a system cannot roll back to a previous ephemeral
configuration state. (See [RFC7921] for an architectural
overview, [I-D.ietf-i2rs-ephemeral-state] for requirements, and
[I-D.ietf-netmod-revised-datastores] for discussion of how the
ephemeral datastore as a control plane datastore interacts with
intended configuration datstore, the dynamic configuration
protocols, and control planes datastore to create the applied
datastore and operational state datastore.
local configuration: is the data on a routing system which does
persist across a reboot (software or hardware) and a power on/off
condition. Local configuration is defined as the intended
datastore as defined in [I-D.ietf-netmod-revised-datastores].
Hares & Dass Expires September 11, 2017 [Page 3]
Internet-Draft I2RS Protocol Yang March 2017
dynamic configuration protocols datastore are configuration
protocols such as DHCP that interact with the intended datastore
(which does persist across a reboot (software or hardware) power
on/off condition), and the I2RS ephemeral state control plane
datastore.
applied datastore Read only datastore regarding configuration
state installed in the routing system as defined in
[I-D.ietf-netmod-revised-datastores].
operational state Read only datastore that combines applied
datastore and operational state as defined in
[I-D.ietf-netmod-revised-datastores].
operator-applied policy: is a policy that an operator sets that
determines how the ephemeral datastore as a control plane data
store interacts with intended configuration (see
[I-D.ietf-netmod-revised-datastores]). This operator policy
consists of setting a priority for each of the following (per
[I-D.ietf-i2rs-ephemeral-state]):
* intended configuration,
* any dynamic configuration protocols,
* any control plane datastores (one of which is ephemeral.)
3. yang additions
3.1. datastore
The "datastore" substatement for the Yang Module statement provides
the ability to describe which datastore a module or submodule may be
loaded into. If no "datastore" statement exists, there is no
restriction on the datastores a module or submodule can be loaded
into.
The argument the datastore is a datastore name denoted as "dsname".
The vaid substatements are in Table 1. The "description"
substatement provides a description of the datastore. The "dstype"
provides information on the class (e.g., config or control plane) and
the subclass of the datastore (e.g., i2rs). The ephemeral indicates
that entire datastore is ephemeral. The validation provides
alternate validation rules for the datastore. The syntax of these
substatements are provided in sections x.x of thsi document
Hares & Dass Expires September 11, 2017 [Page 4]
Internet-Draft I2RS Protocol Yang March 2017
Data store syntax:
datastore <dsname> {
<sub-statements>
};
dstype syntax:
dstype dsclass dsname
where:
dsclass: [config | control-plane ]
dssubclass [ i2rs | vendor ]
Figure 1
The substatements for the datastore substatement are listed below:
Table 1
+---------------+----------+---------+-------------+
| | This | | |
| | document | RFC7960 | |
| substatement | section | section | cardinality |
+---------------+----------+---------+-------------+
| description | - | 7.21.3 | 0..1 |
| dstype | 3.2 | - | 1 |
| ephemeral | 3.3 | - | 0..n |
| protosup | 3.4 | - | 0..n |
| reference | - | 7.21.4 | 0..1 |
| revision | - | 7.1.9 | 0..n |
| revision-date | - | 7.1.5.1 | 0..1 |
| validation | 3.5 | - | 0..n |
| version | | 7.1.9 | 0..n |
+---------------+----------+---------+-------------+
Application Comments:
A module may be mounted into different datastores. The datastore
statement indicates which datastores a module may be mounted in, and
the characteristics of each datastore.
3.2. dstype
They substatement dstype indicates the datastore class and subclass
of the datastore. A dstype substatement may only exist within a
datastore statement.
Hares & Dass Expires September 11, 2017 [Page 5]
Internet-Draft I2RS Protocol Yang March 2017
Syntax of the dstype datastore is:
dstype <dsclass> <dsname>;
where:
dsclass: ["config" | "control-plane ]
dssubclass [ "i2rs-v0" | "vendor" ]
3.3. ephemeral
The ephemeral indicates that an object is ephemeral data which does
not survive a reboot (see [I-D.ietf-i2rs-ephemeral-state]. The
definition of the object may be a datastore, a module, a submodule,
an action, a container, a grouping, a leaf, a leaf-list, a list, or
an rpc.
Syntax is the following:
ephemeral [yes | no];
The value "no" indicates the object is not ephemeral.
The value "yes" indicates the value is ephemeral.
Figure 2
3.4. protosup statement
This indicates which protocols support this datastore. The protocols
can be netconf, restconf, coap, gprc, and bgp. The substatements for
protosup are protocobase and protoadd
Syntax is the following:
protosup {
<<protosup substatements>>
}
Table 2
+---------------+----------+---------+-------------+
| | document | RFC7960 | |
| substatement | section | section | cardinality |
+---------------+----------+---------+-------------+
| description | - | 7.21.3 | 0..1 |
| protobase | 3.4.1 | - | 1..n |
| protoadd | 3.4.2 | - | 1..n |
+---------------+----------+---------+-------------+
Hares & Dass Expires September 11, 2017 [Page 6]
Internet-Draft I2RS Protocol Yang March 2017
3.4.1. protobase
The protobase substatement indicates the protocol a database can be
sent over. The syntax is below:
Syntax for protobase:
protobase [netconf | restconf | coap
| bgp | isis | ospf | dots
| <protocol-name> ]
Figure 3
3.4.2. protoadd
The protoadd specifies required optional additions to a protocol that
sends information to a datastore. One example of such an addition is
the additions to RESTCONF to support the I2RS protocol denoted as
"i2rs".
Syntax for proto add:
protoadd [i2rs | i2nsf | <proto-add>]
Figure 4
3.5. validation
The validation keyword indicates that the object uses alternate
validation besides the mechanisms defined by the configuration
datastore as defined in [RFC7950]. The validation subcommand is
invalid in any module or submodule which is only defined for the
configuration datastore. Unless the module has a datastore statement
which includes a datastore other than config, all validation
statements in the module are ignored. Unless the submodule has a
datastore statement which includes a datastore other than config, all
validation statements are ignored.
The validation can be set on a datastore command in a a module, a
submodule, an action, a container, a grouping, a leaf, a leaf-list, a
list, or an rpc. The validation substatements include nstransport
and bulk-checks as shown in table 3.
Hares & Dass Expires September 11, 2017 [Page 7]
Internet-Draft I2RS Protocol Yang March 2017
Syntax of the validation is:
validation {
<<validation-substatements>>
};
Figure 5
Table 3
+---------------+----------+---------+-------------+
| | document | RFC7960 | |
| substatement | section | section | cardinality |
+---------------+----------+---------+-------------+
| description | - | 7.21.3 | 0..1 |
| bulkchecks | 3.5 | - | 0..1 |
| caching | 3.6 | - | 0..1 |
| nstransport | 3.7 | - | 0..1 |
| organization | - | 7.1.7 | 0..1 |
| reference | - | 7.21.4 | 0..n |
| revision-date | - | 7.1.5.1 | 0..1 |
| version | | 7.1.9 | 0..n |
+---------------+----------+---------+-------------+
3.6. bulkcheck
The bulkcheck flag indicates whether this object uses bulk-check
validation instead of the normal configuration datastore validation.
The protocol updating the object must support bulk checking
mechanism, or indicate that this object is not supported.
This is a new feature for control plane protocols and control plane
datastores. In the configuration datastores, it is possible to
support this feature at the validation level for the rpc object.
Early implemementers of this feature for module which may loaded in
the configuration datastore are encouraged to place bulkcheck
features within "rpc" functionality.
bulkcheck syntax:
bulkchecks [yes | no];
Figure 6
The value "no" indicates the object does not allows "bulkchecks" of
data, and uses the normal configuration datastore checking. The
value "yes" indicates the object does not allows "bulkchecks" of data
within this object.
Hares & Dass Expires September 11, 2017 [Page 8]
Internet-Draft I2RS Protocol Yang March 2017
3.7. caching
The caching flag indicates whether the I2RS support caching of
multiple client information within I2RS Agents.
Application note: This feature is not supported for the I2RS protocol
version 0
caching syntax:
caching [yes | no];
Figure 7
The value "no" indicates the object does not allows "bulkchecks" of
data, and uses the normal configuration datastore checking. The
value "yes" indicates the object does not allows "bulkchecks" of data
within this object.
3.8. nstransport
The nstransport indicates whether this object may be sent across a
non-secure transport. Sending data across a non-secure transport
should be done only if the circumstances warrant it.
This is a new feature for the I2RS control plane protocols and
control plane datastores.
Caution: For a description of when a on-secure transport is
appropriate for I2RS control plane protocol, please refer to the I2RS
protocol security requirements
[I-D.ietf-i2rs-protocol-security-requirements]. Implementers of this
feature in an I2RS implementation should also review the I2RS
security requirements [I-D.ietf-i2rs-security-environment-reqs]. No
data which reveals any identity for a person or confidential
information should be sent via a non-secure transport.
Syntax is the following:
nstransport [yes | no];
The value "no" indicates the object does not allows "bulkchecks" of
data, and uses the normal configuration datastore checking. The
value "yes" indicates the object does not allows "bulkchecks" of data
within this object.
Hares & Dass Expires September 11, 2017 [Page 9]
Internet-Draft I2RS Protocol Yang March 2017
4. Change to RFC7950
The optional attributes add options to the tables for substatements
for the module (section 7.1.1), submodule table, action, container,
grouping, leaf, leaf-list, a list, and an rpc. This section provides
the revised tables.
4.1. Additions to the Module table
This is the additions to module's substatment table in section 7.1.1
of [RFC7950].
Hares & Dass Expires September 11, 2017 [Page 10]
Internet-Draft I2RS Protocol Yang March 2017
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| anydata | 7.10 | 0..n |
| anyxml | 7.11 | 0..n |
| augment | 7.17 | 0..n |
| choice | 7.9 | 0..n |
| contact | 7.1.8 | 0..1 |
| container | 7.5 | 0..n |
| description | 7.21.3 | 0..1 |
| deviation | 7.20.3 | 0..n |
| extension | 7.19 | 0..n |
| feature | 7.20.1 | 0..n |
| grouping | 7.12 | 0..n |
| identity | 7.18 | 0..n |
| import | 7.1.5 | 0..n |
| include | 7.1.6 | 0..n |
| leaf | 7.6 | 0..n |
| leaf-list | 7.7 | 0..n |
| list | 7.8 | 0..n |
| namespace | 7.1.3 | 1 |
| notification | 7.16 | 0..n |
| organization | 7.1.7 | 0..1 |
| prefix | 7.1.4 | 1 |
| reference | 7.21.4 | 0..1 |
| revision | 7.1.9 | 0..n |
| rpc | 7.14 | 0..n |
| typedef | 7.3 | 0..n |
| uses | 7.13 | 0..n |
| yang-version | 7.1.2 | 1 |
+--------------+----------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| datastore | 3.2 | 0..n |
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
4.2. Additions to the submodule substatement list
Below would be the replacement for the substatement table in setion
7.2.1 of [RFC7950] which lists the valid submodule statements.
Hares & Dass Expires September 11, 2017 [Page 11]
Internet-Draft I2RS Protocol Yang March 2017
7.2.1. The submodule's Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| anydata | 7.10 | 0..n |
| anyxml | 7.11 | 0..n |
| augment | 7.17 | 0..n |
| belongs-to | 7.2.2 | 1 |
| choice | 7.9 | 0..n |
| contact | 7.1.8 | 0..1 |
| container | 7.5 | 0..n |
| description | 7.21.3 | 0..1 |
| deviation | 7.20.3 | 0..n |
| extension | 7.19 | 0..n |
| feature | 7.20.1 | 0..n |
| grouping | 7.12 | 0..n |
| identity | 7.18 | 0..n |
| import | 7.1.5 | 0..n |
| include | 7.1.6 | 0..n |
| leaf | 7.6 | 0..n |
| leaf-list | 7.7 | 0..n |
| list | 7.8 | 0..n |
| namespace | 7.1.3 | 1 |
| notification | 7.16 | 0..n |
| organization | 7.1.7 | 0..1 |
| reference | 7.21.4 | 0..1 |
| revision | 7.1.9 | 0..n |
| rpc | 7.14 | 0..n |
| typedef | 7.3 | 0..n |
| uses | 7.13 | 0..n |
| yang-version | 7.1.2 | 1 |
+--------------+----------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
Hares & Dass Expires September 11, 2017 [Page 12]
Internet-Draft I2RS Protocol Yang March 2017
4.3. Additions to the container substatement list
Below would be the replacement for the substatement table in section
7.5.2 of [RFC7950] that lists the legal container substatements.
7.5.2. The container Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| action | 7.15 | 0..n |
| anydata | 7.10 | 0..n |
| anyxml | 7.11 | 0..n |
| choice | 7.9 | 0..n |
| config | 7.21.1 | 0..1 |
| description | 7.21.3 | 0..1 |
| grouping | 7.12 | 0..n |
| if-feature | 7.20.2 | 0..n |
| leaf | 7.6 | 0..n |
| leaf-list | 7.7 | 0..n |
| list | 7.8 | 0..n |
| must | 7.5.3 | 0..n |
| notification | 7.16 | 0..n |
| presennce | 7.5.5 | 0..1 |
| reference | 7.21.4 | 0..1 |
| status | 7.1.9 | 0..1 |
| typedef | 7.3 | 0..n |
| uses | 7.13 | 0..n |
| when | 7.21.5 | 0..1 |
+--------------+----------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
4.4. Additions to leaf substatement list
Below would be replacement for the substatement table in section
7.6.2 of [RFC7950] which provides the leaf's substatements.
Hares & Dass Expires September 11, 2017 [Page 13]
Internet-Draft I2RS Protocol Yang March 2017
7.6.2 The leaf's Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| config | 7.21.1 | 0..1 |
| default | 7.6.4 | 0..1 |
| description | 7.21.3 | 0..1 |
| if-feature | 7.20.2 | 0..n |
| mandatory | 7.6.5 | 0..1 |
| must | 7.5.3 | 0..n |
| reference | 7.21.4 | 0..1 |
| status | 7.21.2 | 0..1 |
| type | 7.6.3 | 1 |
| units | 7.3.3 | 0..1 |
| when | 7.21.5 | 0..1 |
+--------------+----------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
4.5. Additions to leaf-list substatement list
Below would be the replacement for the substatement table in section
7.7.2 in [RFC7950] which provides the list of the leaf-lists
substatements.
Hares & Dass Expires September 11, 2017 [Page 14]
Internet-Draft I2RS Protocol Yang March 2017
7.7.2 The leaf's Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| config | 7.21.1 | 0..1 |
| default | 7.6.4 | 0..1 |
| description | 7.21.3 | 0..1 |
| if-feature | 7.20.2 | 0..n |
| max-elements | 7.7.6 | 0..1 |
| min-elements | 7.7.5 | 0..1 |
| must | 7.5.3 | 0..n |
| ordered-by | 7.7.7 | 0..1 |
| reference | 7.21.4 | 0..1 |
| status | 7.21.2 | 0..1 |
| type | 7.6.3 | 1 |
| units | 7.3.3 | 0..1 |
| when | 7.21.5 | 0..1 |
+--------------+---------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
4.6. Additions to list substatement list
Below would be the replacement for the table in section 7.8.1 in
[RFC7950] which provides the list's substatements.
Hares & Dass Expires September 11, 2017 [Page 15]
Internet-Draft I2RS Protocol Yang March 2017
7.8.1 The list's Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| action | 7.15 | 0..n |
| anydata | 7.10 | 0..n |
| anyxml | 7.11 | 0..n |
| choice | 7.9 | 0..n |
| config | 7.21.1 | 0..1 |
| container | 7.5 | 0..n |
| description | 7.21.3 | 0..1 |
| grouping | 7.12 | 0..n |
| if-feature | 7.20.2 | 0..n |
| key | 7.8.2 | 0..n |
| leaf | 7.6 | 0..n |
| leaf-list | 7.7 | 0..n |
| list | 7.8 | 0..n |
| max-elements | 7.7.6 | 0..1 |
| min-elements | 7.7.5 | 0..1 |
| must | 7.5.3 | 0..n |
| notification | 7.16 | 0..n }
| ordered-by | 7.7.7 | 0..1 |
| reference | 7.21.4 | 0..1 |
| status | 7.21.2 | 0..1 |
| typedef | 7.3 | 0..n |
| uses | 7.13 | 0..n |
| when | 7.21.5 | 0..1 |
+--------------+----------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
4.7. Additions to the grouping substatement table
Below would be the replacement for the table 7.12.1 of [RFC7950] that
lists the vaid substatments for the container substatements.
Hares & Dass Expires September 11, 2017 [Page 16]
Internet-Draft I2RS Protocol Yang March 2017
7.5.2. The grouping's Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| action | 7.15 | 0..n |
| anydata | 7.10 | 0..n |
| anyxml | 7.11 | 0..n |
| choice | 7.9 | 0..n |
| description | 7.21.3 | 0..1 |
| grouping | 7.12 | 0..n |
| leaf | 7.6 | 0..n |
| leaf-list | 7.7 | 0..n |
| list | 7.8 | 0..n |
| notification | 7.16 | 0..n |
| reference | 7.21.4 | 0..1 |
| status | 7.1.9 | 0..1 |
| typedef | 7.3 | 0..n |
| uses | 7.13 | 0..n |
+--------------+----------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
4.8. Additions to the rpc substatement list
Below would be the replacement for the table in section 7.14.1 of
[RFC7950] that lists the legal rpc substatements.
Hares & Dass Expires September 11, 2017 [Page 17]
Internet-Draft I2RS Protocol Yang March 2017
7.5.2. The rpc Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| description | 7.21.3 | 0..1 |
| grouping | 7.12 | 0..n |
| if-feature | 7.20.2 | 0..n |
| input | 7.14.2 | 0..1 |
| output | 7.14.3 | 0..1 |
| reference | 7.21.4 | 0..1 |
| status | 7.1.9 | 0..1 |
| typedef | 7.3 | 0..n |
+--------------+=---------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
4.9. Additions to the action substatement list
Below would be the replacement for the table 7.15.1 of [RFC7950] that
lists the legal action substatements.
Hares & Dass Expires September 11, 2017 [Page 18]
Internet-Draft I2RS Protocol Yang March 2017
7.5.2. The action Substatements
+--------------+----------+-------------+
| | RFC7950 | |
| substatement | section | cardinality |
+--------------+----------+-------------+
| description | 7.21.3 | 0..1 |
| grouping | 7.12 | 0..n |
| if-feature | 7.20.2 | 0..n |
| input | 7.14.2 | 0..1 |
| output | 7.14.3 | 0..1 |
| reference | 7.21.4 | 0..1 |
| status | 7.1.9 | 0..1 |
| typedef | 7.3 | 0..n |
+--------------+=---------+-------------+
| optional | This | |
| Yang 1.1 |document's| |
| substatement | section | cardinality |
+--------------+----------+-------------+
| ephemeral | 3.3 | 0..n |
| validation | 3.5 | 0..n |
+--------------+----------+-------------+
Figure 2
5. IANA Considerations
The additions for registries go here.
6. Security Considerations
The security requirements for the I2RS protocol are covered in
[I-D.ietf-i2rs-protocol-security-requirements]. The security
environment the I2RS protocol is covered in
[I-D.ietf-i2rs-security-environment-reqs]. Any person implementing
or deploying these yang additions for an I2RS protocol should
consider both security requirements.
7. Acknowledgements
tBD
8. References
Hares & Dass Expires September 11, 2017 [Page 19]
Internet-Draft I2RS Protocol Yang March 2017
8.1. Normative References:
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119,
DOI 10.17487/RFC2119, March 1997,
<http://www.rfc-editor.org/info/rfc2119>.
[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,
<http://www.rfc-editor.org/info/rfc6241>.
[RFC7921] Atlas, A., Halpern, J., Hares, S., Ward, D., and T.
Nadeau, "An Architecture for the Interface to the Routing
System", RFC 7921, DOI 10.17487/RFC7921, June 2016,
<http://www.rfc-editor.org/info/rfc7921>.
[RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language",
RFC 7950, DOI 10.17487/RFC7950, August 2016,
<http://www.rfc-editor.org/info/rfc7950>.
[RFC8044] DeKok, A., "Data Types in RADIUS", RFC 8044,
DOI 10.17487/RFC8044, January 2017,
<http://www.rfc-editor.org/info/rfc8044>.
8.2. Informative References
[I-D.ietf-i2rs-ephemeral-state]
Haas, J. and S. Hares, "I2RS Ephemeral State
Requirements", draft-ietf-i2rs-ephemeral-state-23 (work in
progress), November 2016.
[I-D.ietf-i2rs-protocol-security-requirements]
Hares, S., Migault, D., and J. Halpern, "I2RS Security
Related Requirements", draft-ietf-i2rs-protocol-security-
requirements-17 (work in progress), September 2016.
[I-D.ietf-i2rs-security-environment-reqs]
Migault, D., Halpern, J., and S. Hares, "I2RS Environment
Security Requirements", draft-ietf-i2rs-security-
environment-reqs-03 (work in progress), March 2017.
[I-D.ietf-netmod-revised-datastores]
Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
and R. Wilton, "A Revised Conceptual Model for YANG
Datastores", draft-ietf-netmod-revised-datastores-00 (work
in progress), December 2016.
Hares & Dass Expires September 11, 2017 [Page 20]
Internet-Draft I2RS Protocol Yang March 2017
Authors' Addresses
Susan Hares
Huawei
Saline
US
Email: shares@ndzh.com
Amit Daas
Ericsson
Email: amit.dass@ericsson.com
Hares & Dass Expires September 11, 2017 [Page 21]