<?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-01" 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="March" day="05"/>

    
    <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"><name>Introduction</name>

<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"><name>Terminology</name>

<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"><name>Prefixes in Data Node Names</name>

<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>
</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"><name>Definition of OTN Slice</name>
<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"><name>Use Cases for OTN Network Slicing</name>

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

<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"><name>Co-construction and Sharing</name>

<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"><name>Wholesale of optical resources</name>

<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"><name>Vertical dedicated network with OTN</name>

<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"><name>End-to-end network slicing</name>

<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"><name>Framework for OTN slicing</name>

<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 connectivities 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, whose 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-blockable 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 with 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="yang-data-model-for-otn-slicing-configuration"><name>YANG Data Model for OTN Slicing Configuration</name>

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

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

<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"><name>MPI YANG Model Tree</name>

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

  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"><name>MPI YANG Code</name>

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

     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: Victor Lopez
                <mailto:victor.lopez@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 Simplified BSD
        License set forth in Section 4.c of the IETF Trust's Legal
        Provisions Relating to IETF Documents
        (https://trustee.ietf.org/license-info).
        This version of this YANG module is part of RFC XXXX; see
        the RFC itself for full legal notices.";

     revision "2022-03-04" {
       description
         "Latest revision of MPI YANG model for OTN slicing.";
       reference
         "draft-ietf-ccamp-yang-otn-slicing-01: 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"><name>OTN Slicing YANG Model for OTN-SC NBI</name>

<section anchor="nbi-yang-model-overview"><name>NBI YANG Model Overview</name>
<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 connecvitiy 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 connctivity 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"><name>NBI YANG Model Tree for Transport Network Slice</name>

<figure title="Tree diagram for transport network slice" anchor="fig-ietf-transport-network-slice"><artwork><![CDATA[
module: ietf-transport-network-slice
  +--rw network-slices
     +--rw network-slice* [ns-id]
        +--rw ns-id                    string
        +--rw ns-name?                 string
        +--rw ns-description?          string
        +--rw customer-name*           string
        +--rw slo
        |  +--rw optimization-criterion?   identityref
        |  +--rw delay-tolerance?          boolean
        |  +--rw periodicity*              uint64
        |  +--rw isolation-level?          identityref
        +--rw endpoints
        |  +--rw endpoint* [endpoint-id]
        |     +--rw endpoint-id    string
        +--rw network-topologies
        |  +--rw network-topology* [topology-id]
        |     +--rw topology-id    string
        |     +--rw node* [node-id]
        |     |  +--rw node-id              inet:uri
        |     |  +--rw slo
        |     |  |  +--rw isolation-level?   identityref
        |     |  +--rw termination-point* [tp-id]
        |     |     +--rw tp-id          inet:uri
        |     |     +--rw endpoint-id?   leafref
        |     +--rw link* [link-id]
        |        +--rw link-id        inet:uri
        |        +--rw slo
        |        |  +--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
        +--rw connectivity-matrices
           +--rw connectivity-matrix* [connectivity-matrix-id]
              +--rw connectivity-matrix-id    uint32
              +--rw topology-id?              leafref
              +--rw src-endpoint?
              |       -> ../../../endpoints/endpoint/endpoint-id
              +--rw dst-endpoint?
              |       -> ../../../endpoints/endpoint/endpoint-id
              +--rw slo
              +--rw explicit-path* [tp-id]
                 +--rw tp-id    leafref
]]></artwork></figure>

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

<figure title="YANG model for transport network slice" anchor="fig-ietf-transport-network-yang"><artwork><![CDATA[
   <CODE BEGINS> file "ietf-transport-network-slice@2022-03-04.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";
     }

     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: Victor Lopez
                <mailto:victor.lopez@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 Simplified BSD
        License set forth in Section 4.c of the IETF Trust's Legal
        Provisions Relating to IETF Documents
        (https://trustee.ietf.org/license-info).
        This version of this YANG module is part of RFC XXXX; see
        the RFC itself for full legal notices.";

     revision "2022-03-04" {
       description
         "Latest revision of NBI YANG model for OTN slicing.";
       reference
         "draft-ietf-ccamp-yang-otn-slicing-01: 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 ns-generic-info {
       description
         "Generic configuration of a network slice";
         leaf ns-name {
           type string;
           description
             "Name of the specific network slice";
         }
         leaf ns-description {
           type string;
           description
             "Description regarding the specific network slice";
         }
         leaf-list customer-name {
           type string;
           description
             "List of customers using the slice";
         }
     }

     grouping ns-slo {
       description
         "SLO configuration of a network slice";

       container slo {
         description
           "SLO configuration of a network slice";
   
       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 node-slo {
       description
         "Node SLO";
       container slo {
         description
           "SLO configuration of a node";
         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 link-slo {
       description
         "Link SLO";
       container slo {
         description
           "SLO configuration of a link";
         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 connectivity-matrix-slo {
       description
         "SLO configuration of a path within a network slice";

       container slo {
         description
           "Path SLO configuration";
       }
       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 connectivity-matrix-entry-slo {
       description
         "SLO configuration of a connectivity matrix entry within a
          network slice";

       container slo {
         description
           "SLO configuration of a connectivity matrix entry";
       }
     }

     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 "/network-slices/network-slice[ns-id=current()"+
                  "/../../../../ns-id]/network-topologies"+
                  "/network-topology[topology-id=current()"+
                  "/../../topology-id]/node/termination-point"+
                  "/tp-id";
           }
           description
             "Relative reference to TP id.";
         }
       }
     }

     grouping network-topology-def {
       description
         "Network topology definition";
       list node {
         key "node-id";
         description
         "The inventory of nodes of this topology.";
         leaf node-id {
           type inet:uri;
           description
             "Node identifier.";
         }
         uses node-slo;
         list termination-point {
           key "tp-id";
           description
             "TP identifier";
           leaf tp-id {
             type inet:uri;
             description
               "Termination point identifier.";
           }
           leaf endpoint-id {
             type leafref {
               path "/network-slices/network-slice[ns-id=current()"+
                    "/../../../../../ns-id]/endpoints/endpoint/"+
                    "endpoint-id";
             }
             description
               "Relative reference to TP id.";
           }
         }
       }
       list link {
         key "link-id";
         description
           "Link identifier.";
         leaf link-id {
           type inet:uri;
           description
             "Link identifier.";
         }
         uses link-slo;
         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.";
           }
         }
       }
     }

     /*
      * Configuration data nodes
      */
     container network-slices {
       description
         "Generic network slice configurations";
       list network-slice {
         key "ns-id";
         description
           "Network slice identifier";
         leaf ns-id {
           type string;
           description
             "A unique network slice identifier across a slice
              controller";
         }
         uses ns-generic-info;
         uses ns-slo;

         container endpoints {
           description
             "Endpoints of a network slice";
 
           list endpoint {
             key "endpoint-id";
             description
               "List of endpoints";
             leaf endpoint-id {
               type string;
               description
                 "Endpoint identifier";
             }
           }
         }
         container network-topologies {
           description
             "A network slice is described as a network topology";
 
           list network-topology {
             key "topology-id";
             description
               "List of network topologies";
             leaf topology-id {
               type string;
               description
                 "Topology identifier";
             }
             uses network-topology-def;
           }
         } 
         container connectivity-matrices {
           description
             "Connectivity matrices";
 
           list connectivity-matrix {
             key "connectivity-matrix-id";
             description
               "List of connectivity matrix entities";
             leaf connectivity-matrix-id {
               type uint32;
               description
                 "Connectivity matrix identifier";
             }
             leaf topology-id {
               type leafref {
                 path "../../../network-topologies/network-topology"+
                      "/topology-id";
               }
               description
                 "Relative reference to network topology id.";
             }
             leaf src-endpoint {
               type leafref {
                 path "../../../endpoints/endpoint/endpoint-id";
               }
               description
                 "Relative reference to endpoint id.";
             }
             leaf dst-endpoint {
               type leafref {
                 path "../../../endpoints/endpoint/endpoint-id";
               }
               description
                 "Relative reference to endpoint id.";
             }
             uses connectivity-matrix-entry-slo;
             uses explicit-path;
           } //connectivity-matrix
         } //connectivity-matrices
       } //network-slice
     } //network slices
   }
   <CODE ENDS>
]]></artwork></figure>

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

<t>TBD.</t>

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

<t>TBD.</t>

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

<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"><name>Security Considerations</name>

<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"><name>IANA Considerations</name>

<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: otnslice
   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='12' month='July' year='2021'/>
      <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-13'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-ccamp-otn-topo-yang-13.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='7' month='September' year='2021'/>
      <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-11'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-ccamp-layer1-types-11.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='Eric Gray'>
	 <organization>Independent</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='3' month='March' 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-06'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-ietf-network-slices-06.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>Nokia</organization>
      </author>
      <author fullname='Jeff Tantsura'>
	 <organization>Apstra</organization>
      </author>
      <author fullname='Bo Wu'>
	 <organization>Huawei</organization>
      </author>
      <author fullname='Xufeng Liu'>
	 <organization>Volta</organization>
      </author>
      <author fullname='Dhruv Dhody'>
	 <organization>Huawei</organization>
      </author>
      <author fullname='Sergio Belloti'>
	 <organization>Nokia</organization>
      </author>
      <date day='22' month='February' year='2021'/>
      <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-01'/>
   <format target='https://www.ietf.org/archive/id/draft-contreras-teas-slice-controller-models-01.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"><name>Acknowledgments</name>

<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" toc="include" removeInRFC="false">
        <name>Contributors</name>
    <contact initials="H." surname="Zheng" fullname="Haomian Zheng">
      <organization>Huawei Technologies</organization>
      <address>
        <postal>
          <street>H1, Xiliu Beipo Village, Songshan Lake</street>
          <city>Dongguan</city>
          <country>China</country>
        </postal>
        <email>zhenghaomian@huawei.com</email>
      </address>
    </contact>
    <contact initials="I." surname="Busi" fullname="Italo Busi">
      <organization>Huawei Technologies</organization>
      <address>
        <email>italo.busi@huawei.com</email>
      </address>
    </contact>
    <contact initials="O." surname="Gonzalez de Dios" fullname="Oscar Gonzalez de Dios">
      <organization>Telefonica</organization>
      <address>
        <email>oscar.gonzalezdedios@telefonica.com</email>
      </address>
    </contact>
    <contact initials="V." surname="Lopez" fullname="Victor Lopez">
      <organization>Nokia</organization>
      <address>
        <email>victor.lopez@nokia.com</email>
      </address>
    </contact>
    <contact initials="D." surname="Beller" fullname="Dieter Beller">
      <organization>Nokia</organization>
      <address>
        <email>Dieter.Beller@nokia.com</email>
      </address>
    </contact>
    <contact initials="H." surname="Yu" fullname="Henry Yu">
      <organization>Huawei Technologies Canada</organization>
      <address>
        <email>henry.yu@huawei.com</email>
      </address>
    </contact>
    <contact initials="J." surname="Sun" fullname="Jiang Sun">
      <organization>China Mobile</organization>
      <address>
        <email>sunjiang@chinamobile.com</email>
      </address>
    </contact>
    </section>

  </back>

<!-- ##markdown-source:
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
pbWI55LScIw2/heuWmslmM8AAA==

-->

</rfc>

