<?xml version="1.0" encoding="utf-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc2629 version 1.4.19 -->

<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
]>

<?rfc toc="yes"?>
<?rfc sortrefs="yes"?>
<?rfc symrefs="yes"?>
<?rfc comments="yes"?>

<rfc ipr="trust200902" docName="draft-ietf-ccamp-yang-otn-slicing-02" category="std">

  <front>
    <title abbrev="Framework and YANG of OTN Slices">Framework and Data Model for OTN Network Slicing</title>

    <author initials="A." surname="Guo" fullname="Aihua Guo">
      <organization>Futurewei Technologies</organization>
      <address>
        <email>aihuaguo.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="L.M." surname="Contreras" fullname="Luis M. Contreras">
      <organization>Telefonica</organization>
      <address>
        <email>luismiguel.contrerasmurillo@telefonica.com</email>
      </address>
    </author>
    <author initials="S." surname="Belotti" fullname="Sergio Belotti">
      <organization>Nokia</organization>
      <address>
        <email>Sergio.belotti@nokia.com</email>
      </address>
    </author>
    <author initials="R." surname="Rokui" fullname="Reza Rokui">
      <organization>Ciena</organization>
      <address>
        <email>rrokui@ciena.com</email>
      </address>
    </author>
    <author initials="Y." surname="Xu" fullname="Yunbin Xu">
      <organization>CAICT</organization>
      <address>
        <email>xuyunbin@caict.ca.cn</email>
      </address>
    </author>
    <author initials="Y." surname="Zhao" fullname="Yang Zhao">
      <organization>China Mobile</organization>
      <address>
        <email>zhaoyangyjy@chinamobile.com</email>
      </address>
    </author>
    <author initials="X." surname="Liu" fullname="Xufeng Liu">
      <organization>IBM Corporation</organization>
      <address>
        <email>xufeng.liu.ietf@gmail.com</email>
      </address>
    </author>

    <date year="2022" month="July" day="11"/>

    
    <workgroup>CCAMP Working Group</workgroup>
    

    <abstract>


<t>The requirement of slicing network resources with desired quality of
   service is emerging at every network technology, including the
   Optical Transport Networks (OTN). As a part of the transport network,
   OTN can provide hard pipes with guaranteed data isolation and
   deterministic low latency, which are highly demanded in the Service
   Level Agreement (SLA).</t>

<t>This document describes a framework for OTN network slicing and a
   YANG data model augmentation of the OTN topology model. Additional
   YANG data model augmentations will be defined in a future version of
   this draft.</t>



    </abstract>


  </front>

  <middle>


<section anchor="introduction" title="Introduction">

<t>The requirement of slicing network resources with desired quality of
   service is emerging at every network technology, including the
   Optical Transport Networks (OTN). As a part of the transport network,
   OTN can provide hard pipes with guaranteed data isolation and
   deterministic low latency, which are highly demanded in the Service
   Level Agreement (SLA).
   This document describes a framework for OTN network slicing and a
   YANG data model augmentation of the OTN topology model. Additional
   YANG data model augmentations will be defined in a future version of
   this draft.</t>

<section anchor="terminology" title="Terminology">

<t>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 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they appear in all
   capitals, as shown here.</t>

<t>The terminology for describing YANG data models is found in
   <xref target="RFC7950"/>.</t>

</section>
<section anchor="prefixes-in-data-node-names" title="Prefixes in Data Node Names">

<t>In this document, names of data nodes and other data model objects
   are prefixed using the standard prefix associated with the
   corresponding YANG imported modules, as shown in <xref target="tab-prefixes"/>.</t>

<texttable title="Prefixes and Corresponding YANG Modules" anchor="tab-prefixes">
      <ttcol align='left'>Prefix</ttcol>
      <ttcol align='left'>YANG Module</ttcol>
      <ttcol align='left'>Reference</ttcol>
      <c>yang</c>
      <c>ietf-yang-types</c>
      <c><xref target="RFC6991"/></c>
      <c>inet</c>
      <c>ietf-inet-types</c>
      <c><xref target="RFC6991"/></c>
      <c>nt</c>
      <c>ietf-network-topology</c>
      <c><xref target="RFC8345"/></c>
      <c>nw</c>
      <c>ietf-network-topology</c>
      <c><xref target="RFC8345"/></c>
      <c>tet</c>
      <c>ietf-te-topology</c>
      <c><xref target="RFC8795"/></c>
      <c>te-types</c>
      <c>ietf-te-types</c>
      <c><xref target="RFC8776"/></c>
      <c>otnt</c>
      <c>ietf-otn-topology</c>
      <c>[RFCYYYY]</c>
      <c>l1-types</c>
      <c>ietf-layer1-types</c>
      <c>[RFCZZZZ]</c>
      <c>tns</c>
      <c>ietf-transport-network-slice</c>
      <c>RFCXXXX</c>
      <c>otns</c>
      <c>ietf-otn-slice</c>
      <c>RFCXXXX</c>
      <c>otns-mpi</c>
      <c>ietf-otn-slice-mpi</c>
      <c>RFCXXXX</c>
</texttable>

<t>RFC Editor Note:
Please replace XXXX with the RFC number assigned to this document.
Please replace YYYY with the RFC number assigned to <xref target="I-D.ietf-ccamp-otn-topo-yang"/>.
Please replace ZZZZ with the RFC number assigned to <xref target="I-D.ietf-ccamp-layer1-types"/>.
Please remove this note.</t>

</section>
<section anchor="definition-of-otn-slice" title="Definition of OTN Slice">
<t>An OTN slice is an OTN virtual network topology connecting a number
   of OTN endpoints using a set of shared or dedicated OTN network resources to
   satisfy specific service level objectives (SLOs).</t>

<t>An OTN slice is a technology-specific realization of an IETF network slice 
   <xref target="I-D.ietf-teas-ietf-network-slices"/> in the OTN domain, with the
   capability of configuring slice resources in the term of OTN technologies. 
   Therefore, all the terms and definitions concerning network slicing as 
   defined in <xref target="I-D.ietf-teas-ietf-network-slices"/> apply to OTN slicing.</t>

<t>An OTN slice can span multiple OTN administrative domains, encompassing 
   access links, intra-domain paths, and inter-domain links. 
   An OTN slice may include multiple endpoints, each associated with a set of physical
   or logical resources, e.g. optical port or time slots, at the termination point (TP) of 
   an access link or inter-domain link at an OTN provider edge (PE) equipment.</t>

<t>An end-to-end OTN slice may be composed of multiple OTN segment slices in
   a hierarchical or sequential (or stitched) combination.</t>

<t><xref target="fig-otn-slice"/> illustrates the scope of OTN slices in multi-domain 
   environment.</t>

<figure title="OTN Slice" anchor="fig-otn-slice"><artwork><![CDATA[
      <------------------End-to-end OTN Slice---------------->

      <- OTN Segment Slice 1 --->  <-- OTN Segment Slice 2 -->


       +-------------------------+  +-----------------------+
       | +-----+      +-------+  |  | +-------+      +-----+|
+----+ | | OTN |      | OTN   |  |  | | OTN   |      | OTN ||  +----+
| CE +-+-o PE  +-...--+ Borde o--+--+-o Borde +-...--+ PE  o+--+ CE |
+----+||/|     |      | Node  |\ || | | Node  |      |     || |+----+
      |||+-----+      +-------+| || | +-------+      +-----+| |
      |||    OTN Domain 1      | || |      OTN Domain 2     | |
      |++----------------------+-+| +-----------------------+ |
      | |                      |  |                           |
      | +-----+    +-----------+  |                           |
      |       |    |              |                           |
      V       V    V              V                           V
   Access    OTN Slice        Inter-domain                  Access
   Link      Endpoint         Link                          Link

]]></artwork></figure>

<t>OTN slices may be pre-configured by the management plane and presented to 
   the customer via the northbound interface (NBI), or be dynamically 
   provisioned by a higher layer slice controller, e.g., an IETF network slice 
   controller (IETF NSC) through the NBI. The OTN slice is 
   provided by a service provider to a customer to be used as though it was part
   of the customer’s own networks.</t>

</section>
</section>
<section anchor="use-cases-for-otn-network-slicing" title="Use Cases for OTN Network Slicing">

<section anchor="leased-line-services-with-otn" title="Leased Line Services with OTN">

<t>For end business customers (like OTT or enterprises), leased lines
   have the advantage of providing high-speed connections with low
   costs. On the other hand, the traffic control of leased lines is very
   challenging due to rapid changes in service demands. Carriers are
   recommended to provide network-level slicing capabilities to meet
   this demand. Based on such capabilities, private network users have
   full control over the sliced resources which have been allocated to them
   and which could be used to support their leased lines, when needed.
   Users may formulate policies based on the demand for services and
   time to schedule the resources from the entire network’s perspective
   flexibly. For example, the bandwidth between any two points may be
   established or released based on the time or monitored traffic
   characteristics. The routing and bandwidth may be adjusted at a
   specific time interval to maximize network resource utilization
   efficiency.</t>

</section>
<section anchor="co-construction-and-sharing" title="Co-construction and Sharing">

<t>Co-construction and sharing of a network are becoming a popular means
   among service providers to reduce networking building CAPEX. For Co-
   construction and sharing case, there are typically multiple co-
   founders for the same network. For example, one founder may provide
   optical fibres and another founder may provide OTN equipment, while
   each occupies a certain percentage of the usage rights of the network
   resources. In this scenario, the network O&amp;M is performed by a
   certain founder in each region, where the same founder usually
   deploys an independent management and control system. The other
   founders of the network use each other’s management and control
   system to provision services remotely. In this scenario, different
   founders’ network resources need to be automatically (associated)
   divided, isolated, and visualized. All founders may share or have
   independent O&amp;M capabilities, and should be able to perform service-
   level provisioning in their respective slices.</t>

</section>
<section anchor="wholesale-of-optical-resources" title="Wholesale of optical resources">

<t>In the optical resource wholesale market, smaller, local carriers and
   wireless carriers may rent resources from larger carriers, or
   infrastructure carriers instead of building their networks. Likewise,
   international carriers may rent resources from respective local
   carriers and local carriers may lease their owned networks to each
   other to achieve better network utilization efficiency.
   From the perspective of a resource provider, it is crucial that a
   network slice is timely configured to meet traffic matrix
   requirements requested by its tenants. The support for multi-tenancy
   within the resource provider’s network demands that the network
   slices are qualitatively isolated from each other to meet the
   requirements for transparency, non-interference, and security.
   Typically, a resource purchaser expects to use the leased network
   resources flexibly, just like they are self-constructed. Therefore,
   the purchaser is not only provided with a network slice, but also the
   full set of functionalities for operating and maintaining the network
   slice.  The purchaser also expects to, flexibly and independently, 
   schedule and maintain physical resources to support their own
   end-to-end automation using both leased and self-constructed network
   resources.</t>

</section>
<section anchor="vertical-dedicated-network-with-otn" title="Vertical dedicated network with OTN">

<t>Vertical industry slicing is an emerging category of network slicing
   due to the high demand for private high-speed network interconnects
   for industrial applications.
   In this scenario, the biggest challenge is to implement
   differentiated optical network slices based on the requirements from
   different industries. For example, in the financial industry, to
   support high-frequency transactions, the slice must ensure to provide
   the minimum latency along with the mechanism for latency management.
   For the healthcare industry, online diagnosis network and software
   capabilities to ensure the delivery of HD video without frame loss.
   For bulk data migration in data centers, the network needs to support
   on-demand, large-bandwidth allocation. In each of the aforementioned
   vertical industry scenarios, the bandwidth shall be adjusted as
   required to ensure flexible and efficient network resource usage.</t>

</section>
<section anchor="end-to-end-network-slicing" title="End-to-end network slicing">

<t>In an end-to-end network slicing scenario such as 5G network slicing
   <xref target="TS.28.530-3GPP"/>, an IETF network slice <xref target="I-D.ietf-teas-ietf-network-slices"/>
   provides the required connectivity between other different segments 
   of an end-to-end network slice, such as the Radio Access Network 
   (RAN) and the Core Network (CN) segments, with a specific 
   performance commitment. An IETF network slice could be composed of 
   network slices from multiple technological and administrative 
   domains. An IETF network slice can be realized by using or combining
   multiple underlying OTN slices with OTN resources, e.g., ODU time 
   slots or ODU containers, to achieve end-to-end slicing across the transport
   domain.</t>

</section>
</section>
<section anchor="framework-for-otn-slicing" title="Framework for OTN slicing">

<t>OTN slices may be abstracted differently depending on the requirement contained
   in the configuration provided by the slice customer. Whereas the customer requests
   an OTN slice to provide connectivity between specified endpoints, an OTN slice 
   can be abstracted as a set of endpoint-to-endpoint links, with each link formed 
   by an end-to-end tunnel across the underlying OTN networks. The resources
   associated with each link of the slice is reserved and commissioned in the underlying
   physical network upon the completion of configuring the OTN slice and all the 
   links are active.</t>

<t>An OTN slice can also be abstracted as an abstract topology when the customer requests
   the slice to share resources between multiple endpoints and to use the resources on demand.
   The abstract topology may consist of virtual nodes and virtual links, and their associated
   resources are reserved but not commissioned across the underlying OTN networks. The 
   customer can later commission resources within the slice dynamically using the NBI provided
   by the service provider. An OTN slice could use abstract topology to connect endpoints with 
   shared resources to optimize the resource utilization, and connections can be activated 
   within the slice as needed.</t>

<t>It is worth noting that those means to abstract an OTN slice are similar to the Virtual 
   Network (VN) abstraction defined for higher-level interfaces in <xref target="RFC8453"/>, in which context
   a connectivity-based slice corresponds to Type 1 VN and a resource-based slice corresponds to 
   Type 2 VN, respectively.</t>

<t>A particular resource in an OTN network, such as a port or link, may be
   sliced with one of the two granularity levels:</t>

<t><list style="symbols">
  <t>Link-based slicing, in which a link and its associated link
termination points (LTPs) are dedicatedly allocated to a
particular OTN slice.</t>
  <t>Tributary-slot based slicing, in which multiple OTN slices
share the same link by allocating different OTN tributary slots in
different granularities.</t>
</list></t>

<t>Furthermore, an OTN switch is typically fully non-blocking switching 
   at the lowest ODU container granularity, it is
desirable to specify just the total number of ODU containers in the
lowest granularity (e.g. ODU0), when configuring tributary-slot based
slicing on links and ports internal to an OTN network. In multi-domain
OTN network scenarios where separate OTN slices are created on
each of the OTN networks and are stitched at inter-domain OTN links, it
is necessary to specify matching tributary slots at the endpoints of the
inter-domain links. In some real network scenarios, OTN network resources
including tributary slots are managed explicitly by network operators for
network maintenance considerations. Therefore, an OTN slice controller
shall support configuring an OTN slice with both options.</t>

<t>An OTN slice controller (OTN-SC) is a logical function responsible for
   the life-cycle management of OTN slices instantiated within the 
   corresponding OTN network domains. The OTN-SC provides technology-specific 
   interfaces at its northbound (OTN-SC NBI) to allow a higher-layer slice 
   controller, such as an IETF network slice controller (NSC) or an orchestrator, 
   to request OTN slices with OTN-specific 
   requirements. The OTN-SC interfaces at the southbound using the MDSC-to-PNC 
   interface (MPI) with a Physical Network Controller (PNC) or Multi-Domain Service Orchestrator (MDSC),
   as defined in the ACTN control framework <xref target="RFC8453"/>. The logical function 
   within the OTN-SC is responsible for translating the OTN slice requests 
   into concrete slice realization which can be understood and 
   provisioned at the southbound by the PNC or MDSC.</t>

<t>The presence of OTN-SC provides multiple options for a high-level slice controller 
   or an orchestrator to configure and realize slicing in OTN networks, depending on
   whether a customer’s slice request is technology agnostic or technology specific:</t>

<t>Option 1[opt.1]: An IETF NSC receives a technology-agnostic slice request from the IETF NSC NBI and
   realizes full or part of the slice in OTN networks directly through MPI provided by
   the PNC or MDSC. The IETF NSC is responsible for mapping a technology-agnostic slicing request 
   into an OTN technology-specific realization. In this option, the OTN-SC is not used.</t>

<t>Option 2[opt.2]: An IETF NSC receives a technology-agnostic slice request from the IETF NSC NBI and delegates the
   request to the OTN-SC through the OTN-SC NBI, which is OTN technology specific. The OTN-SC in turn realizes the slice in single or multi domain OTN networks by working with the underlying PNC or MDSC. In this option, the OTN-SC is considered as a realization of IETF NSC, i.e.,
   an NS realizer as per <xref target="I-D.draft-contreras-teas-slice-controller-models"/>,
   when the underlying network is OTN. The OTN-SC is also a subordinate slice controller of the IETF NSC, which 
   is consistent with the hierarchical control of slices defined by the IETF network slice framework.</t>

<t>Option 3[opt.3]: An OTN-aware orchestrator may request an OTN technology-specific slice with OTN-specific SLOs through the 
   OTN-SC NBI to the OTN-SC. The OTN-SC in turn realizes the slice in single or multi domain OTN networks by working with the underlying PNC or MDSC</t>

<t>An OTN slice may be realized by using standard MPI interfaces, control plane, network management system (NMS) or any other proprietary interfaces as needed. Examples of such interfaces include the abstract TE topology <xref target="RFC8795"/>, TE tunnel <xref target="I-D.ietf-teas-yang-te"/>,L1VPN<xref target="RFC4847"/>, or Netconf/YANG based interfaces such as OpenConfig. Some of these interfaces, such as the TE tunnel model, are suitable for creating connectivity-based OTN slices which represent a slice as a set of TE tunnels, while other interfaces such as the TE topology model are more suitable for creating resource-based OTN slices which represent a slice as a topology.</t>

<t>The OTN-SC NBI is a technology-specific interface that augments the IETF NSC NBI, which is technology-
   agnostic.</t>

<t><xref target="fig-slice-interfaces"/> illustrates the OTN slicing control hierarchy 
   , the positioning of the OTN slicing interfaces as well as the options for OTN slice configuration.</t>

<figure title="Positioning of OTN Slicing Interfaces" anchor="fig-slice-interfaces"><artwork><![CDATA[
                      +--------------------+
                      | Provider's User    |
                      +--------|-----------+
                               | CMI
       +-----------------------+----------------------------+
       |          Orchestrator / E2E Slice Controller       | 
       +------------+-----------------------------+---------+
                    |                             | NSC-NBI
                    |       +---------------------+---------+
                    |       | IETF Network Slice Controller |
                    |       +-----+---------------+---------+
                    | opt.3       | opt.2         | opt.1
                    | OTN-SC NBI  |OTN-SC NBI     |               
       +------------+-------------+--------+      |
       |               OTN-SC              |      |
       +--------------------------+--------+      |      
                                  | MPI           | MPI                           
       +--------------------------+---------------+---------+ 
       |                         PNC                        | 
       +--------------------------+-------------------------+ 
                                  | SBI
                      +-----------+----------+
                      |OTN Physical Network  |
                      +----------------------+

]]></artwork></figure>

<t>OTN-SC functionalities may be recursive such that a higher-level
   OTN-SC may designate the creation of OTN slices to a lower-level
   OTN-SC in a recursive manner. This scenario may apply to the
   creation of OTN slices in multi-domain OTN networks, where 
   multiple domain-wide OTN slices provisioned by lower-layer
   OTN-SCs are stitched to support a multi-domain OTN slice
   provisioned by the higher-level OTN-SC.  Alternatively, the OTN-SC
   may interface with an MDSC, which in turn interfaces with multiple 
   PNCs through the MPI to realize OTN slices in multi-domain OTN networks 
   without OTN-SC recursion. 
   <xref target="fig-otn-sc-recursion"/> illustrates both options for OTN slicing
   in multi-domain.</t>

<figure title="OTN-SC for multi-domain" anchor="fig-otn-sc-recursion"><artwork><![CDATA[
    +-------------------+                    +-------------------+
    |      OTN-SC       |                    |      OTN-SC       |
    +--------|----------+                    +---|----------|----+
             |MPI                                |OTN-SC NBI|
    +--------|----------+                    +---|----+ +---|----+
    |      MDSC         |                    | OTN-SC | | OTN-SC |
    +---|----------|----+                    +---|----+ +---|----+
        |MPI       |MPI                          |MPI       |MPI
    +---|----+ +---|----+                    +---|----+ +---|----+
    |   PNC  | |   PNC  |                    |   PNC  | |   PNC  |
    +--------+ +--------+                    +--------+ +--------+
    Multi-domain Option 1                    Multi-domain Option 2
]]></artwork></figure>

<t>OTN-SC functionalities are logically independent and may be deployed in 
   different combinations to cater to the realization needs. In reference to the 
   ACTN control framework <xref target="RFC8453"/>, an OTN-SC may be deployed</t>

<t><list style="symbols">
  <t>as an independent network function;</t>
  <t>together with a Physical Network Controller (PNC) for single-domain
 or with a Multi-Domain Service Orchestrator (MDSC)for multi-domain;</t>
  <t>together with a higher-level network slice controller to support 
 end-to-end network slicing;</t>
</list></t>

</section>
<section anchor="realizing-otn-slices" title="Realizing OTN Slices">

<t><xref target="I-D.ietf-teas-ietf-network-slices"/> introduces a mechanism for an IETF network slice controller to realize network slices by constructing Network Resource Partitions (NRP). A NRP is a collection of resources identified in the underlay network to facilitate the mapping of network slices onto available network resources. An NRP is a scope view of a topology and may be considered as a topology in its own right. Thus, in traffic-engineered (TE) networks including OTN, an NRP may be simply represented as an abstract TE topology defined by <xref target="RFC8795"/>. For OTN networks, An NRP may be represented as an abstract OTN topology defined by <xref target="I-D.ietf-ccamp-otn-topo-yang"/>.</t>

<t>The NRP may be used to address the scalability issues where there may be considerable numbers of control and data plane states required to be stored and programmed if network slices are mapped directly to the underlay topology. NRP is internal to a network slice controller, and use of NRPs is optional yet could benefit a network slice realization in large-scale networks, including OTN networks.</t>

<t>For connectivity-based OTN slices, a connection within an OTN slice is typically realized by an OTN tunnel in the underlay topology and resources are reserved by the tunnel, thus use of NRP is optional in this case.</t>

<t>For resource-based OTN slices, the OTN-SC may map an OTN slice directly onto the underlay TE topology presented by the subtended network controller (MDSC or PNC) without creating NRP topologies. Due to the need for reserving resources, the OTN-SC needs to color corresponding link resources of the underlay topology with a slice identifier and maintain the coloring to keep track of the mapping of OTN slices. The OTN-SC may push the colored topology to the subtended MDSC or PNC using the MPI model defined in this draft.</t>

<t>Alternatively, an OTN slice may be mapped to a NRP as an overlay abstract OTN TE topology on top of the underlay topology. The corresponding link resources allocated to the slice is encapsulated in and tracked by the abstract topology, and a given link or port in the NRP topology represents resources that are reserved in the underlay topology. One slice topology for a resource-based OTN slice is typically realized by one dedicated NRP topology, and all the resources within that NRP topology are reserved for the OTN slice. In this case, the use of NRP eliminates the need for coloring links in the underlay topology, and the NRP topology may be pushed directly to the subtended MDSC or PNC by the OTN-SC.</t>

<t>Multiple OTN slices may be mapped to the same NRP, and a single connectivity construct of the slice may be mapped to only one NRP, as per <xref target="I-D.ietf-teas-ietf-network-slices"/>.</t>

<t><xref target="fig-otn-sc-nrp"/> illustrates the relationship between OTN slices and NRP.</t>

<figure title="Mapping OTN Slices to NRP" anchor="fig-otn-sc-nrp"><artwork><![CDATA[
        /---------------/      |            /---------------/
       /  --     --    /       |           /  --     --    /
      /  |N1|---|N3|  /        |          /  |N2|   |N3|  /
     /    --\    --  /         |         /    --     --  /
    /        \--    /          |        /       \ --/   /
   /         |N2|  /           |       /         |N4|  /
  / Slice 1   --  /            |      / Slice 2   --  /
 /------------<--/             |     /-----------<---/
              <                |                 <
+-------------<----------------V-----------------<------------+
|          /--<--------------/             /-----<-----------/|
|         / /--\     /--\   /             /          /--\   / |
|        / |NE1 |---|NE2 | /             /          |NE2 | /  |
|       /   \--/\  . \--/ /             /            \--/ /   |
|      /       ..\ ........            /              /. /    |
|     /        . /--\   / .           / /--\     /--\/ ./     |
|    /         .|NE4 | /  .          / |NE3 |---|NE4 | .      |
|   /          . \--/ /   .         /   \--/  .  \--/ /.      |
|  /  NRP Topology 1 /    .        /  NRP Topology 2 / .      |
| /------------.----/     .       /-----------.-----/  .      |
|              .......    .                   .        .      |
|             /------.----.-----------------/ .        .      |
|            / /--\  .    .     /--\       /  .        .      |
|           / |NE1 |-.----v----|NE2 |     /   .        .      |
|          /   ---/\ .         /\--/     /    .        .      |
|         /   /     \v        /<........................      |
|        / /-/\      \ /--\  /         /      .               |
|       / |NE3 |------|NE4 |/         /       .               |
|      /   \--/  ^     \--/          /        .               |
|     /  Underlay.OTN TE Topology   /         .               |
|    /-----------.-----------------/          .               |
|                ..............................     OTN-SC    |
+-------------------------------------------------------------+
                 |                         ^
                 |MPI                      |MPI
+----------------V--------------------------------------------+
|                                                             |
|                       OTN MDSC/PNC                          |
+-------------------------------------------------------------+
]]></artwork></figure>

</section>
<section anchor="yang-data-model-for-otn-slicing-configuration" title="YANG Data Model for OTN Slicing Configuration">

<section anchor="otn-slicing-yang-model-for-mpi" title="OTN Slicing YANG Model for MPI">

<section anchor="mpi-yang-model-overview" title="MPI YANG Model Overview">

<t>For the configuration of connectivity-based OTN slices, existing models such as 
   the TE tunnel interface <xref target="I-D.ietf-teas-yang-te"/> may be used and no addition is 
   needed. This model is addressing the case for configuring resource-based OTN slices,
   where the model permits to reserve resources exploiting the common knowledge of an underlying 
   virtual topology between the OTN-SC and the subtended network controller (MDSC or PNC). The slice
   is configured by marking corresponding link resources on the TE topology received from the 
   underlying MDSC or PNC with a slice identifier and OTN-specific resource requirements, 
   e.g. the number of ODU time slots or the type/number of ODU containers. The MDSC or PNC, based on the 
   marked resources by the OTN-SC, will update the underlying TE topology with new TE link for each of 
   the colored links to keep booked the reserved OTN resources e.g. time slots or ODU containers.</t>

</section>
<section anchor="mpi-yang-model-tree" title="MPI YANG Model Tree">

<figure title="OTN slicing MPI tree diagram" anchor="fig-otn-slice-mpi-tree"><artwork><![CDATA[
module: ietf-otn-slice-mpi

  augment /nw:networks/nw:network/nt:link/tet:te
            /tet:te-link-attributes:
    +--rw (otn-slice-granularity)?
       +--:(link)
       |  +--rw slice-id?   uint32
       +--:(link-resource)
          +--rw slices* [slice-id]
             +--rw slice-id                  uint32
             +--rw (technology)?
             |  +--:(otn)
             |     +--rw (slice-bandwidth)?
             |        +--:(containers)
             |        |  +--rw odulist* [odu-type]
             |        |     +--rw odu-type    identityref
             |        |     +--rw number?     uint16
             |        +--:(time-slots)
             |           +--rw otn-ts-num?   uint32
             +--ro sliced-link-ref?
                     -> ../../../../../nt:link/link-id
]]></artwork></figure>

</section>
<section anchor="mpi-yang-code" title="MPI YANG Code">

<figure title="OTN slicing MPI YANG model" anchor="fig-otn-slice-mpi-yang"><artwork><![CDATA[
   <CODE BEGINS> file "ietf-otn-slice-mpi@2022-07-09.yang"
   module ietf-otn-slice-mpi {
     yang-version 1.1;
     namespace "urn:ietf:params:xml:ns:yang:ietf-otn-slice-mpi";
     prefix "otns-mpi";

     import ietf-network {
       prefix "nw";
       reference 
         "RFC 8345: A YANG Data Model for Network Topologies";
     }

     import ietf-network-topology {
       prefix "nt";
       reference 
         "RFC 8345: A YANG Data Model for Network Topologies";
     }

     import ietf-te-topology {
       prefix "tet";
       reference
         "RFC8795: YANG Data Model for Traffic Engineering
         (TE) Topologies";
     }

     import ietf-otn-topology {
       prefix "otnt";
       reference
         "I-D.ietf-ccamp-otn-topo-yang: A YANG Data Model
          for Optical Transport Network Topology";
     }

     import ietf-layer1-types {
       prefix "l1-types";
       reference
         "I-D.ietf-ccamp-layer1-types: A YANG Data Model
          for Layer 1 Types";
     }

     organization
       "IETF CCAMP Working Group";
     contact
       "WG Web: <http://tools.ietf.org/wg/ccamp/>
        WG List: <mailto:ccamp@ietf.org>

        Editor: Haomian Zheng
                <mailto:zhenghaomian@huawei.com>

        Editor: Italo Busi
                <mailto:italo.busi@huawei.com>

        Editor: Aihua Guo
                <mailto:aihuaguo.ietf@gmail.com>

        Editor: Sergio Belotti
                <mailto:sergio.belotti@nokia.com>";

     description
       "This module defines a YANG data model for network slice
        realization in Optical Transport Networks (OTN).

        The model fully conforms to the Network Management Datastore
        Architecture (NMDA).

        Copyright (c) 2022 IETF Trust and the persons identified as
        authors of the code.  All rights reserved.

        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 Revised 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).

        This version of this YANG module is part of RFC XXXX; see the
        RFC itself for full legal notices.";

     revision "2022-07-09" {
       description
         "Latest revision of MPI YANG model for OTN slicing.";
       reference
         "draft-ietf-ccamp-yang-otn-slicing-02: Framework and Data
          Model for OTN Network Slicing";
     }

     /*
      * Groupings
      */

     grouping otn-link-slice-profile {
       description
         "Profile of an OTN link slice.";
       choice otn-slice-granularity {
         default "link";
         description
           "Link slice granularity.";
         case link {
           leaf slice-id {
             type uint32;
              description
                "Slice identifier";
           }
         }
         case link-resource {
           list slices {
             key slice-id;
             description
               "List of slices.";
             leaf slice-id {
               type uint32;
               description
                 "Slice identifier";
             }
             choice technology {
               description
                 "Data plane technology types.";
               case otn {
                 choice slice-bandwidth {
                   description
                     "Bandwidth specification for OTN slices.";
                   case containers {
                     uses l1-types:otn-link-bandwidth;
                   }
                   case time-slots {
                     leaf otn-ts-num {
                       type uint32;
                       description
                         "Number of OTN tributary slots allocated
                          for the slice.";
                     }
                   }
                 }
               }
             }
             leaf sliced-link-ref {
               type leafref {
                 path "../../../../../nt:link/nt:link-id";
               }
               config false;
               description
                 "Relative reference to virtual links generated from
                  this TE link.";
             }
           }
         }
       }
     }

     /*
      * Augments
      */
     augment "/nw:networks/nw:network/nt:link/tet:te/"
           + "tet:te-link-attributes" {
       when "../../../nw:network-types/tet:te-topology/"
          + "otnt:otn-topology" {
         description
           "Augmentation parameters apply only for networks with
            OTN topology type.";
       }
       description
         "Augment OTN TE link attributes with slicing profile.";
       uses otn-link-slice-profile;
     }
   }
   <CODE ENDS>
]]></artwork></figure>

</section>
</section>
<section anchor="otn-slicing-yang-model-for-otn-sc-nbi" title="OTN Slicing YANG Model for OTN-SC NBI">

<section anchor="nbi-yang-model-overview" title="NBI YANG Model Overview">
<t>The YANG model for OTN-SC NBI is OTN-technology specific, but shares many
   common constructs and attributes with generic network slicing YANG models.
   Furthermore, the OTN-SC NBI YANG is expected to support both connectivity-based
   and resource-based slice configuration, which is likely a common requirement for
   supporting slicing at other transport network layers, e.g. WDM or MPLS(-TP).
   Therefore, the OTN-SC NBI YANG model is designed into two models, a common base 
   model for transport network slicing, and an OTN slicing model which augments the 
   base model with OTN technology-specific constructs.</t>

<t>The base model defines a transport network slice (TNS) with the following
   constructs and attributes:</t>

<t><list style="symbols">
  <t>Common attributes, which include a set of common attributes like slice identifier,
name, description, and names of customers who use the slice.</t>
  <t>Endpoints, which represent conceptual points of connection from a customer
device to the TNS. An endpoint is mapped to specific physical or virtual resources
 of the customer and provider, and such mapping is pre-negotiated and known to 
 both the customer and provider prior to the slice configuration. The mechanism 
 for endpoint negotiation is outside the scope of this draft.</t>
  <t>Network topology, which represent set of shared, reserved resources organized as a virtual 
 topology between all of the endpoints. A customer could use such network topology
 to define detailed connectivity path traversing the topology, and allow sharing of 
 resources between its multiple endpoint pairs.</t>
  <t>Connectivity matrix, which represent the intended virtual connections between the endpoints
 within a TNS. A connectivity matrix entry could be associated with an explicit path 
 over the above network topology.</t>
  <t>Service-level objectives (SLOs) associated with different objects, including the TNS, 
 node, link, termination point, and explicit path, within a TNS.</t>
</list></t>

</section>
<section anchor="nbi-yang-model-tree-for-transport-network-slice" title="NBI YANG Model Tree for Transport Network Slice">

<figure title="Tree diagram for transport network slice" anchor="fig-ietf-transport-network-slice"><artwork><![CDATA[
module: ietf-transport-network-slice

  augment /ietf-nss:network-slice-services/ietf-nss:slice-service:
    +--rw network-topologies
       +--rw network-topology* [topology-id]
          +--rw topology-id       string
          +--rw slo-sle-policy
          |  +--rw optimization-criterion?   identityref
          |  +--rw delay-tolerance?          boolean
          |  +--rw periodicity*              uint64
          |  +--rw isolation-level?          identityref
          +--rw node* [node-id]
          |  +--rw node-id              inet:uri
          |  +--rw slo-sle-policy
          |  |  +--rw optimization-criterion?   identityref
          |  |  +--rw delay-tolerance?          boolean
          |  |  +--rw periodicity*              uint64
          |  |  +--rw isolation-level?          identityref
          |  +--rw termination-point* [tp-id]
          |     +--rw tp-id     inet:uri
          |     +--rw sdp-id?   leafref
          +--rw link* [link-id]
             +--rw link-id           inet:uri
             +--rw slo-sle-policy
             |  +--rw optimization-criterion?   identityref
             |  +--rw delay-tolerance?          boolean
             |  +--rw periodicity*              uint64
             |  +--rw isolation-level?          identityref
             +--rw source
             |  +--rw source-node?   -> ../../../node/node-id
             |  +--rw source-tp?     leafref
             +--rw destination
                +--rw dest-node?   -> ../../../node/node-id
                +--rw dest-tp?     leafref
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct:
    +--rw topology-id?     leafref
    +--rw explicit-path* [tp-id]
       +--rw tp-id    leafref
]]></artwork></figure>

</section>
<section anchor="nbi-yang-code-for-transport-network-slice" title="NBI YANG Code for Transport Network Slice">

<figure title="YANG model for transport network slice" anchor="fig-ietf-transport-network-yang"><artwork><![CDATA[
   <CODE BEGINS> file "ietf-transport-network-slice@2022-07-09.yang"
   module ietf-transport-network-slice {
     yang-version 1.1;
     namespace
       "urn:ietf:params:xml:ns:yang:ietf-transport-network-slice";
     prefix "tns";

     import ietf-inet-types {
       prefix inet;
       reference 
         "RFC 6991: Common YANG Data Types";
     }
     import ietf-te-types {
       prefix "te-types";
       reference
         "RFC 8776: Traffic Engineering Common YANG Types";
     }

     import ietf-network-slice-service {
       prefix "ietf-nss";
       reference
         "draft-ietf-teas-ietf-network-slice-nbi-yang-00:
                  IETF Network Slice Service YANG Model";
     }
         
     organization
       "IETF CCAMP Working Group";
     contact
       "WG Web: <http://tools.ietf.org/wg/ccamp/>
        WG List: <mailto:ccamp@ietf.org>

        Editor: Haomian Zheng
                <mailto:zhenghaomian@huawei.com>

        Editor: Italo Busi
                <mailto:italo.busi@huawei.com>

        Editor: Aihua Guo
                <mailto:aihuaguo.ietf@gmail.com>

        Editor: Sergio Belotti
                <mailto:sergio.belotti@nokia.com>";

     description
       "This module defines a base YANG data model for configuring
        generic network slices in optical transport networks, e.g.,
        Optical Transport Network (OTN).

        The model fully conforms to the Network Management Datastore
        Architecture (NMDA).

        Copyright (c) 2022 IETF Trust and the persons identified as
        authors of the code.  All rights reserved.

        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 Revised 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).

        This version of this YANG module is part of RFC XXXX; see the
        RFC itself for full legal notices.";

     revision "2022-07-09" {
       description
         "Latest revision of NBI YANG model for OTN slicing.";
       reference
         "draft-ietf-ccamp-yang-otn-slicing-02: Framework and Data
          Model for OTN Network Slicing";
     }

     /*
      * Identities
      */
     identity isolation-level {
       description
         "Base identity for the isolation-level.";
       reference
         "GSMA-NS-Template: Generic Network Slice Template,
          Version 3.0.";
     }
     identity no-isolation {
       base isolation-level;
       description
         "Network slices are not separated.";
     }
     identity physical-isolation {
       base isolation-level;
       description
         "Network slices are physically separated (e.g. different
          rack, different hardware, different location, etc.).";
     }
     identity logical-isolation {
       base isolation-level;
       description
         "Network slices are logically separated.";
     }
     identity process-isolation {
       base physical-isolation;
       description
         "Process and threads isolation.";
     }
     identity physical-memory-isolation {
       base physical-isolation;
       description
         "Process and threads isolation.";
     }
     identity physical-network-isolation {
       base physical-isolation;
       description
         "Process and threads isolation.";
     }
     identity virtual-resource-isolation {
       base logical-isolation;
       description
         "A network slice has access to specific range of resources
          that do not overlap with other network slices
          (e.g. VM isolation).";
     }
     identity network-functions-isolation {
       base logical-isolation;
       description
         "NF (Network Function) is dedicated to the network slice,
          but virtual resources are shared.";
     }
     identity service-isolation {
       base logical-isolation;
       description
         "NSC data are isolated from other NSCs, but virtual
          resources and NFs are shared.";
     }

     /*
      * Groupings
      */

     grouping slo-sle-policy {
       description
         "Policy grouping for Transport Network Slices.";

       container slo-sle-policy {
         description
           "SLO/SLE policy container";
   
       leaf optimization-criterion {
           type identityref {
             base te-types:objective-function-type;
           }
           description
             "Optimization criterion applied to this topology.";
         }
         leaf delay-tolerance {
           type boolean;
           description
             "'true' if is not too critical how long it takes to
              deliver the amount of data.";
           reference
             "GSMA-NS-Template: Generic Network Slice Template,
              Version 3.0.";
         }
         leaf-list periodicity {
           type uint64;
           units seconds;
           description
             "A list of periodicities supported by the network
              slice.";
           reference
             "GSMA-NS-Template: Generic Network Slice Template,
              Version 3.0.";
         }
         leaf isolation-level {
           type identityref {
             base isolation-level;
           }
           description
             "A network slice instance may be fully or partly,
              logically and/or physically, isolated from another
              network slice instance. This attribute describes
              different types of isolation:";
         }
       }
     }

     grouping network-topology-def {
       description
         "Network topology definition";
       uses slo-sle-policy;
       list node {
         key "node-id";
         description
         "The inventory of nodes of this topology.";
         leaf node-id {
           type inet:uri;
           description
             "Node identifier.";
         }
         uses slo-sle-policy;
         list termination-point {
           key "tp-id";
           description
             "TP identifier";
           leaf tp-id {
             type inet:uri;
             description
               "Termination point identifier.";
           }
           leaf sdp-id {
             type leafref {
               path "/ietf-nss:network-slice-services"+
                    "/ietf-nss:slice-service"+
                    "[ietf-nss:service-id=current()"+
                    "/../../../../../ietf-nss:service-id]"+
                    "/ietf-nss:sdps/ietf-nss:sdp/ietf-nss:sdp-id";
             }
             description
               "Relative reference to SDP id.";
           }
         }
       }
       list link {
         key "link-id";
         description
           "Link identifier.";
         leaf link-id {
           type inet:uri;
           description
             "Link identifier.";
         }
         uses slo-sle-policy;
         container source {
           description
             "Link source node";
           leaf source-node {
             type leafref {
               path "../../../node/node-id";
             }
             description
               "Source node identifier, must be in same topology.";
           }
           leaf source-tp {
             type leafref {
               path "../../../node[node-id=current()/../"+
                    "source-node]/termination-point/tp-id";
             }
             description
               "Termination point within source node that
                            terminates the link.";
           }
         }
         container destination {
           description
             "Link destination node";
           leaf dest-node {
             type leafref {
               path "../../../node/node-id";
             }
             description
               "Destination node identifier, must be in same
                topology.";
           }
           leaf dest-tp {
             type leafref {
               path "../../../node[node-id=current()/../"+
                    "dest-node]/termination-point/tp-id";
             }
             description
               "Termination point within destination node that
                terminates the link.";
           }
         }
       }
     }

     grouping topology-ref {
           description
             "Grouping for network topology reference.";
       leaf topology-id {
         type leafref {
           path "../../../../network-topologies/network-topology"+
                "/topology-id";
         }
         description
           "Relative reference to network topology id.";
       }
       uses explicit-path;
     }

     grouping explicit-path {
       description
         "Explicit path for a connectivity matrix entry";

       list explicit-path {
         key "tp-id";
         description
           "List of TPs within a network topology that form a
            path.";
         leaf tp-id {
           type leafref {
             path "/ietf-nss:network-slice-services"+
                  "/ietf-nss:slice-service"+
                  "[ietf-nss:service-id=current()"+
                  "/../../../../../ietf-nss:service-id]"+
                  "/network-topologies"+
                  "/network-topology[topology-id=current()"+
                  "/../../topology-id]/node/termination-point"+
                  "/tp-id";
           }
           description
             "Relative reference to TP id.";
         }
       }
     }

     /*
      * Augmented data nodes
      */
         augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" {
           description
             "Augment IETF network slice services to include network
                  topologies.";
           container network-topologies {
             description
           "Set of network topologies referenced by network slices";

             list network-topology {
                   key "topology-id";
                   description
                     "List of network topologies";
                   leaf topology-id {
                     type string;
                     description
                           "Topology identifier";
                   }
                   uses network-topology-def;
             }
           }
     }
         
         augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct"{
       description
         "Add toplogy id and explicit path to a connectivity
                  construct";
           uses topology-ref;
     }
   }
   <CODE ENDS>
]]></artwork></figure>

</section>
<section anchor="nbi-yang-model-tree-for-otn-slice" title="NBI YANG Model Tree for OTN slice">

<t>TBD.</t>

</section>
<section anchor="nbi-yang-code-for-otn-slice" title="NBI YANG Code for OTN Slice">

<t>TBD.</t>

</section>
</section>
</section>
<section anchor="manageability-considerations" title="Manageability Considerations">

<t>To ensure the security and controllability of physical resource
   isolation, slice-based independent operation and management are
   required to achieve management isolation.
   Each optical slice typically requires dedicated accounts,
   permissions, and resources for independent access and O&amp;M. This
   mechanism is to guarantee the information isolation among slice
   tenants and to avoid resource conflicts. The access to slice
   management functions will only be permitted after successful security
   checks.</t>

</section>
<section anchor="security-considerations" title="Security Considerations">

<t>The YANG module specified in this document defines a schema for data
   that is designed to be accessed via network management protocols such
   as NETCONF <xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>.  The lowest NETCONF layer
   is the secure transport layer, and the mandatory-to-implement secure
   transport is Secure Shell (SSH) <xref target="RFC6242"/>.  The lowest RESTCONF layer
   is HTTPS, and the mandatory-to-implement secure transport is TLS
   <xref target="RFC8446"/>.</t>

<t>The NETCONF access control model <xref target="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.</t>

<t>There are a number of data nodes defined in this YANG module 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.  Considerations in Section 8 of
   <xref target="RFC8795"/> are also applicable to their subtrees in the module defined
   in this document.</t>

<t>Some of the readable data nodes in this YANG module may be considered
   sensitive or vulnerable in some network environments.  It is thus
   important to control read access (e.g., via get, get-config, or
   notification) to these data nodes.  Considerations in Section 8 of
   <xref target="RFC8795"/> are also applicable to their subtrees in the module defined
   in this document.</t>

</section>
<section anchor="iana-considerations" title="IANA Considerations">

<t>It is proposed to IANA to assign new URIs from the “IETF XML
   Registry” <xref target="RFC3688"/> as follows:</t>

<figure><artwork><![CDATA[
   URI: urn:ietf:params:xml:ns:yang:ietf-transport-network-slice
   Registrant Contact: The IESG
   XML: N/A; the requested URI is an XML namespace.

   URI: urn:ietf:params:xml:ns:yang:ietf-otn-slice
   Registrant Contact: The IESG
   XML: N/A; the requested URI is an XML namespace.
]]></artwork></figure>

<t>This document registers a YANG module in the YANG Module Names
   registry <xref target="RFC6020"/>.</t>

<figure><artwork><![CDATA[
   name: ietf-transport-network-slice
   namespace: urn:ietf:params:xml:ns:yang:ietf-transport-network-slice
   prefix: tns
   reference: RFC XXXX

   name: ietf-otn-slice
   namespace: urn:ietf:params:xml:ns:yang:ietf-otn-slice
   prefix: otns
   reference: RFC XXXX

   name: ietf-otn-slice-mpi
   namespace: urn:ietf:params:xml:ns:yang:ietf-otn-slice-mpi
   prefix: otns-mpi
   reference: RFC XXXX
]]></artwork></figure>

</section>


  </middle>

  <back>

    <references title='Normative References'>

<reference anchor="TS.28.530-3GPP" target="http://ftp.3gpp.org//Specs/archive/28_series/28.530/28530-f10.zip">
  <front>
    <title>3GPP TS 28.530 V15.1.0 Technical Specification Group Services and System Aspects; Management and orchestration; Concepts, use cases and requirements (Release 15)</title>
    <author >
      <organization>3rd Generation Partnership Project (3GPP)</organization>
    </author>
    <date year="2018" month="December"/>
  </front>
  <seriesInfo name="3GPP TS 28.530" value=""/>
</reference>
<reference anchor="GSMA-NS-Template" target="https://www.gsma.com/newsroom/wp-content/uploads//NG.116-v5.0-7.pdf">
  <front>
    <title>Generic Network Slice Template, Version 5.0</title>
    <author >
      <organization>GSMA Association</organization>
    </author>
    <date year="2021" month="June"/>
  </front>
  <seriesInfo name="NG.116" value=""/>
</reference>




<reference anchor='RFC2119' target='https://www.rfc-editor.org/info/rfc2119'>
<front>
<title>Key words for use in RFCs to Indicate Requirement Levels</title>
<author fullname='S. Bradner' initials='S.' surname='Bradner'><organization/></author>
<date month='March' year='1997'/>
<abstract><t>In many standards track documents several words are used to signify the requirements in the specification.  These words are often capitalized. This document defines these words as they should be interpreted in IETF documents.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t></abstract>
</front>
<seriesInfo name='BCP' value='14'/>
<seriesInfo name='RFC' value='2119'/>
<seriesInfo name='DOI' value='10.17487/RFC2119'/>
</reference>



<reference anchor='RFC8174' target='https://www.rfc-editor.org/info/rfc8174'>
<front>
<title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
<author fullname='B. Leiba' initials='B.' surname='Leiba'><organization/></author>
<date month='May' year='2017'/>
<abstract><t>RFC 2119 specifies common key words that may be used in protocol  specifications.  This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the  defined special meanings.</t></abstract>
</front>
<seriesInfo name='BCP' value='14'/>
<seriesInfo name='RFC' value='8174'/>
<seriesInfo name='DOI' value='10.17487/RFC8174'/>
</reference>



<reference anchor='RFC7950' target='https://www.rfc-editor.org/info/rfc7950'>
<front>
<title>The YANG 1.1 Data Modeling Language</title>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<date month='August' year='2016'/>
<abstract><t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols.  This document describes the syntax and semantics of version 1.1 of the YANG language.  YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification.  There are a small number of backward incompatibilities from YANG version 1.  This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t></abstract>
</front>
<seriesInfo name='RFC' value='7950'/>
<seriesInfo name='DOI' value='10.17487/RFC7950'/>
</reference>



<reference anchor='RFC6991' target='https://www.rfc-editor.org/info/rfc6991'>
<front>
<title>Common YANG Data Types</title>
<author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'><organization/></author>
<date month='July' year='2013'/>
<abstract><t>This document introduces a collection of common data types to be used with the YANG data modeling language.  This document obsoletes RFC 6021.</t></abstract>
</front>
<seriesInfo name='RFC' value='6991'/>
<seriesInfo name='DOI' value='10.17487/RFC6991'/>
</reference>



<reference anchor='RFC8345' target='https://www.rfc-editor.org/info/rfc8345'>
<front>
<title>A YANG Data Model for Network Topologies</title>
<author fullname='A. Clemm' initials='A.' surname='Clemm'><organization/></author>
<author fullname='J. Medved' initials='J.' surname='Medved'><organization/></author>
<author fullname='R. Varga' initials='R.' surname='Varga'><organization/></author>
<author fullname='N. Bahadur' initials='N.' surname='Bahadur'><organization/></author>
<author fullname='H. Ananthakrishnan' initials='H.' surname='Ananthakrishnan'><organization/></author>
<author fullname='X. Liu' initials='X.' surname='Liu'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>This document defines an abstract (generic, or base) YANG data model for network/service topologies and inventories.  The data model serves as a base model that is augmented with technology-specific details in other, more specific topology and inventory data models.</t></abstract>
</front>
<seriesInfo name='RFC' value='8345'/>
<seriesInfo name='DOI' value='10.17487/RFC8345'/>
</reference>



<reference anchor='RFC8795' target='https://www.rfc-editor.org/info/rfc8795'>
<front>
<title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
<author fullname='X. Liu' initials='X.' surname='Liu'><organization/></author>
<author fullname='I. Bryskin' initials='I.' surname='Bryskin'><organization/></author>
<author fullname='V. Beeram' initials='V.' surname='Beeram'><organization/></author>
<author fullname='T. Saad' initials='T.' surname='Saad'><organization/></author>
<author fullname='H. Shah' initials='H.' surname='Shah'><organization/></author>
<author fullname='O. Gonzalez de Dios' initials='O.' surname='Gonzalez de Dios'><organization/></author>
<date month='August' year='2020'/>
<abstract><t>This document defines a YANG data model for representing, retrieving, and manipulating Traffic Engineering (TE) Topologies. The model serves as a base model that other technology-specific TE topology models can augment.</t></abstract>
</front>
<seriesInfo name='RFC' value='8795'/>
<seriesInfo name='DOI' value='10.17487/RFC8795'/>
</reference>



<reference anchor='RFC8776' target='https://www.rfc-editor.org/info/rfc8776'>
<front>
<title>Common YANG Data Types for Traffic Engineering</title>
<author fullname='T. Saad' initials='T.' surname='Saad'><organization/></author>
<author fullname='R. Gandhi' initials='R.' surname='Gandhi'><organization/></author>
<author fullname='X. Liu' initials='X.' surname='Liu'><organization/></author>
<author fullname='V. Beeram' initials='V.' surname='Beeram'><organization/></author>
<author fullname='I. Bryskin' initials='I.' surname='Bryskin'><organization/></author>
<date month='June' year='2020'/>
<abstract><t>This document defines a collection of common data types and groupings in YANG data modeling language. These derived common types and groupings are intended to be imported by modules that model Traffic Engineering (TE) configuration and state capabilities.</t></abstract>
</front>
<seriesInfo name='RFC' value='8776'/>
<seriesInfo name='DOI' value='10.17487/RFC8776'/>
</reference>


<reference anchor='I-D.ietf-ccamp-otn-topo-yang'>
   <front>
      <title>A YANG Data Model for Optical Transport Network Topology</title>
      <author fullname='Haomian Zheng'>
	 <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Italo Busi'>
	 <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Xufeng Liu'>
	 <organization>Volta Networks</organization>
      </author>
      <author fullname='Sergio Belotti'>
	 <organization>Nokia</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios'>
	 <organization>Telefonica</organization>
      </author>
      <date day='7' month='March' year='2022'/>
      <abstract>
	 <t>   This document describes a YANG data model to describe the topologies
   of an Optical Transport Network (OTN).  It is independent of control
   plane protocols and captures topological and resource related
   information pertaining to OTN.  This model enables clients, which
   interact with a transport domain controller, for OTN topology related
   operations such as obtaining the relevant topology resource
   information.


	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-ccamp-otn-topo-yang-14'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-ccamp-otn-topo-yang-14.txt' type='TXT'/>
</reference>


<reference anchor='I-D.ietf-ccamp-layer1-types'>
   <front>
      <title>A YANG Data Model for Layer 1 Types</title>
      <author fullname='Haomian Zheng'>
	 <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Italo Busi'>
	 <organization>Huawei Technologies</organization>
      </author>
      <date day='8' month='April' year='2022'/>
      <abstract>
	 <t>   This document defines a collection of common data types and groupings
   in the YANG data modeling language for use with layer 1 networks.
   These derived common types and groupings are intended to be imported
   by modules that specify OTN networks, such as topology, tunnel,
   client signal adaptation and service.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-ccamp-layer1-types-13'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-ccamp-layer1-types-13.txt' type='TXT'/>
</reference>


<reference anchor='I-D.ietf-teas-ietf-network-slices'>
   <front>
      <title>Framework for IETF Network Slices</title>
      <author fullname='Adrian Farrel'>
	 <organization>Old Dog Consulting</organization>
      </author>
      <author fullname='John Drake'>
	 <organization>Juniper Networks</organization>
      </author>
      <author fullname='Reza Rokui'>
	 <organization>Ciena</organization>
      </author>
      <author fullname='Shunsuke Homma'>
	 <organization>NTT</organization>
      </author>
      <author fullname='Kiran Makhijani'>
	 <organization>Futurewei</organization>
      </author>
      <author fullname='Luis M. Contreras'>
	 <organization>Telefonica</organization>
      </author>
      <author fullname='Jeff Tantsura'>
	 <organization>Microsoft Inc.</organization>
      </author>
      <date day='30' month='June' year='2022'/>
      <abstract>
	 <t>   This document describes network slicing in the context of networks
   built from IETF technologies.  It defines the term &quot;IETF Network
   Slice&quot; and establishes the general principles of network slicing in
   the IETF context.

   The document discusses the general framework for requesting and
   operating IETF Network Slices, the characteristics of an IETF Network
   Slice, the necessary system components and interfaces, and how
   abstract requests can be mapped to more specific technologies.  The
   document also discusses related considerations with monitoring and
   security.

   This document also provides definitions of related terms to enable
   consistent usage in other IETF documents that describe or use aspects
   of IETF Network Slices.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-ietf-network-slices-12'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-ietf-network-slices-12.txt' type='TXT'/>
</reference>



<reference anchor='RFC8453' target='https://www.rfc-editor.org/info/rfc8453'>
<front>
<title>Framework for Abstraction and Control of TE Networks (ACTN)</title>
<author fullname='D. Ceccarelli' initials='D.' role='editor' surname='Ceccarelli'><organization/></author>
<author fullname='Y. Lee' initials='Y.' role='editor' surname='Lee'><organization/></author>
<date month='August' year='2018'/>
<abstract><t>Traffic Engineered (TE) networks have a variety of mechanisms to facilitate the separation of the data plane and control plane.  They also have a range of management and provisioning protocols to configure and activate network resources.  These mechanisms represent key technologies for enabling flexible and dynamic networking.  The term &quot;Traffic Engineered network&quot; refers to a network that uses any connection-oriented technology under the control of a distributed or centralized control plane to support dynamic provisioning of end-to- end connectivity.</t><t>Abstraction of network resources is a technique that can be applied to a single network domain or across multiple domains to create a single virtualized network that is under the control of a network operator or the customer of the operator that actually owns the network resources.</t><t>This document provides a framework for Abstraction and Control of TE Networks (ACTN) to support virtual network services and connectivity services.</t></abstract>
</front>
<seriesInfo name='RFC' value='8453'/>
<seriesInfo name='DOI' value='10.17487/RFC8453'/>
</reference>


<reference anchor='I-D.draft-contreras-teas-slice-controller-models'>
   <front>
      <title>IETF Network Slice Controller and its associated data models</title>
      <author fullname='Luis M. Contreras'>
	 <organization>Telefonica</organization>
      </author>
      <author fullname='Reza Rokui'>
	 <organization>Ciena</organization>
      </author>
      <author fullname='Jeff Tantsura'>
	 <organization>Microsoft</organization>
      </author>
      <author fullname='Bo Wu'>
	 <organization>Huawei</organization>
      </author>
      <author fullname='Xufeng Liu'>
	 <organization>IBM Corporation</organization>
      </author>
      <author fullname='Dhruv Dhody'>
	 <organization>Huawei</organization>
      </author>
      <author fullname='Sergio Belloti'>
	 <organization>Nokia</organization>
      </author>
      <date day='6' month='March' year='2022'/>
      <abstract>
	 <t>   This document describes the major functional components of an IETF
   Network Slice Controller (NSC) as well as references the data models
   required for supporting the requests of IETF network slices and their
   realization.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-contreras-teas-slice-controller-models-02'/>
   <format target='https://www.ietf.org/archive/id/draft-contreras-teas-slice-controller-models-02.txt' type='TXT'/>
</reference>


<reference anchor='I-D.ietf-teas-yang-te'>
   <front>
      <title>A YANG Data Model for Traffic Engineering Tunnels, Label Switched Paths and Interfaces</title>
      <author fullname='Tarek Saad'>
	 <organization>Juniper Networks</organization>
      </author>
      <author fullname='Rakesh Gandhi'>
	 <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Xufeng Liu'>
	 <organization>Volta Networks</organization>
      </author>
      <author fullname='Vishnu Pavan Beeram'>
	 <organization>Juniper Networks</organization>
      </author>
      <author fullname='Igor Bryskin'>
	 <organization>Individual</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios'>
	 <organization>Telefonica</organization>
      </author>
      <date day='7' month='February' year='2022'/>
      <abstract>
	 <t>   This document defines a YANG data model for the provisioning and
   management of Traffic Engineering (TE) tunnels, Label Switched Paths
   (LSPs), and interfaces.  The model is divided into YANG modules that
   classify data into generic, device-specific, technology agnostic, and
   technology-specific elements.

   This model covers data for configuration, operational state, remote
   procedural calls, and event notifications.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-te-29'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-yang-te-29.txt' type='TXT'/>
</reference>



<reference anchor='RFC4847' target='https://www.rfc-editor.org/info/rfc4847'>
<front>
<title>Framework and Requirements for Layer 1 Virtual Private Networks</title>
<author fullname='T. Takeda' initials='T.' role='editor' surname='Takeda'><organization/></author>
<date month='April' year='2007'/>
<abstract><t>This document provides a framework and service level requirements for Layer 1 Virtual Private Networks (L1VPNs).  This framework is intended to aid in developing and standardizing protocols and mechanisms to support interoperable L1VPNs.</t><t>The document examines motivations for L1VPNs, high level (service level) requirements, and outlines some of the architectural models that might be used to build L1VPNs.  This memo provides information for the Internet community.</t></abstract>
</front>
<seriesInfo name='RFC' value='4847'/>
<seriesInfo name='DOI' value='10.17487/RFC4847'/>
</reference>



<reference anchor='RFC6241' target='https://www.rfc-editor.org/info/rfc6241'>
<front>
<title>Network Configuration Protocol (NETCONF)</title>
<author fullname='R. Enns' initials='R.' role='editor' surname='Enns'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'><organization/></author>
<author fullname='A. Bierman' initials='A.' role='editor' surname='Bierman'><organization/></author>
<date month='June' year='2011'/>
<abstract><t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices.  It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages.  The NETCONF protocol operations are realized as remote procedure calls (RPCs).  This document obsoletes RFC 4741.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6241'/>
<seriesInfo name='DOI' value='10.17487/RFC6241'/>
</reference>



<reference anchor='RFC8040' target='https://www.rfc-editor.org/info/rfc8040'>
<front>
<title>RESTCONF Protocol</title>
<author fullname='A. Bierman' initials='A.' surname='Bierman'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<author fullname='K. Watsen' initials='K.' surname='Watsen'><organization/></author>
<date month='January' year='2017'/>
<abstract><t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t></abstract>
</front>
<seriesInfo name='RFC' value='8040'/>
<seriesInfo name='DOI' value='10.17487/RFC8040'/>
</reference>



<reference anchor='RFC6242' target='https://www.rfc-editor.org/info/rfc6242'>
<front>
<title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
<author fullname='M. Wasserman' initials='M.' surname='Wasserman'><organization/></author>
<date month='June' year='2011'/>
<abstract><t>This document describes a method for invoking and running the Network Configuration Protocol (NETCONF) within a Secure Shell (SSH) session as an SSH subsystem.  This document obsoletes RFC 4742.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6242'/>
<seriesInfo name='DOI' value='10.17487/RFC6242'/>
</reference>



<reference anchor='RFC8446' target='https://www.rfc-editor.org/info/rfc8446'>
<front>
<title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
<author fullname='E. Rescorla' initials='E.' surname='Rescorla'><organization/></author>
<date month='August' year='2018'/>
<abstract><t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol.  TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t><t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961.  This document also specifies new requirements for TLS 1.2 implementations.</t></abstract>
</front>
<seriesInfo name='RFC' value='8446'/>
<seriesInfo name='DOI' value='10.17487/RFC8446'/>
</reference>



<reference anchor='RFC8341' target='https://www.rfc-editor.org/info/rfc8341'>
<front>
<title>Network Configuration Access Control Model</title>
<author fullname='A. Bierman' initials='A.' surname='Bierman'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability.  There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content.  This document defines such an access control model.</t><t>This document obsoletes RFC 6536.</t></abstract>
</front>
<seriesInfo name='STD' value='91'/>
<seriesInfo name='RFC' value='8341'/>
<seriesInfo name='DOI' value='10.17487/RFC8341'/>
</reference>



<reference anchor='RFC3688' target='https://www.rfc-editor.org/info/rfc3688'>
<front>
<title>The IETF XML Registry</title>
<author fullname='M. Mealling' initials='M.' surname='Mealling'><organization/></author>
<date month='January' year='2004'/>
<abstract><t>This document describes an IANA maintained registry for IETF standards which use Extensible Markup Language (XML) related items such as Namespaces, Document Type Declarations (DTDs), Schemas, and Resource Description Framework (RDF) Schemas.</t></abstract>
</front>
<seriesInfo name='BCP' value='81'/>
<seriesInfo name='RFC' value='3688'/>
<seriesInfo name='DOI' value='10.17487/RFC3688'/>
</reference>



<reference anchor='RFC6020' target='https://www.rfc-editor.org/info/rfc6020'>
<front>
<title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<date month='October' year='2010'/>
<abstract><t>YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6020'/>
<seriesInfo name='DOI' value='10.17487/RFC6020'/>
</reference>




    </references>



<section numbered="false" anchor="acknowledgments" title="Acknowledgments">

<t>This document was prepared using kramdown.</t>

<t>Previous versions of this document were prepared using 2-Word-v2.0.template.dot.</t>

<t>The authors would like to thank Adrian Farrel, Danielle Ceccarelli,
   Igor Bryskin, Bo Wu, Gyan Mishra, Joel M. Halpen, Dhruv Dhoddy and Loa Andersson
   for providing valuable insights.</t>

</section>

    <section anchor="contributors" numbered="false" title="Contributors">
    </section>

  </back>

<!-- ##markdown-source:
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

-->

</rfc>

