<?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-04" 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="2023" month="March" day="13"/>

    
    <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 defines
   YANG data models with OTN technology-specific augments deployed at both
   the north and south bound of the OTN network slice controller. 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 defines
   YANG data models with OTN technology-specific augments deployed at both
   the north and south bound of the OTN network slice controller. 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>
      <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"><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 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"><name>Realizing OTN Slices</name>

<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. 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"/>. The resources of an NRP topology are reserved and shared by all the OTN slices mapped to this NRP, and the NRP topology may be pushed directly to the subtended MDSC or PNC, thus eliminating the need for link coloring if using the underlay topology.</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   --  /
 /------------<--/   /         |     /-----------<---/
    / Slice 3 <     /          |                 <
   /--------- <-<--/           |                 <
+-------------<-<--------------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"><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 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"><name>MPI YANG Code</name>

<figure title="OTN slicing MPI YANG model" anchor="fig-otn-slice-mpi-yang"><artwork><![CDATA[
   <CODE BEGINS> file "ietf-otn-slice-mpi@2022-10-12.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-10-12" {
       description
         "Latest revision of MPI YANG model for OTN slicing.";
       reference
         "draft-ietf-ccamp-yang-otn-slicing-03: 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), which augments the network
   slice topology model defined in <xref target="I-D.draft-liu-teas-transport-network-slice-yang"/>
   by adding the following constructs and attributes applicable to trasnport network slicing:</t>

<t><list style="symbols">
  <t>Explicit path, which defines a customized service path for routing connections
over a customized topology on which the slice is built.</t>
  <t>Service-level objectives (SLOs) and service-level expectation (SLEs) associated 
    with connections within the slice.</t>
</list></t>

<t>The OTN slicing model further augments the common TNS model with OTN technology-specific
   SLO/SLE attributes upon requesting slice services by an OTN-aware customer. These attributes
   allows the customer to specify desired signal quality and bandwidth in terms of OTN signal
   structure. These attributes include:</t>

<t><list style="symbols">
  <t>The performance objective for Optical Data Unit (ODU) containers as defined in
ITU-T-G.8201-Amd.1.</t>
  <t>Bandwidth specification in the type and number of ODU containers.</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

  augment /ietf-nss:network-slice-services/ietf-nss:slo-sle-templates
            /ietf-nss:slo-sle-template
            /ietf-nss:service-slo-sle-policy:
    +--rw optimization-criterion?   identityref
    +--rw resize-requirement?       identityref
    +--rw service-info?             string
  augment /ietf-nss:network-slice-services/ietf-nss:slo-sle-templates
            /ietf-nss:slo-sle-template
            /ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints:
    +--rw disjointness?   te-types:te-path-disjointness
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:slo-sle-policy/ietf-nss:custom
            /ietf-nss:service-slo-sle-policy:
    +--rw optimization-criterion?   identityref
    +--rw resize-requirement?       identityref
    +--rw service-info?             string
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:slo-sle-policy/ietf-nss:custom
            /ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints:
    +--rw disjointness?   te-types:te-path-disjointness
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:slo-sle-policy/ietf-nss:custom
            /ietf-nss:service-slo-sle-policy:
    +--rw optimization-criterion?   identityref
    +--rw resize-requirement?       identityref
    +--rw service-info?             string
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:slo-sle-policy/ietf-nss:custom
            /ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints:
    +--rw disjointness?   te-types:te-path-disjointness
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:slo-sle-policy/ietf-nss:custom
            /ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints/ietf-nss:path-constraints:
    +--rw topology-id?     -> /nw:networks/network/network-id
    +--rw explicit-path* [tp-id]
       +--rw tp-id
               -> /nw:networks/network/node/nt:termination-point/tp-id
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy:
    +--rw optimization-criterion?   identityref
    +--rw resize-requirement?       identityref
    +--rw service-info?             string
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints:
    +--rw disjointness?   te-types:te-path-disjointness
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints/ietf-nss:path-constraints:
    +--rw topology-id?     -> /nw:networks/network/network-id
    +--rw explicit-path* [tp-id]
       +--rw tp-id
               -> /nw:networks/network/node/nt:termination-point/tp-id
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:type
            /ietf-nss:a2a/ietf-nss:a2a-sdp/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy:
    +--rw optimization-criterion?   identityref
    +--rw resize-requirement?       identityref
    +--rw service-info?             string
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:type
            /ietf-nss:a2a/ietf-nss:a2a-sdp/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints:
    +--rw disjointness?   te-types:te-path-disjointness
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:type
            /ietf-nss:a2a/ietf-nss:a2a-sdp/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy
            /ietf-nss:steering-constraints/ietf-nss:path-constraints:
    +--rw topology-id?     -> /nw:networks/network/network-id
    +--rw explicit-path* [tp-id]
       +--rw tp-id
               -> /nw:networks/network/node/nt:termination-point/tp-id
]]></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-10-12.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-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-network-slice-service {
       prefix "ietf-nss";
       reference
         "draft-ietf-teas-ietf-network-slice-nbi-yang-01:
          IETF Network Slice Service YANG Model";
     }

     import ietf-ns-topo {
       prefix "ns-topo";
       reference
         "draft-liu-teas-transport-network-slice-yang-06:
          IETF Network Slice 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 "2023-02-08" {
       description
         "Latest revision of NBI YANG model for OTN slicing.";
       reference
         "draft-ietf-ccamp-yang-otn-slicing-03: Framework and Data
          Model for OTN Network Slicing";
     }

     /*
      * Groupings
      */
     grouping topology-ref {
       description
         "Grouping for network topology reference.";
       leaf topology-id {
         type leafref {
           path "/nw:networks/nw:network/nw:network-id";
         }
         description
           "Relative reference to network slice 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 "/nw:networks/nw:network/nw:node"+
                  "/nt:termination-point/nt:tp-id";
           }
           description
             "Relative reference to TP id.";
         }
       }
     }

     /*
      * Augmented data nodes
      */    
     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slo-sle-templates" +
             "/ietf-nss:slo-sle-template" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
          "Augment IETF network slice service templates with
                   technology-specific SLO/SLE policy attributes.";
  
       uses ns-topo:ns-topo-slo-sle-policy;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slo-sle-templates" +
             "/ietf-nss:slo-sle-template" + 
             "/ietf-nss:service-slo-sle-policy" +
             "/ietf-nss:steering-constraints" {
       description
          "Augment IETF network slice service templates with
                   technology-specific steering constraints.";
  
       uses ns-topo:ns-topo-steering-constraints;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
          "Augment IETF network slice services to include technology-
           specific SLO/SLE policy for connectivity-based transport 
          network slices.";
  
       uses ns-topo:ns-topo-slo-sle-policy;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" + 
             "/ietf-nss:steering-constraints" {
       description
         "Augment IETF network slice services to include steering
         constraints for connectivity-based transport network
         slices.";
          
       uses ns-topo:ns-topo-steering-constraints;
     }

     /* connectivity construct augments */
     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
         "Augment IETF network slice services to include technology-
          specific SLO/SLE policy for connectivity-constructs within
          a connectivity-based transport network slice.";
       uses ns-topo:ns-topo-slo-sle-policy;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" + 
             "/ietf-nss:steering-constraints" {
       description
         "Augment IETF network slice services to include steering
         constraints for connectivity-constructs within a
         connectivity-based transport network slice.";
       uses ns-topo:ns-topo-steering-constraints;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" + 
             "/ietf-nss:steering-constraints" +
             "/ietf-nss:path-constraints" {
       description
         "Add toplogy id and explicit path to the connection group";

       uses topology-ref;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
         "Augment IETF network slice services to include technology-
          specific SLO/SLE policy for connectivity-constructs within
          a connectivity-based transport network slice.";
       uses ns-topo:ns-topo-slo-sle-policy;
     }
     
     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" + 
             "/ietf-nss:steering-constraints" {
       description
         "Augment IETF network slice services to include steering
         constraints for connectivity-constructs within a
         connectivity-based transport network slice.";
       uses ns-topo:ns-topo-steering-constraints;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" + 
             "/ietf-nss:steering-constraints" +
             "/ietf-nss:path-constraints" {
       description
         "Add toplogy id and explicit path to the connectivity
                  construct";

       uses topology-ref;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:type" +
             "/ietf-nss:a2a" +
             "/ietf-nss:a2a-sdp" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
         "Augment IETF network slice services to include technology-
          specific SLO/SLE policy for a2a connectivity-constructs
          within a connectivity-based transport network slice.";
       uses ns-topo:ns-topo-slo-sle-policy;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:type" +
             "/ietf-nss:a2a" +
             "/ietf-nss:a2a-sdp" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" + 
             "/ietf-nss:steering-constraints" {
       description
         "Augment IETF network slice services to include steering
         constraints for a2a connectivity-constructs within a
         connectivity-based transport network slice.";
       uses ns-topo:ns-topo-steering-constraints;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:type" +
             "/ietf-nss:a2a" +
             "/ietf-nss:a2a-sdp" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" + 
             "/ietf-nss:steering-constraints" +
             "/ietf-nss:path-constraints" {
       description
         "Add toplogy id and explicit path to a2a connectivity
                  construct";

       uses topology-ref;
     }
   }
   <CODE ENDS>
]]></artwork></figure>

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

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

  augment /ietf-nss:network-slice-services/ietf-nss:slo-sle-templates
            /ietf-nss:slo-sle-template
            /ietf-nss:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:slo-sle-policy/ietf-nss:custom
            /ietf-nss:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /nw:networks/nw:network/ns-topo:slo-sle-policy
            /ns-topo:custom/ns-topo:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /nw:networks/nw:network/nw:node/ns-topo:slo-sle-policy
            /ns-topo:custom/ns-topo:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /nw:networks/nw:network/nw:node/nt:termination-point
            /ns-topo:slo-sle-policy/ns-topo:custom
            /ns-topo:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /nw:networks/nw:network/nt:link/ns-topo:slo-sle-policy
            /ns-topo:custom/ns-topo:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:slo-sle-policy/ietf-nss:custom
            /ietf-nss:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
  augment /ietf-nss:network-slice-services/ietf-nss:slice-service
            /ietf-nss:connection-groups/ietf-nss:connection-group
            /ietf-nss:connectivity-construct/ietf-nss:type
            /ietf-nss:a2a/ietf-nss:a2a-sdp/ietf-nss:slo-sle-policy
            /ietf-nss:custom/ietf-nss:service-slo-sle-policy:
    +--rw otn
       +--rw odu-signal-quality
       |  +--rw odu-pm-objective* [duration pm-type]
       |     +--rw duration        identityref
       |     +--rw pm-type         identityref
       |     +--rw pm-threshold?   union
       +--rw odulist* [odu-type]
          +--rw odu-type    identityref
          +--rw number?     uint16
]]></artwork></figure>

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

<figure title="YANG model for transport network slice" anchor="fig-ietf-otn-slice-yang"><artwork><![CDATA[
   <CODE BEGINS> file "ietf-otn-slice@2022-10-12.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-types {
       prefix "te-types";
       reference
         "RFC 8776: Traffic Engineering Common YANG Types";
     }

     import ietf-layer1-types {
       prefix "l1-types";
       reference
         "draft-ietf-ccamp-layer1-types-14: 
          A YANG Data Model for Layer 1 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";
     }

     import ietf-ns-topo {
       prefix "ns-topo";
       reference
         "draft-liu-teas-transport-network-slice-yang-06:
          IETF Network Slice 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 YANG data model for configuring 
        technology-specific 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-10-12" {
       description
         "Latest revision of NBI YANG model for OTN slicing.";
       reference
         "draft-ietf-ccamp-yang-otn-slicing-03: Framework and Data
          Model for OTN Network Slicing";
     }


     /*
      * Identities
      */
     identity bit-error-rate {
       base ietf-nss:service-slo-metric-type;
       description
         "ODU bit error rate";
     }

     identity odu-tca-threshold-type {
       description
         "Base identity for ODU performance counter";
     }
     
     identity odu-bbe {
       base odu-tca-threshold-type;
       description
         "ODU Background Block Error (BBE) threshold";
     }
     
     identity odu-es {
       base odu-tca-threshold-type;
       description
         "ODU Errored Seconds (ES) threshold";
     }
     
     identity odu-ses {
       base odu-tca-threshold-type;
       description
         "ODU Severely Errored Seconds (SES) threshold";
     }

     identity odu-uas {
       base odu-tca-threshold-type;
       description
         "ODU Unavailable Seconds (UAS) threshold";
     }

     identity odu-ber {
       base odu-tca-threshold-type;
       description
         "ODU Bit Error Rate (BER) threshold";
     }

     identity pm-duration {
       description
         "Base identity for ODU performance monitoring interval";
     }
     
     identity pm-15m {
       base pm-duration;
       description
         "15 minuites pm duration";
     }

     identity pm-24h {
       base pm-duration;
       description
         "24 hours pm duration";
     }

     /*
      * Groupings
      */
     grouping odu-signal-quality {
       description
         "Grouping for ODU signal quality.";
 
       container odu-signal-quality {
         description
           "Contianer for ODU signal quality attributes.";
   
         list odu-pm-objective {
           key "duration pm-type";
           description
             "List of ODU performance requirements.";
           leaf duration {
             type identityref {
               base pm-duration;
             }
             description
               "Time duration.";
           }
           leaf pm-type {
             type identityref {
               base odu-tca-threshold-type;
             }
             description
               "ODU PM metric type.";
           }
           
           leaf pm-threshold {
             type union {
               type te-types:bandwidth-scientific-notation;
               type uint64;
             }
             description
               "ODU PM metric threshold.";
           }
         }
       }
     }

     grouping otn-slice-slo-sle-policy {
       description
         "Policy grouping for OTN network slices.";

       container otn {
         description
           "OTN technology-specific SLO/SLE policy container";
   
         uses odu-signal-quality;
         uses l1-types:otn-link-bandwidth;
       }
     }

     /*
      * Augmented data nodes
      */
     /* slice template */
     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slo-sle-templates" +
             "/ietf-nss:slo-sle-template" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
          "Augment IETF network slice service templates with
                   OTN technology-specific SLO/SLE policy attributes.";
  
       uses otn-slice-slo-sle-policy;
     }

     /* slice augments */
     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
         "Augment IETF network slice services to include technology-
          specific SLO/SLE policy for connectivity-based OTN
          slices.";
          
       uses otn-slice-slo-sle-policy;
     }

     /* network topology augments */
     augment "/nw:networks/nw:network" +
             "/ns-topo:slo-sle-policy" +
             "/ns-topo:custom" +
             "/ns-topo:service-slo-sle-policy" {
       when "../nw:network-types/ns-topo:network-slice" {
         description "Augment only for Network Slice topology.";
       }
       description "Augment topology configuration and state.";
       uses otn-slice-slo-sle-policy;
     }

     /* network node augments */
     augment "/nw:networks/nw:network/nw:node" +
             "/ns-topo:slo-sle-policy" + 
             "/ns-topo:custom" + 
             "/ns-topo:service-slo-sle-policy" {
       when "../../nw:network-types/ns-topo:network-slice" {
         description "Augment only for Network Slice topology.";
       }
       description "Augment node configuration and state.";
       uses otn-slice-slo-sle-policy;
     }

     /* network node's termination point augments */
     augment "/nw:networks/nw:network/nw:node" +
             "/nt:termination-point" +
             "/ns-topo:slo-sle-policy" + 
             "/ns-topo:custom" + 
             "/ns-topo:service-slo-sle-policy" {
       when "../../../nw:network-types/ns-topo:network-slice" {
         description "Augment only for Network Slice topology.";
       }
       description "Augment node configuration and state.";
           
       uses otn-slice-slo-sle-policy;
     }

     /* network link augments */
     augment "/nw:networks/nw:network/nt:link" +
             "/ns-topo:slo-sle-policy" + 
             "/ns-topo:custom" + 
             "/ns-topo:service-slo-sle-policy" {
       when "../../nw:network-types/ns-topo:network-slice" {
         description "Augment only for Network Slice topology.";
       }
       description "Augment link configuration and state.";
       uses otn-slice-slo-sle-policy;
     }
     
     /* connectivity construct augments */
     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
         "Augment IETF network slice services to include technology-
          specific SLO/SLE policy for connection groups within
          a connectivity-based transport network slice.";
       uses otn-slice-slo-sle-policy;
     }

     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
         "Augment IETF network slice services to include technology-
          specific SLO/SLE policy for connectivity-constructs within
          a connectivity-based transport network slice.";
       uses otn-slice-slo-sle-policy;
     }
     
     augment "/ietf-nss:network-slice-services" +
             "/ietf-nss:slice-service" +
             "/ietf-nss:connection-groups" +
             "/ietf-nss:connection-group" +
             "/ietf-nss:connectivity-construct" +
             "/ietf-nss:type" +
             "/ietf-nss:a2a" +
             "/ietf-nss:a2a-sdp" +
             "/ietf-nss:slo-sle-policy" + 
             "/ietf-nss:custom" + 
             "/ietf-nss:service-slo-sle-policy" {
       description
         "Augment IETF network slice services to include technology-
          specific SLO/SLE policy for a2a connectivity-constructs
          within a connectivity-based transport network slice.";
       uses otn-slice-slo-sle-policy;
     }
   }

   <CODE ENDS>
]]></artwork></figure>

</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: 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="ITU-T-G.8201-Amd.1" target="https://www.itu.int/rec/T-REC-G.8201">
  <front>
    <title>Error performance parameters and objectives for multi-operator international paths within optical transport networks (Amendment 1)</title>
    <author >
      <organization>ITU Telecommunication Standardization Sector (ITU-T)</organization>
    </author>
    <date year="2021" month="December"/>
  </front>
  <seriesInfo name="ITU-T G.8201 (2011) Amd. 1" 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' target='https://datatracker.ietf.org/doc/html/draft-ietf-ccamp-otn-topo-yang-16'>
   <front>
      <title>A YANG Data Model for Optical Transport Network Topology</title>
      <author fullname='Haomian Zheng' initials='H.' surname='Zheng'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Italo Busi' initials='I.' surname='Busi'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Xufeng Liu' initials='X.' surname='Liu'>
         <organization>IBM Corporation</organization>
      </author>
      <author fullname='Sergio Belotti' initials='S.' surname='Belotti'>
         <organization>Nokia</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <date day='23' month='November' 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-16'/>
   
</reference>


<reference anchor='I-D.ietf-ccamp-layer1-types' target='https://datatracker.ietf.org/doc/html/draft-ietf-ccamp-layer1-types-15'>
   <front>
      <title>A YANG Data Model for Layer 1 Types</title>
      <author fullname='Haomian Zheng' initials='H.' surname='Zheng'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Italo Busi' initials='I.' surname='Busi'>
         <organization>Huawei Technologies</organization>
      </author>
      <date day='23' month='November' 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-15'/>
   
</reference>


<reference anchor='I-D.ietf-teas-ietf-network-slices' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-ietf-network-slices-19'>
   <front>
      <title>A Framework for IETF Network Slices</title>
      <author fullname='Adrian Farrel' initials='A.' surname='Farrel'>
         <organization>Old Dog Consulting</organization>
      </author>
      <author fullname='John Drake' initials='J.' surname='Drake'>
         <organization>Juniper Networks</organization>
      </author>
      <author fullname='Reza Rokui' initials='R.' surname='Rokui'>
         <organization>Ciena</organization>
      </author>
      <author fullname='Shunsuke Homma' initials='S.' surname='Homma'>
         <organization>NTT</organization>
      </author>
      <author fullname='Kiran Makhijani' initials='K.' surname='Makhijani'>
         <organization>Futurewei</organization>
      </author>
      <author fullname='Luis M. Contreras' initials='L. M.' surname='Contreras'>
         <organization>Telefonica</organization>
      </author>
      <author fullname='Jeff Tantsura' initials='J.' surname='Tantsura'>
         <organization>Microsoft Inc.</organization>
      </author>
      <date day='21' month='January' year='2023'/>
      <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-19'/>
   
</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' target='https://datatracker.ietf.org/doc/html/draft-contreras-teas-slice-controller-models-04'>
   <front>
      <title>IETF Network Slice Controller and its associated data models</title>
      <author fullname='Luis M. Contreras' initials='L. M.' surname='Contreras'>
         <organization>Telefonica</organization>
      </author>
      <author fullname='Reza Rokui' initials='R.' surname='Rokui'>
         <organization>Ciena</organization>
      </author>
      <author fullname='Jeff Tantsura' initials='J.' surname='Tantsura'>
         <organization>Microsoft</organization>
      </author>
      <author fullname='Bo Wu' initials='B.' surname='Wu'>
         <organization>Huawei</organization>
      </author>
      <author fullname='Xufeng Liu' initials='X.' surname='Liu'>
         <organization>IBM Corporation</organization>
      </author>
      <author fullname='Dhruv Dhody' initials='D.' surname='Dhody'>
         <organization>Huawei</organization>
      </author>
      <author fullname='Sergio Belotti' initials='S.' surname='Belotti'>
         <organization>Nokia</organization>
      </author>
      <date day='24' month='October' 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 slice services
   and their realization.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-contreras-teas-slice-controller-models-04'/>
   
</reference>


<reference anchor='I-D.ietf-teas-yang-te' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-yang-te-32'>
   <front>
      <title>A YANG Data Model for Traffic Engineering Tunnels, Label Switched Paths and Interfaces</title>
      <author fullname='Tarek Saad' initials='T.' surname='Saad'>
         <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Rakesh Gandhi' initials='R.' surname='Gandhi'>
         <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Xufeng Liu' initials='X.' surname='Liu'>
         <organization>IBM Corporation</organization>
      </author>
      <author fullname='Vishnu Pavan Beeram' initials='V. P.' surname='Beeram'>
         <organization>Juniper Networks</organization>
      </author>
      <author fullname='Igor Bryskin' initials='I.' surname='Bryskin'>
         <organization>Individual</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <date day='12' month='March' year='2023'/>
      <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 covers data that is independent of
   any technology or dataplane encapsulation and is divided into two
   YANG modules that cover device-specific, and device independent data.

   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-32'/>
   
</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='I-D.draft-liu-teas-transport-network-slice-yang' target='https://datatracker.ietf.org/doc/html/draft-liu-teas-transport-network-slice-yang-05'>
   <front>
      <title>IETF Network Slice YANG Data Model</title>
      <author fullname='Xufeng Liu' initials='X.' surname='Liu'>
         <organization>IBM Corporation</organization>
      </author>
      <author fullname='Jeff Tantsura' initials='J.' surname='Tantsura'>
         <organization>Microsoft</organization>
      </author>
      <author fullname='Igor Bryskin' initials='I.' surname='Bryskin'>
         <organization>Individual</organization>
      </author>
      <author fullname='Luis M. Contreras' initials='L. M.' surname='Contreras'>
         <organization>Telefonica</organization>
      </author>
      <author fullname='Qin Wu' initials='Q.' surname='Wu'>
         <organization>Huawei</organization>
      </author>
      <author fullname='Sergio Belotti' initials='S.' surname='Belotti'>
         <organization>Nokia</organization>
      </author>
      <author fullname='Reza Rokui' initials='R.' surname='Rokui'>
         <organization>Ciena</organization>
      </author>
      <date day='6' month='March' year='2022'/>
      <abstract>
	 <t>   This document describes a YANG data model for managing and
   controlling IETF network slices, defined in
   [I-D.ietf-teas-ietf-network-slices].

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-liu-teas-transport-network-slice-yang-05'/>
   
</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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
yi3Q9Sd2BSEpNHQzCkvx8dlyJKLJOaNVUfY5MVLIwStje2MAgvOevD0T/aEI
SaqUXUwMdIFbrio5W4xcEc9nwT0geWLdAdzKCBi+yvKrlI4FZp/Gy+jDFswW
TOuPGOveix0Yv+X2MQw5+8asqHKqpnd+Jp6bxPlPq8IQWSubTLKEpy4DGMF7
XfIjAauiFUHSpd1+52964C0TtCGKnKtgN5U7zlmJjOLB6+O+LVdMjsCDC87/
4PXi4lWwm1NceebBkO9OqRdTE8z2Ou1TiDqd6St8aDZc21MnzAAwERXesWVi
NGd5jhjIzlH2c4Pd+EKNoO+NjnYO6tNCa/EM+aaNnY5bAXDESyKeGmdXOyYY
6X0fZ9UOojyudLVT6UD/y7MI30dxxXuldLlj1viKK7Xu2vM2vW184+Wt7Kxj
/Q0vEYarSl7H9BuUNlAa97dblSJDpg0PL692+an6uwHzj3DqCttoa/6wRb/O
uktLdP3wcd/BTm+03jgA3Ko9V6QDitdPx+hOkD7FkM+ghaHT8I2uJfhHfxXl
1aKy+IRHbLUs9OwWNXnofWPpJRfw9XQEZZh2MfZ2xKGESxVlBPDbzHflctmF
G4kozL5pWyf4if4MFtXY/7+RaaqYTHsOK8YREuGFqf6pxSYVlFJC8B2enFPE
c5qv/WG4B8PQhWa+3nv2eF892n9ycHTyZzXDdN619nj8dntzezva2oy2tkc4
F66RkuK7bjru9HjN/aVZ01zltDXa+oof03U/C5xn1+oi28H6O3Q3Ybnz0zzd
ycodrLjThrsmAORunzVzscjaV3LSOt/hE1wdY3BxtbIrA0d5K9SOQ2t4zQZe
LLOjdjvtHLNoeWqj8Abgm3483O0vbYSqfytC/oU4LVxAcXYgE+KCi4M7nYic
yuF4+7JmKXlA/KHVy9uhGNyW08IR79ZZjeSqBcYOInqjk+zYvkvorN+1Cvfg
mp4W7uZSn7fC3wd5M/pPae/oFp040KJyXpzHmXdQLjeHq/kdt5GbyqTpJ5Ut
/8MT9YM+21Ffy7WtVZ6nJSFMF7denY8J7/GfLWZQ4ylMAFAFb9ut8h0q8K2p
Yq9aUHJPT9f90f7HgOm51rkDXuNq5y5gnVc5d4AKL03vgtRzQ3oHrI67y7sA
lj03l//Zqj6+sm0R8NU4IKil5bpAMIGbt/KhzASrxRaLxqrxjZczuu6dWieF
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
2jvoA422Huz4cfVu+q28iOzj2Om/+Yfa6U8f/nO33f8Pv93/hp3+bnx3baO6
xbZ/W7+x/f9u2z9+7rb9/+63/f+Ca+R+K9v++Yu33fiATe5ENzf+G1scZLqK
dFHkRYSX/Tja0OkjnZ7PXMM4mZDl8dVqSuLx9gBfEXyF8FvTtUGD/IRJ7HwO
9hpuYNUjQtLAmMmV5/6h/5O8zip3dVmQDR00fnbW7Hw3Srfo8qN48gqdWuDj
ozSfvFL71P/1R4/2N5SFdjNKvrX4yzAiBEBfgDrIs2mp1vdP3gqT8v2hcqJB
AeCdMi2cTnqQ6sCnjt8bPi+y+BImc7quxKLyYvfWqOBNDu9LbmCosKg8x6G4
/mj/+W2wAE/dhgJ+8XgBrwYtINT8CQ6cy7hpsbZb3/ps3iCBh9IN/d76TM2T
rE5w3/hibmMaqzq7/eDinZvbfqBgji5WtvU2x6a0wztvdXgKUj+8C4XmElPc
TPzFynb6D/LYg/pggUP97sZa5yR4TiQdKNIMTYXHdNCpIs1QVXjARv+ZGuaQ
kaYAekekNq9UpINE2qLOH5ouvAhT++69XlFRwv7g56oLOU+TubaINJB808LY
BN7eDeEbtMlb4470Pj5UPIk3L4xrwersjMGks0cUJ2z3hd7Z81LtZT9ROUnY
hJ9EYL118cW7gfLzB++t36YP/Z3vO8wluIFXQiRBPPgmDXDMpc4DRQBmXfvI
hA49EN532jfw+64iayS5W7jNwc93+7V0zleNEre5r/Qdj8Ixpc1hTJIp+L73
+/8uD8i5JfdXHpLTJ9ztExoYuw98IMMfY0NKR6o98NqvfNMhHLdna+u8rxUc
7s5Q6eBXd67KioKWWb2QbmKVvdW1dZ+r3X4QnAjco14dd+2drGGE19DphutX
HRxL2Il/9yZHhWAi7Lxq9e1Yhxr17dlmT1d7C/a1hlKLf70lbs/Aj5CHROFf
lX9/KpWX0qcope/98rQjZ/BjZP1vl/v4+YWSwFczvz3XOUXwY2Tnx8ZLovD7
Gskey++OsPp9m2Lm6Jf3fLTHLVXE70RkPtaDEz4WIftVT5F5G232h5W338v2
2w8t0f+2IxVuI9WsRVdvzHVw3n1D7uATyYiIzxIKu+9Bp5OpZjuj5Evfc6Wz
ElMi6DZ4PakLczM6RumKPE1N7XymFhfLknI2Cs3pCQgiKfNUkg4YYyZYkk31
QmdTspYW2jNu5i5NI+YEDQm+T2kn9OQi0ZfaL2VboEvP96GETTORMN1ygb/S
pYGEN6hPMRcCMzQmtBhb0oUTlBNRUs4BZ0KYnvARBD7SUE+XJRV69p+HI8oi
QBBzkL44S8o5pg0Awud1DHyoOFtAJZSaIhewG7xVPM/NFfcIotJZjCYY5ZVA
ly/zxGFC5iCUrEq6bt7ggdfZm/oebWZ1RtoHtXOasl16pr3cj3gGfpYqa4Iy
q1PLZAQ0udCTV3QBPC5CMu+7pORCB/kSMtSIy5xNMZU0DS+xqATg85jIOpW0
Ajq7HUtrDPAyv89MD+HnZeIOfPf6uCjyKp/kaYndoNBjXKqj/dO9Z0ffqdev
/+P5d3ufbz/YevNG4Rrm/on/4uHmg803b0bchzS/whQLU5VyGVmEnfhrb1hR
gaFN/wGUoCd5sQSXIUrmi5TR42rUP1sTIJ4wtJMLDXxZPzn5fsPhut1EyWLt
4/T96enxyS2bD9s+fXqCMIQEDx58Du1ZTprui2DJOBe9IlXuEzkXmKAz1Uyd
uYYGgGM8YDFpaWIHCTIZM2iSSZ3GhW3BZweox4KkmCRhUWjj9WhKR8L0IdAw
MIiVWxjvgmOEAaFYvVJajQUUsT0FqsT4n2R5I3wX8hdJdSLsCzgJqiinKxgV
iM14UuiYvwGhNH1T68lIj4biwQEPaj0EfzMBDcUyNaA5bxbXabXBHC+1j8Q8
puE6kTGHtAB9nNCiJ/T6sk4z6CK0RCKBWWFzbYeIzi6TIs94zVKpH/A+SJ8m
65xoB5qwihjDDZJSSvYK8TBJZEBdqE9EFjdjEmfqIr4kMupzuo8AgejZDAqA
vrHYuIZHqqFE/JSwh8AGTza/+PIzEDRiU1qCcCzwYAwiLaOZoO46qwrN6YUV
pwK6FMapECbQQiwBJ0gryT4D1k0JqtfnLsa3+IGAelhyEz8OKhaCmqYNzhDm
JDw75hAtM4aEW6gDz3U1xH+Ea0NJ98M8M5Pht9HFxo+B8J+og92j3a5ZhOmB
EpaXrPupJKqEEucDoOOVevH8ANRJkc+pRc5F/uvhU6z/XJ9jriSak9SF+58/
fIhdQPWTgh4td9zWCgCzo971ej6vMeTXHuc775DyPNg/eYLvAacddTTe/UrE
6181qEToFTSMvYRBAyXctguWyNth5U5D+TXwIAqxgvTn7YLaQRUdh6mRzHqT
SI6PjhAYzwLMEDOvbW5v0jxjmICt7qy8cdGUItx+GcM4yX5HVZngJhmROzal
c9DAKaDz22ARVDTt5u/QcDRfJO/cuKnsI2CedSHBjI+iSJ3Fk1cD9Dd4XtTT
/1qbgRLgzUtqd/Iqy69SPeU4YYesXMU4jDVgqDFdGZMJXgGy0/wqYzk/xiTW
vLZJt6XNunUwcHZuANmOfsiLaXS5PdocmeXm0TR3E7pNsb7K63Sq0uSVaKs4
e6V2pwXuEPguLgqdDtVjsNHB8tJqT08m0EiaJuQBHJyDEn9ULMtXmNX8KFc/
1EP1BOirDpPyooiH6i852EFg8H8fp+ALAKSLor6Ef/PplD2jp3msdsFJKMqS
3Vgyf8hWwm5cxmkt80NJid+jwf8H3ubPhJIcAQA=

-->

</rfc>

