<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.43 (Ruby 3.4.9) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-ivy-network-inventory-topology-11" category="std" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.34.0 -->
  <front>
    <title abbrev="Inventory Topology Mapping">A YANG Network Data Model for Inventory Topology Mapping</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-ivy-network-inventory-topology-11"/>
    <author fullname="Bo Wu" role="editor">
      <organization>Huawei</organization>
      <address>
        <email>lana.wubo@huawei.com</email>
      </address>
    </author>
    <author fullname="Mohamed Boucadair">
      <organization>Orange</organization>
      <address>
        <email>mohamed.boucadair@orange.com</email>
      </address>
    </author>
    <author fullname="Cheng Zhou">
      <organization>China Mobile</organization>
      <address>
        <email>zhouchengyjy@chinamobile.com</email>
      </address>
    </author>
    <author fullname="Qin Wu">
      <organization>Huawei</organization>
      <address>
        <email>bill.wu@huawei.com</email>
      </address>
    </author>
    <date year="2026" month="September" day="11"/>
    <area>Operations and Management</area>
    <workgroup>Network Inventory YANG</workgroup>
    <keyword>Automation</keyword>
    <keyword>Network Digital Map</keyword>
    <keyword>Network Inventory</keyword>
    <keyword>Network Operation</keyword>
    <keyword>Network Topology</keyword>
    <abstract>
      <?line 54?>

<t>This document specifies a YANG data model that extends the network
topology data model (RFC 8345) to map network topologies with inventories. The data model
introduces the "inventory-topology" network type and augmentations
for physical entity mappings and capabilities, which may be used by
any overlay network topology for service provisioning validation,
network maintenance, and capacity planning.</t>
    </abstract>
    <note removeInRFC="true">
      <name>Discussion Venues</name>
      <t>Discussion of this document takes place on the
    Network Inventory YANG Working Group mailing list (ivy@ietf.org),
    which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/ivy/"/>.</t>
      <t>Source for this draft and an issue tracker can be found at
    <eref target="https://github.com/ietf-ivy-wg/network-inventory-topology"/>.</t>
    </note>
  </front>
  <middle>
    <?line 63?>

<section anchor="introduction">
      <name>Introduction</name>
      <t><xref target="I-D.ietf-ivy-network-inventory-yang"/> defines the base network inventory
  model to aggregate the inventory data of Network Elements (NEs). This data includes identification of these NEs and their hardware,
  firmware, and software components.  Examples
   of inventory hardware components could be rack, shelf, slot, board,
   or physical port.  Examples of inventory software components could
   be platform Operating System (OS), software-modules, bios, or boot-loader <xref target="I-D.ietf-ivy-network-inventory-software"/>.</t>
      <t>In order to ease navigation between inventory and network topologies,
this document extends the network topology data model <xref target="RFC8345"/> for network
inventory mapping: "ietf-network-inventory-topology" (<xref target="sec-module"/>).
The YANG data model in this document conforms to the YANG data modeling language <xref target="RFC7950"/>.</t>
      <t>Similar to the base inventory data model <xref target="I-D.ietf-ivy-network-inventory-yang"/>, the network inventory topology data model
does not make any assumption about involved NEs and their roles in topologies. As such, the mapping
data model can be applied independent of the network type (optical local loops, access network, core network, etc.) and application.</t>
      <t>Therefore, this YANG data model can be used to represent a physical network instance at the lowest underlay abstraction level, as shown in <xref section="4.4.9" sectionFormat="of" target="RFC8345"/>.
Alternatively, it can be used in conjunction with existing network topology
models, such as <xref target="RFC9408"/>, <xref target="RFC8944"/>, <xref target="RFC8346"/>, <xref target="RFC8795"/>, and
<xref target="I-D.ietf-ccamp-otn-topo-yang"/>, when they contain nodes, links,
or termination points belonging to the lowest underlay level.</t>
      <section anchor="editorial-note-to-be-removed-by-rfc-editor">
        <name>Editorial Note (To be removed by RFC Editor)</name>
        <ul empty="true">
          <li>
            <t>Note to the RFC Editor: This section is to be removed prior to publication.</t>
          </li>
        </ul>
        <t>This document contains placeholder values that need to be replaced with finalized values at the time of publication. This note summarizes all of the substitutions that are needed.</t>
        <t>Please apply the following replacements:</t>
        <ul spacing="normal">
          <li>
            <t>XXXX --&gt; the assigned RFC number for this I-D</t>
          </li>
          <li>
            <t>AAAA --&gt; the assigned RFC number for <xref target="I-D.ietf-ivy-network-inventory-yang"/></t>
          </li>
          <li>
            <t>2026-09-11 --&gt; the actual date of the publication of this document</t>
          </li>
        </ul>
      </section>
    </section>
    <section anchor="conventions-and-definitions">
      <name>Conventions and Definitions</name>
      <section anchor="requirements-notations">
        <name>Requirements Notations</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.
<?line -6?>
        </t>
        <t>The following terms are defined in <xref target="RFC7950"/> and are not redefined here:</t>
        <ul spacing="normal">
          <li>
            <t>augment</t>
          </li>
          <li>
            <t>data model</t>
          </li>
          <li>
            <t>data node</t>
          </li>
        </ul>
        <t>The meanings of the symbols in the YANG tree diagrams are defined in <xref target="RFC8340"/>.</t>
        <t>This document uses terms defined in <xref target="I-D.ietf-ivy-network-inventory-yang"/>.</t>
        <t>The document adheres to the folding conventions in <xref target="RFC8792"/>.</t>
      </section>
    </section>
    <section anchor="sample">
      <name>Sample Use Cases of the Data Model</name>
      <section anchor="determine-available-resources-of-service-attachment-points-saps">
        <name>Determine Available Resources of Service Attachment Points (SAPs)</name>
        <t>The inventory topology data model provides a physical port
reference (port-ref) that enables correlation between logical
topology entities and physical inventory components.  During
service provisioning, the SAP's parent-termination-point can be
associated with the inventory topology's port-ref to locate the
underlying physical resource.</t>
        <t><xref target="nwi-topology-usage"/> illustrates the query interactions.
During service provisioning, the orchestrator can issue a query using the SAP
data model (e.g., obtaining a list of SAPs across multiple PEs
as shown in <xref section="A" sectionFormat="of" target="RFC9408"/>), and then uses the
inventory topology data model to identify the physical port underlying each
candidate SAP. Specifically, the "parent-termination-point"
of a SAP is mapped to the corresponding "port-ref"
in the inventory topology, allowing the orchestrator to locate the
physical resource. The orchestrator can then consult other relevant
topology models (e.g., <xref target="RFC8795"/>) to verify whether the identified
port has adequate capacity for the requested service.</t>
        <t>If the physical port underlying a candidate SAP has insufficient
resources (e.g., port speed fully utilized), the orchestrator
can select an alternate SAP that maps to a different port
with adequate capacity.  If no alternative SAP is available,
the orchestrator flags the request for manual intervention,
providing the operator with precise inventory information
about the bottleneck (e.g., "Port GE0/6/1 on NE-PE1 is at 95% utilization").
The resource constraint can also feed into a "what-if" analysis
(see <xref target="sec-whatif"/>) to evaluate hardware upgrades or
alternative underlay paths.</t>
        <figure anchor="nwi-topology-usage">
          <name>An Example Usage of Network Inventory Topology</name>
          <artset>
            <artwork type="svg" align="center"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" height="352" width="472" viewBox="0 0 472 352" class="diagram" text-anchor="middle" font-family="monospace" font-size="13px" stroke-linecap="round">
                <path d="M 32,288 L 32,320" fill="none" stroke="black"/>
                <path d="M 136,32 L 136,64" fill="none" stroke="black"/>
                <path d="M 136,112 L 136,160" fill="none" stroke="black"/>
                <path d="M 136,208 L 136,256" fill="none" stroke="black"/>
                <path d="M 192,160 L 192,200" fill="none" stroke="black"/>
                <path d="M 208,64 L 208,104" fill="none" stroke="black"/>
                <path d="M 208,256 L 208,288" fill="none" stroke="black"/>
                <path d="M 224,160 L 224,200" fill="none" stroke="black"/>
                <path d="M 280,32 L 280,64" fill="none" stroke="black"/>
                <path d="M 280,112 L 280,160" fill="none" stroke="black"/>
                <path d="M 280,208 L 280,256" fill="none" stroke="black"/>
                <path d="M 384,288 L 384,320" fill="none" stroke="black"/>
                <path d="M 136,32 L 280,32" fill="none" stroke="black"/>
                <path d="M 136,64 L 280,64" fill="none" stroke="black"/>
                <path d="M 136,112 L 280,112" fill="none" stroke="black"/>
                <path d="M 136,160 L 280,160" fill="none" stroke="black"/>
                <path d="M 136,208 L 280,208" fill="none" stroke="black"/>
                <path d="M 136,256 L 280,256" fill="none" stroke="black"/>
                <path d="M 32,288 L 384,288" fill="none" stroke="black"/>
                <path d="M 32,320 L 384,320" fill="none" stroke="black"/>
                <polygon class="arrowhead" points="232,200 220,194.4 220,205.6" fill="black" transform="rotate(90,224,200)"/>
                <polygon class="arrowhead" points="216,104 204,98.4 204,109.6" fill="black" transform="rotate(90,208,104)"/>
                <polygon class="arrowhead" points="200,200 188,194.4 188,205.6" fill="black" transform="rotate(90,192,200)"/>
                <g class="text">
                  <text x="212" y="52">Customer</text>
                  <text x="36" y="84">Customer</text>
                  <text x="104" y="84">Service</text>
                  <text x="168" y="84">request</text>
                  <text x="52" y="100">(e.g.,</text>
                  <text x="100" y="100">L3SM</text>
                  <text x="136" y="100">and</text>
                  <text x="176" y="100">L2SM)</text>
                  <text x="200" y="132">Service</text>
                  <text x="208" y="148">Orchestration</text>
                  <text x="76" y="180">(1a)</text>
                  <text x="120" y="180">Query</text>
                  <text x="164" y="180">SAPs</text>
                  <text x="252" y="180">(1b)</text>
                  <text x="288" y="180">Map</text>
                  <text x="320" y="180">SAP</text>
                  <text x="348" y="180">to</text>
                  <text x="396" y="180">physical</text>
                  <text x="452" y="180">port</text>
                  <text x="32" y="196">via</text>
                  <text x="64" y="196">SAP</text>
                  <text x="100" y="196">Data</text>
                  <text x="144" y="196">Model</text>
                  <text x="288" y="196">via</text>
                  <text x="344" y="196">Inventory</text>
                  <text x="420" y="196">Topology</text>
                  <text x="208" y="228">Network</text>
                  <text x="204" y="244">Controller</text>
                  <text x="208" y="308">Network</text>
                </g>
              </svg>
            </artwork>
            <artwork type="ascii-art" align="center"><![CDATA[
                  .-----------------.
                  |     Customer    |
                  '--------+--------'
  Customer Service request |
     (e.g., L3SM and L2SM) v
                  .--------+--------.
                  |    Service      |
                  |  Orchestration  |
                  '------+---+------'
         (1a) Query SAPs |   | (1b) Map SAP to physical port
    via SAP Data Model   v   v      via Inventory Topology
                  .------+---+------.
                  |     Network     |
                  |   Controller    |
                  '--------+--------'
                           |
     .---------------------+---------------------.
     |                  Network                  |
     '-------------------------------------------'
]]></artwork>
          </artset>
        </figure>
      </section>
      <section anchor="multi-layer-network-navigation">
        <name>Multi-layer Network Navigation</name>
        <t>A multi-layer network encompasses multiple layers (e.g., Layer 2 and Layer 3, or Optical Transport Network (OTN) and Wavelength Division Multiplexing (WDM) layers).</t>
        <t>A multi-layer network topology comprises nodes, links, and termination points that can belong to different layers.</t>
        <t>A multi-layer network can contain multiple types of topological elements: physical
elements (associated with an inventory element) or logical elements (associated
with topology elements in the underlay layer).</t>
        <t>The topology models support navigation across the different layers, down
to the physical layer, as defined in <xref section="4.4.9" sectionFormat="of" target="RFC8345"/>.
The navigation between the physical layer and the network inventory
is outside the scope of the topology models and is addressed in this document.</t>
        <t>This document augments both "ietf-network" (for nodes and network-
types) and "ietf-network-topology" (for links and termination
points), following the standard extension pattern described in
<xref section="4.3" sectionFormat="of" target="RFC8345"/>. This augmentation associates inventory
data nodes with topology data nodes to support multi-layer navigation across
physical and logical resources.</t>
        <t>To make this navigation operationally explicit, this module
provides concrete YANG data nodes in the "inventory-mapping-attributes"
container, where the leaf "ne-ref" links topology nodes to their
corresponding network elements, and the leaf "port-ref"
links termination points to their physical port components,
thereby enabling direct correlation between the <xref target="RFC8345"/>
topology and the underlying inventory.</t>
      </section>
      <section anchor="sec-whatif">
        <name>"What-if" Scenarios</name>
        <t><xref target="I-D.irtf-nmrg-network-digital-twin-arch"/> defines Network Digital Twin (NDT)
   as a virtual representation of the physical network.  Such
    representation is meant to be used to analyze,
   diagnose, emulate, and then manage the physical network based on
   data, models, and interfaces.</t>
        <t><xref target="I-D.ietf-nmop-simap-concept"/> defines Service and Infrastructure Maps (SIMAP)
 as an abstraction model that provides a unified view of both service and
 infrastructure information, enabling correlation between service requirements
 and underlying resource capabilities.</t>
        <t>Both architectures require accurate mapping between logical network topology
 and physical inventory as a foundational data layer. This model provides
 the essential physical resource information to such systems, enabling
 them to perform accurate "what-if" analysis (e.g., impact prediction
 of hardware End-of-Life, path re-optimization under resource constraints, service
 availability assessment).</t>
      </section>
    </section>
    <section anchor="module-tree-structure">
      <name>Module Tree Structure</name>
      <t>An overview of the structure of the "ietf-network-inventory-topology" module is shown in <xref target="tree"/>.</t>
      <figure anchor="tree">
        <name>The Structure of the Network Inventory Mapping Data Model</name>
        <artwork type="ascii-art" align="center"><![CDATA[
module: ietf-network-inventory-topology

  augment /nw:networks/nw:network/nw:network-types:
    +--rw inventory-topology!
  augment /nw:networks/nw:network/nw:node:
    +--rw inventory-mapping-attributes!
       +--rw ne-ref?   nwi:ne-ref
  augment /nw:networks/nw:network/nt:link:
    +--rw inventory-mapping-attributes!
       +--rw link-type?   identityref
  augment /nw:networks/nw:network/nw:node/nt:termination-point:
    +--rw inventory-mapping-attributes!
    |  +--rw ne-ref?     nwi:ne-ref
    |  +--rw port-ref?   leafref
    +--ro port-breakout!
       +--ro breakout-channel* [channel-id]
          +--ro channel-id    uint16
]]></artwork>
      </figure>
      <t>The module augments the "ietf-network-topology" module as follows:</t>
      <dl>
        <dt>Inventory mapping attributes for nodes, and termination points:</dt>
        <dd>
          <t>The corresponding containers augments the topology module with the references to the base network inventory</t>
        </dd>
      </dl>
      <section anchor="link-extensions">
        <name>Link Extensions</name>
        <t>This document adds a lightweight "link-type" leaf to the topology link mapping to enable basic physical media classification.</t>
        <dl>
          <dt>"link-type":</dt>
          <dd>
            <t>An identityref indicating the link media type.</t>
          </dd>
          <dt/>
          <dd>
            <t>Examples of wired link types are "copper", "fiber", or "coax". For wireless media, values such as "microwave", or "wlan" may be used. See also <xref target="RFC9656"/> for more detailed microwave radio attributes.</t>
          </dd>
          <dt/>
          <dd>
            <t>The "link-type" serves as a lightweight discriminator that guides to the
 appropriate specialized inventory model for detailed resource information.</t>
          </dd>
          <dt/>
          <dd>
            <t>For example, wired media ("fiber" or "copper") typically references a passive
network inventory model such as the one defined in <xref target="I-D.ygb-ivy-passive-network-inventory"/>.</t>
          </dd>
        </dl>
      </section>
      <section anchor="port-breakout-capability">
        <name>Port-Breakout Capability</name>
        <t>High-density Ethernet ports (e.g., 400 Gb/s DR4) can be split into
multiple independent lower-speed channels. The breakout channels
represent the intrinsic capability of the port to be partitioned,
regardless of whether the port is currently configured as a trunk or as
a breakout port.</t>
        <t>A trunk port is associated with exactly one physical interface.
A breakout port is a port that is decomposed into two or more physical
interfaces; those interfaces may run at the same or different speeds
and may consume the same or a different number of breakout channels.</t>
        <t>The container "port-breakout" is added under the termination-point
augmentation.  It lists the logical channels into which the single
physical port can be divided.  Only termination-points whose parent
port is breakout-capable need to instantiate the container; otherwise
the container is omitted, keeping the topology model minimal for the
common non-breakout case.</t>
        <t>Breakout channel is an atomic resource element obtained by partitioning a breakout port.
One physical interface may be associated with one or more breakout
channels, but one breakout channel MUST NOT be associated with more
than one physical interface. Appendix B provides a JSON instance <xref target="RFC7951"/> example for a port with breakout capabilities.</t>
        <t>It is assumed that a port which supports breakout can be configured
either as a trunk port or as a breakout port. The "port-breakout"
container serves as a capability advertisement for the termination-point
of the parent physical port.  It does not provide direct references or
pointers to the resulting lower-speed termination-points or interfaces.
The correlation between a specific "channel-id" and its corresponding
lower-speed termination-point is outside the scope of this document and
is expected to be provided by a future companion module. Interface channelisation (e.g., VLAN sub-interfaces) is
also outside the scope of this document and is addressed by the Layer 2 network topology model <xref target="RFC8944"/>.</t>
      </section>
    </section>
    <section anchor="sec-module">
      <name>Network Inventory Topology YANG Module</name>
      <t>This module augments the Network Topology module defined in <xref target="RFC8345"/>.</t>
      <t>This module imports the base network inventory <xref target="I-D.ietf-ivy-network-inventory-yang"/>.</t>
      <sourcecode type="yang" markers="true" name="ietf-network-inventory-topology@2026-09-11.yang"><![CDATA[
module ietf-network-inventory-topology {
  yang-version 1.1;
  namespace
    "urn:ietf:params:xml:ns:yang:ietf-network-inventory-topology";
  prefix nwit;

  import ietf-network {
    prefix nw;
    reference
      "RFC 8345: A YANG Data Model for Network Topologies,
                 Section 4.1";
  }
  import ietf-network-topology {
    prefix nt;
    reference
      "RFC 8345: A YANG Data Model for Network Topologies,
                 Section 4.2";
  }
  import ietf-network-inventory {
    prefix nwi;
    reference
      "RFC AAAA: A Base YANG Data Model for Network Inventory";
  }

  organization
    "IETF Network Inventory YANG (ivy) Working Group";
  contact
    "WG Web:   https://datatracker.ietf.org/wg/ivy
     WG List:  IVY <mailto:ivy@ietf.org>

     Editor: Bo Wu
             <lana.wubo@huawei.com>
     Editor: Mohamed Boucadair
             <mohamed.boucadair@orange.com>
     Author: Cheng Zhou
             <zhouchengyjy@chinamobile.com>
     Author: Qin Wu
             <bill.wu@huawei.com>";
  description
    "This module defines a YANG module for network
     topology and inventory mapping.

     Copyright (c) 2026 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).

     All revisions of IETF and IANA published modules can be found
     at the YANG Parameters registry group
     (https://www.iana.org/assignments/yang-parameters).

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

  revision 2026-09-11 {
    description
      "Initial revision.";
    reference
      "RFC XXXX: A Network Data Model for Inventory Topology
                 Mapping";
  }

  identity link-type {
    description
      "Base identity for classifying the physical media type of a
       link at the inventory topology layer. Additional identities
       may be defined to cover other media types.";
  }

  identity copper {
    base link-type;
    description
      "Copper-based physical link.";
  }

  identity fiber {
    base link-type;
    description
      "Fiber-based physical link.";
  }

  identity coax {
    base link-type;
    description
      "Coaxial cable-based physical link.";
  }

  identity microwave {
    base link-type;
    description
      "Microwave-based wireless link.

       Detailed microwave radio attributes are defined in the
       microwave topology data model.";
    reference
      "RFC 9656: A YANG Data Model for Microwave Topology";
  }

  identity wlan {
    base link-type;
    description
      "IEEE 802.11 wireless link.";
  }

  identity unknown {
    base link-type;
    description
      "The link media type is unknown or could not be determined.

       This identity is used as a fallback when the physical medium
       cannot be classified into any of the other defined types.

       When a discovery system is unable to determine the media
       type, it should use this identity rather than leaving the
       leaf unset. An unset leaf indicates that the link type has
       not been assessed, whereas unknown explicitly records that
       the medium could not be classified.";
  }

  identity leased-fiber {
    base fiber;
    description
      "Leased fiber link.  The physical medium is fiber, but the link
       is provided by a third-party operator.  Detailed physical
       attributes are typically not visible to the lessee.";
  }

  augment "/nw:networks/nw:network/nw:network-types" {
    description
      "Introduces a new network type for inventory topology
       mapping.";
    container inventory-topology {
      presence
        "Indicates a physical network topology, containing
         physical-layer attributes including inventory mapping, port
         breakout capabilities, and link media types.";
      description
        "Container for the inventory-topology network type.

         When present, it signals that the network contains
         physical-layer augmentations as defined in this module.
         This network type is typically discovered by the network
         controller to identify a physical underlay network; it may
         be configured manually when discovery is not available.

         This network type is intended to serve as the underlay
         for logical network topologies (Layer 2, Layer 3,
         Traffic Engineering (TE), etc.).";
    }
  }

  augment "/nw:networks/nw:network/nw:node" {
    when '../nw:network-types/nwit:inventory-topology';
    description
      "Augments the network topology node with inventory mapping
       attributes. This enables correlation between the logical node
       and its physical network element.";
    container inventory-mapping-attributes {
      presence
        "If present, it indicates this is a physical node, which
         maps to a network element. If not present, it indicates it
         is an abstract node.";
      description
        "Container for inventory mapping attributes of a node.";
      leaf ne-ref {
        type nwi:ne-ref;
        description
          "Reference to the NE in the inventory that corresponds to
           this topology node.

           This reference establishes a 1:1 mapping between the
           logical node and its physical NE.";
      }
    }
  }

  augment "/nw:networks/nw:network/nt:link" {
    when '../nw:network-types/nwit:inventory-topology';
    description
      "Augments the network topology link with inventory-related
       attributes.";
    container inventory-mapping-attributes {
      presence "Indicates a physical link, at the lowest underlay
                abstraction level.";
      description
        "Container for inventory-related attributes of a link.

         This container provides lightweight media classification.
         The link-type indicates which specialized inventory model
         contains detailed resource information:

         - Wired media (fiber, copper): passive network inventory
         - Wireless media (microwave, wlan): wireless-specific
           inventory

           Detailed inventory references may be added in future
           modules.";
      leaf link-type {
        type identityref {
          base link-type;
        }
        description
          "Classification of the link media type at the topology
           layer.

           The base identity 'link-type' is extensible. Examples
           of derived identities include 'copper', 'fiber',
           'coax', 'microwave', and 'wlan'.

           This leaf serves as a lightweight discriminator.  When
           the value is 'microwave', detailed microwave link
           attributes are defined in the microwave topology data
           model. Wired media (e.g., fiber, copper, or coax) may
           be detailed in a passive network inventory data
           model.";
      }
    }
  }

  augment "/nw:networks/nw:network/nw:node/nt:termination-point" {
    when '../../nw:network-types/nwit:inventory-topology';
    description
      "Augments the termination point (TP) with inventory mapping
       and port breakout.";
    container inventory-mapping-attributes {
      presence
        "If present, it indicates this is a physical TP, which
         maps to a port component. If not present, it indicates it
         is a logical TP.";
      description
        "Container for inventory mapping attributes of a TP.";
      uses nwi:port-ref {
        refine "port-ref" {
          description
            "Reference to the physical port component in the
             network inventory. This reference establishes a 1:1
             mapping between the logical TP and its physical port
             component.";
        }
      }
    }
    container port-breakout {
      presence "Indicates the port supports channel breakout.";
      config false;
      description
        "Breakout capability of the physical port represented by
         this TP. One TP maps to one physical port; channels are
         listed here. This container is present only when the
         underlying hardware supports partitioning the port into
         multiple independent channels (e.g., 400G to 4x100G).";
      list breakout-channel {
        key "channel-id";
        description
          "Indicates the list of breakout channels available
           on this port. Each entry represents an independent lane
           or sub-port that can be used for channelized
           interfaces.";
        leaf channel-id {
          type uint16;
          description
            "Records a unique identifier for the breakout channel
             within the scope of the parent port.";
        }
      }
    }
  }
}
]]></sourcecode>
    </section>
    <section anchor="operational-considerations">
      <name>Operational Considerations</name>
      <t>The "ietf-network-inventory-topology" YANG module enables a network controller to report discovered network topology and inventory information. Automatic discovery serves as the primary mechanism, with selective configuration capabilities provided for scenarios where discovery is not feasible.</t>
      <t>For typical operations such as service provisioning and network planning, the model offers read-only query
access to authoritative mappings between logical topology and physical inventory.
The inventory-mapping-attributes containers are defined as read-write (config true) to accommodate cases where automatic discovery is not possible, including:</t>
      <ul spacing="normal">
        <li>
          <t>Customer Premises Equipment (CPE) outside the operator's management domain</t>
        </li>
        <li>
          <t>Leased lines and third-party transport resources</t>
        </li>
        <li>
          <t>Planned or hypothetical resources for future deployment</t>
        </li>
      </ul>
      <t>In these cases, the operator manually configures the mapping to maintain accurate topology-to-inventory correlation.</t>
      <t>The following nodes are read-only (config false) as they represent hardware-determined state:</t>
      <dl>
        <dt>port-breakout:</dt>
        <dd>
          <t>Hardware capability determined by physical port characteristics</t>
        </dd>
      </dl>
      <t>Therefore, in typical deployments, "ne-ref", "port-ref", and "link-type"
SHOULD be populated through automatic discovery but MAY
only be overridden manually in exceptional cases (e.g., CPE,
leased lines, or planned resources). The "port-breakout" container
MUST always reflect hardware-determined state and therefore MUST
NOT be manually configured.</t>
      <t>The "inventory-topology" presence container under "network-types" is
typically set by the network controller when it discovers or
provisions network instance representing the physical layer.
It MAY be configured manually to declare a network as an
inventory topology when discovery is not available.</t>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>This section is modeled after the template described in <xref section="3.7.1" sectionFormat="of" target="RFC9907"/>.</t>
      <t>The "ietf-network-inventory-topology" YANG module defines a data model that is
designed to be accessed via YANG-based management protocols, such as
Network Configuration (NETCONF) <xref target="RFC6241"/> and RESTCONF <xref target="RFC8040"/>. These YANG-based management (1) have to
use a secure transport layer and (2) have to use mutual authentication (e.g., Secure Shell (SSH) <xref target="RFC4252"/>, TLS <xref target="RFC9846"/>, and
QUIC <xref target="RFC9000"/>).</t>
      <t>The Network Configuration Access Control Model (NACM) <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).  All writable data nodes are likely to be sensitive or
vulnerable in some network environments.  Write
operations (e.g., edit-config) and delete operations to these data
nodes without proper protection or authentication can have a negative
effect on network operations.  The following subtrees and data nodes
have particular sensitivities/vulnerabilities:</t>
      <ul empty="true">
        <li>
          <dl>
            <dt>'ne-ref', 'port-ref', and 'link-type':</dt>
            <dd>
              <t>These nodes are sensitive as they establish the mapping
between logical topology and physical inventory. Incorrect
inventory mapping (e.g., stale or manually misconfigured
'ne-ref' or 'port-ref' values) may lead to mis-provisioning
of services or misinterpretation of physical resource
availability, which can result in failed service
activation, unexpected traffic paths, or inaccurate
capacity planning.</t>
            </dd>
          </dl>
        </li>
      </ul>
      <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. Specifically, the following
subtrees and data nodes have particular sensitivities/
vulnerabilities:</t>
      <ul empty="true">
        <li>
          <dl>
            <dt>'ne-ref', 'port-ref', and 'link-type':</dt>
            <dd>
              <t>These nodes are sensitive as they reveal network infrastructure details.
'ne-ref' may be used to track the set of network elements;
'port-ref' discloses internal port and component naming;
'link-type' can reveal infrastructure ownership (e.g., the 'leased-fiber' identity
distinguishes third-party transport from owned infrastructure).</t>
            </dd>
          </dl>
        </li>
      </ul>
      <ul empty="true">
        <li>
          <dl>
            <dt>'port-breakout':</dt>
            <dd>
              <t>This node exposes hardware capabilities.</t>
            </dd>
          </dl>
        </li>
      </ul>
      <t>There are no particularly sensitive RPC or action operations defined in this module.</t>
      <t>As this module augments the network topology model defined in <xref target="RFC8345"/>,
the module also inherits the security considerations discussed in
<xref section="8" sectionFormat="of" target="RFC8345"/> for the underlying network topology data model.</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>IANA is requested to register the following URI in the "ns" subregistry within
   the "IETF XML Registry" <xref target="RFC3688"/>:</t>
      <artwork><![CDATA[
   URI:  urn:ietf:params:xml:ns:yang:ietf-network-inventory-topology
   Registrant Contact:  The IESG.
   XML:  N/A; the requested URI is an XML namespace.
]]></artwork>
      <t>IANA is requested to register the following YANG module in the "YANG Module
   Names" registry <xref target="RFC6020"/> within the "YANG Parameters" registry group:</t>
      <artwork><![CDATA[
   Name:  ietf-network-inventory-topology
   Maintained by IANA?  N
   Namespace:
     urn:ietf:params:xml:ns:yang:ietf-network-inventory-topology
   Prefix:  nwit
   Reference:  RFC XXXX
]]></artwork>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="I-D.ietf-ivy-network-inventory-yang">
          <front>
            <title>A Base YANG Data Model for Network Inventory</title>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Jean-Francois Bouquier" initials="J." surname="Bouquier">
              <organization>Vodafone</organization>
            </author>
            <author fullname="Fabio Peruzzini" initials="F." surname="Peruzzini">
              <organization>FiberCop</organization>
            </author>
            <author fullname="Phil Bedard" initials="P." surname="Bedard">
              <organization>Cisco</organization>
            </author>
            <date day="27" month="May" year="2026"/>
            <abstract>
              <t>   This document defines a base YANG data model for reporting network
   inventory.  The scope of this base model is set to be application-
   and technology-agnostic.  The base data model can be augmented with
   application- and technology-specific details.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ivy-network-inventory-yang-18"/>
        </reference>
        <reference anchor="RFC8345">
          <front>
            <title>A YANG Data Model for Network Topologies</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="J. Medved" initials="J." surname="Medved"/>
            <author fullname="R. Varga" initials="R." surname="Varga"/>
            <author fullname="N. Bahadur" initials="N." surname="Bahadur"/>
            <author fullname="H. Ananthakrishnan" initials="H." surname="Ananthakrishnan"/>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <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="RFC7950">
          <front>
            <title>The YANG 1.1 Data Modeling Language</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <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="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner"/>
            <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">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <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="RFC8341">
          <front>
            <title>Network Configuration Access Control Model</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <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">
          <front>
            <title>The IETF XML Registry</title>
            <author fullname="M. Mealling" initials="M." surname="Mealling"/>
            <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">
          <front>
            <title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <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>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="I-D.ietf-ivy-network-inventory-software">
          <front>
            <title>A YANG Network Data Model of Network Inventory Software Extensions</title>
            <author fullname="Bo Wu" initials="B." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Cheng Zhou" initials="C." surname="Zhou">
              <organization>China Mobile</organization>
            </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Mohamed Boucadair" initials="M." surname="Boucadair">
              <organization>Orange</organization>
            </author>
            <date day="6" month="July" year="2026"/>
            <abstract>
              <t>   This document extends the base Network Inventory YANG model to
   support non-physical network elements (NEs), such as controllers,
   virtual routers, and virtual firewalls, as well as software
   components like platform operating systems and software modules.  In
   addition to the software revisions and patches already defined in the
   base model, this extension introduces software status and time stamp
   information.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ivy-network-inventory-software-04"/>
        </reference>
        <reference anchor="RFC9408">
          <front>
            <title>A YANG Network Data Model for Service Attachment Points (SAPs)</title>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <author fullname="S. Barguil" initials="S." surname="Barguil"/>
            <author fullname="Q. Wu" initials="Q." surname="Wu"/>
            <author fullname="V. Lopez" initials="V." surname="Lopez"/>
            <date month="June" year="2023"/>
            <abstract>
              <t>This document defines a YANG data model for representing an abstract view of the provider network topology that contains the points from which its services can be attached (e.g., basic connectivity, VPN, network slices). Also, the model can be used to retrieve the points where the services are actually being delivered to customers (including peer networks).</t>
              <t>This document augments the 'ietf-network' data model defined in RFC 8345 by adding the concept of Service Attachment Points (SAPs). The SAPs are the network reference points to which network services, such as Layer 3 Virtual Private Network (L3VPN) or Layer 2 Virtual Private Network (L2VPN), can be attached. One or multiple services can be bound to the same SAP. Both User-to-Network Interface (UNI) and Network-to-Network Interface (NNI) are supported in the SAP data model.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9408"/>
          <seriesInfo name="DOI" value="10.17487/RFC9408"/>
        </reference>
        <reference anchor="RFC8944">
          <front>
            <title>A YANG Data Model for Layer 2 Network Topologies</title>
            <author fullname="J. Dong" initials="J." surname="Dong"/>
            <author fullname="X. Wei" initials="X." surname="Wei"/>
            <author fullname="Q. Wu" initials="Q." surname="Wu"/>
            <author fullname="M. Boucadair" initials="M." surname="Boucadair"/>
            <author fullname="A. Liu" initials="A." surname="Liu"/>
            <date month="November" year="2020"/>
            <abstract>
              <t>This document defines a YANG data model for Layer 2 network topologies. In particular, this data model augments the generic network and network topology data models with topology attributes that are specific to Layer 2.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8944"/>
          <seriesInfo name="DOI" value="10.17487/RFC8944"/>
        </reference>
        <reference anchor="RFC8346">
          <front>
            <title>A YANG Data Model for Layer 3 Topologies</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="J. Medved" initials="J." surname="Medved"/>
            <author fullname="R. Varga" initials="R." surname="Varga"/>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <author fullname="H. Ananthakrishnan" initials="H." surname="Ananthakrishnan"/>
            <author fullname="N. Bahadur" initials="N." surname="Bahadur"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document defines a YANG data model for Layer 3 network topologies.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8346"/>
          <seriesInfo name="DOI" value="10.17487/RFC8346"/>
        </reference>
        <reference anchor="RFC8795">
          <front>
            <title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <author fullname="I. Bryskin" initials="I." surname="Bryskin"/>
            <author fullname="V. Beeram" initials="V." surname="Beeram"/>
            <author fullname="T. Saad" initials="T." surname="Saad"/>
            <author fullname="H. Shah" initials="H." surname="Shah"/>
            <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
            <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="I-D.ietf-ccamp-otn-topo-yang">
          <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>Individual</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="16" month="June" year="2026"/>
            <abstract>
              <t>   This document defines a YANG data model for representing, retrieving,
   and manipulating Optical Transport Network (OTN) topologies.  It is
   independent of control plane protocols and captures topological and
   resource-related information pertaining to OTN.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-otn-topo-yang-21"/>
        </reference>
        <reference anchor="RFC8340">
          <front>
            <title>YANG Tree Diagrams</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document captures the current syntax used in YANG module tree diagrams. The purpose of this document is to provide a single location for this definition. This syntax may be updated from time to time based on the evolution of the YANG language.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="215"/>
          <seriesInfo name="RFC" value="8340"/>
          <seriesInfo name="DOI" value="10.17487/RFC8340"/>
        </reference>
        <reference anchor="RFC8792">
          <front>
            <title>Handling Long Lines in Content of Internet-Drafts and RFCs</title>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <author fullname="E. Auerswald" initials="E." surname="Auerswald"/>
            <author fullname="A. Farrel" initials="A." surname="Farrel"/>
            <author fullname="Q. Wu" initials="Q." surname="Wu"/>
            <date month="June" year="2020"/>
            <abstract>
              <t>This document defines two strategies for handling long lines in width-bounded text content. One strategy, called the "single backslash" strategy, is based on the historical use of a single backslash ('\') character to indicate where line-folding has occurred, with the continuation occurring with the first character that is not a space character (' ') on the next line. The second strategy, called the "double backslash" strategy, extends the first strategy by adding a second backslash character to identify where the continuation begins and is thereby able to handle cases not supported by the first strategy. Both strategies use a self-describing header enabling automated reconstitution of the original content.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8792"/>
          <seriesInfo name="DOI" value="10.17487/RFC8792"/>
        </reference>
        <reference anchor="I-D.irtf-nmrg-network-digital-twin-arch">
          <front>
            <title>Network Digital Twin (NDT): Concepts and Reference Architecture</title>
            <author fullname="Cheng Zhou" initials="C." surname="Zhou">
              <organization>China Mobile</organization>
            </author>
            <author fullname="Hongwei Yang" initials="H." surname="Yang">
              <organization>China Mobile</organization>
            </author>
            <author fullname="Xiaodong Duan" initials="X." surname="Duan">
              <organization>China Mobile</organization>
            </author>
            <author fullname="Diego Lopez" initials="D." surname="Lopez">
         </author>
            <author fullname="Antonio Pastor" initials="A." surname="Pastor">
         </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Mohamed Boucadair" initials="M." surname="Boucadair">
              <organization>Orange</organization>
            </author>
            <author fullname="Christian Jacquenet" initials="C." surname="Jacquenet">
              <organization>Orange</organization>
            </author>
            <date day="1" month="July" year="2026"/>
            <abstract>
              <t>   The application of Digital Twin technology in the networking field is
   meant to develop various rich network applications, realize efficient
   and cost-effective data-driven network management, and accelerate
   network innovation.

   This document presents an overview of the concept of Network Digital
   Twin (NDT), provides the basic definitions and a reference
   architecture, lists a set of application scenarios, and discusses
   such technology's benefits and key challenges.

   This document is a product of the Network Management Research Group
   (NMRG) of the Internet Research Task Force (IRTF).  This document
   reflects the consensus of the research group.  It is not a candidate
   for any level of Internet Standard and is published for informational
   purposes.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-irtf-nmrg-network-digital-twin-arch-13"/>
        </reference>
        <reference anchor="I-D.ietf-nmop-simap-concept">
          <front>
            <title>SIMAP: Concept, Requirements, and Use Cases</title>
            <author fullname="Olga Havel" initials="O." surname="Havel">
              <organization>Huawei</organization>
            </author>
            <author fullname="Benoît Claise" initials="B." surname="Claise">
              <organization>Everything OPS</organization>
            </author>
            <author fullname="Oscar Gonzalez de Dios" initials="O. G." surname="de Dios">
              <organization>Telefonica</organization>
            </author>
            <author fullname="Thomas Graf" initials="T." surname="Graf">
              <organization>Swisscom</organization>
            </author>
            <date day="4" month="September" year="2026"/>
            <abstract>
              <t>   This document defines the concept of Service &amp; Infrastructure Maps
   (SIMAP) and identifies a set of SIMAP requirements and use cases.
   The SIMAP was previously known as Digital Map. SIMAP evolves the
   earlier 'Digital Map' concept by making explicit the ties between
   service and infrastructure layers, clarifying expected outcomes for
   operations and automation, and addressing ambiguity associated with
   the term 'digital.'

   The document intends to be used as a reference for the assessment of
   the various topology modules to meet SIMAP requirements.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-nmop-simap-concept-13"/>
        </reference>
        <reference anchor="RFC9656">
          <front>
            <title>A YANG Data Model for Microwave Topology</title>
            <author fullname="S. Mansfield" initials="S." role="editor" surname="Mansfield"/>
            <author fullname="J. Ahlberg" initials="J." surname="Ahlberg"/>
            <author fullname="M. Ye" initials="M." surname="Ye"/>
            <author fullname="X. Li" initials="X." surname="Li"/>
            <author fullname="D. Spreafico" initials="D." surname="Spreafico"/>
            <date month="September" year="2024"/>
            <abstract>
              <t>This document defines a YANG data model to describe microwave and millimeter-wave radio links in a network topology.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9656"/>
          <seriesInfo name="DOI" value="10.17487/RFC9656"/>
        </reference>
        <reference anchor="I-D.ygb-ivy-passive-network-inventory">
          <front>
            <title>A YANG Data Model for Passive Network Inventory</title>
            <author fullname="Aihua Guo" initials="A." surname="Guo">
              <organization>Futurewei</organization>
            </author>
            <author fullname="tom van caenegem" initials="T." surname="van caenegem">
              <organization>Nokia</organization>
            </author>
            <author fullname="Nigel Davis" initials="N." surname="Davis">
              <organization>Ciena</organization>
            </author>
            <author fullname="Mauro Tilocca" initials="M." surname="Tilocca">
              <organization>FiberCop</organization>
            </author>
            <author fullname="Brad Peters" initials="B." surname="Peters">
              <organization>NBN</organization>
            </author>
            <date day="26" month="May" year="2026"/>
            <abstract>
              <t>   This document presents a YANG data model for tracking and managing
   passive network inventory.  The model augments the base network
   inventory model.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ygb-ivy-passive-network-inventory-05"/>
        </reference>
        <reference anchor="RFC7951">
          <front>
            <title>JSON Encoding of Data Modeled with YANG</title>
            <author fullname="L. Lhotka" initials="L." surname="Lhotka"/>
            <date month="August" year="2016"/>
            <abstract>
              <t>This document defines encoding rules for representing configuration data, state data, parameters of Remote Procedure Call (RPC) operations or actions, and notifications defined using YANG as JavaScript Object Notation (JSON) text.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7951"/>
          <seriesInfo name="DOI" value="10.17487/RFC7951"/>
        </reference>
        <reference anchor="RFC9907">
          <front>
            <title>Guidelines for Authors and Reviewers of Documents Containing YANG Data Models</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Boucadair" initials="M." role="editor" surname="Boucadair"/>
            <author fullname="Q. Wu" initials="Q." surname="Wu"/>
            <date month="March" year="2026"/>
            <abstract>
              <t>This document provides guidelines for authors and reviewers of specifications containing YANG data models, including IANA-maintained YANG modules. Recommendations and procedures are defined, which are intended to increase interoperability and usability of Network Configuration Protocol (NETCONF) and RESTCONF protocol implementations that utilize YANG modules.</t>
              <t>This document obsoletes RFC 8407; it also updates RFC 8126 by providing additional guidelines for writing the IANA considerations for RFCs that specify IANA-maintained YANG modules.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="216"/>
          <seriesInfo name="RFC" value="9907"/>
          <seriesInfo name="DOI" value="10.17487/RFC9907"/>
        </reference>
        <reference anchor="RFC6241">
          <front>
            <title>Network Configuration Protocol (NETCONF)</title>
            <author fullname="R. Enns" initials="R." role="editor" surname="Enns"/>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <author fullname="A. Bierman" initials="A." role="editor" surname="Bierman"/>
            <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">
          <front>
            <title>RESTCONF Protocol</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <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="RFC4252">
          <front>
            <title>The Secure Shell (SSH) Authentication Protocol</title>
            <author fullname="T. Ylonen" initials="T." surname="Ylonen"/>
            <author fullname="C. Lonvick" initials="C." role="editor" surname="Lonvick"/>
            <date month="January" year="2006"/>
            <abstract>
              <t>The Secure Shell Protocol (SSH) is a protocol for secure remote login and other secure network services over an insecure network. This document describes the SSH authentication protocol framework and public key, password, and host-based client authentication methods. Additional authentication methods are described in separate documents. The SSH authentication protocol runs on top of the SSH transport layer protocol and provides a single authenticated tunnel for the SSH connection protocol. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4252"/>
          <seriesInfo name="DOI" value="10.17487/RFC4252"/>
        </reference>
        <reference anchor="RFC9846">
          <front>
            <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
            <author fullname="E. Rescorla" initials="E." surname="Rescorla"/>
            <date month="July" year="2026"/>
            <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 obsoletes RFC 8446, which specified TLS 1.3. This document obsoletes RFC 5246 (specifying TLS 1.2) and RFCs 5077, 6961, 7627, and 8422, all of which pertain to TLS 1.2 or earlier, and updates RFCs 5705 and 6066. This document also specifies new requirements for TLS 1.2 implementations.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9846"/>
          <seriesInfo name="DOI" value="10.17487/RFC9846"/>
        </reference>
        <reference anchor="RFC9000">
          <front>
            <title>QUIC: A UDP-Based Multiplexed and Secure Transport</title>
            <author fullname="J. Iyengar" initials="J." role="editor" surname="Iyengar"/>
            <author fullname="M. Thomson" initials="M." role="editor" surname="Thomson"/>
            <date month="May" year="2021"/>
            <abstract>
              <t>This document defines the core of the QUIC transport protocol. QUIC provides applications with flow-controlled streams for structured communication, low-latency connection establishment, and network path migration. QUIC includes security measures that ensure confidentiality, integrity, and availability in a range of deployment circumstances. Accompanying documents describe the integration of TLS for key negotiation, loss detection, and an exemplary congestion control algorithm.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9000"/>
          <seriesInfo name="DOI" value="10.17487/RFC9000"/>
        </reference>
      </references>
    </references>
    <?line 705?>

<section anchor="link-type-usage-examples">
      <name>'link-type' Usage Examples</name>
      <t>This appendix provides examples illustrating the usage of the
"link-type" data node.</t>
      <t>Scenario: Device "SW-1" and device "SW-2" are directly connected by a fiber.</t>
      <t>Physical topology:</t>
      <artset>
        <artwork type="svg"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" height="112" width="456" viewBox="0 0 456 112" class="diagram" text-anchor="middle" font-family="monospace" font-size="13px" stroke-linecap="round">
            <path d="M 8,32 L 8,96" fill="none" stroke="black"/>
            <path d="M 80,32 L 80,96" fill="none" stroke="black"/>
            <path d="M 376,32 L 376,96" fill="none" stroke="black"/>
            <path d="M 448,32 L 448,96" fill="none" stroke="black"/>
            <path d="M 8,32 L 80,32" fill="none" stroke="black"/>
            <path d="M 376,32 L 448,32" fill="none" stroke="black"/>
            <path d="M 80,62 L 152,62" fill="none" stroke="black"/>
            <path d="M 80,66 L 152,66" fill="none" stroke="black"/>
            <path d="M 256,62 L 376,62" fill="none" stroke="black"/>
            <path d="M 256,66 L 376,66" fill="none" stroke="black"/>
            <path d="M 8,96 L 80,96" fill="none" stroke="black"/>
            <path d="M 376,96 L 448,96" fill="none" stroke="black"/>
            <g class="text">
              <text x="44" y="68">SW-1</text>
              <text x="184" y="68">fiber</text>
              <text x="228" y="68">link</text>
              <text x="412" y="68">SW-2</text>
            </g>
          </svg>
        </artwork>
        <artwork type="ascii-art"><![CDATA[
.--------.                                    .--------.
|        |                                    |        |
|  SW-1  +========= fiber link ===============+  SW-2  |
|        |                                    |        |
'--------'                                    '--------'
]]></artwork>
      </artset>
      <t>Key parts of the JSON example are as follows:</t>
      <sourcecode type="json"><![CDATA[
=============== NOTE: '\' line wrapping per RFC 8792 ================

{
  "ietf-network:networks": {
    "network": [
      {
        "network-id": "example:campus-topology",
        "network-types": {
          "ietf-network-inventory-topology:inventory-topology": {}
        },
        "node": [
          {
            "node-id": "example:SW-1",
            "ietf-network-inventory-topology:inventory-mapping-\
                                                       attributes": {
              "ne-ref": "example:NE-SW1"
            },
            "ietf-network-topology:termination-point": [
              {
                "tp-id": "example:TP-SW1-P1",
                "ietf-network-inventory-topology:inventory-mapping-\
                                                       attributes": {
                  "ne-ref": "example:NE-SW1",
                  "port-ref": "/nwi:network-inventory/nwi:network-\
elements/nwi:network-element[ne-id='example:NE-SW1']/nwi:components/\
                            nwi:component[component-id='eth-port-1']"
                }
              }
            ]
          },
          {
            "node-id": "example:SW-2",
            "ietf-network-inventory-topology:inventory-mapping-\
                                                       attributes": {
              "ne-ref": "example:NE-SW2"
            },
            "ietf-network-topology:termination-point": [
              {
                "tp-id": "example:TP-SW2-P1",
                "ietf-network-inventory-topology:inventory-mapping-\
                                                       attributes": {
                  "ne-ref": "example:NE-SW2",
                  "port-ref": "/nwi:network-inventory/nwi:network-\
elements/nwi:network-element[ne-id='NE-SW2']/nwi:components/nwi:\
                                component[component-id='eth-port-1']"
                }
              }
            ]
          }
        ],
        "ietf-network-topology:link": [
          {
            "link-id": "example:Link-SW1-SW2",
            "source": {
              "source-node": "example:SW-1",
              "source-tp": "example:TP-SW1-P1"
            },
            "destination": {
              "dest-node": "example:SW-2",
              "dest-tp": "example:TP-SW2-P1"
            },
            "ietf-network-inventory-topology:inventory-mapping-\
                                                       attributes": {
              "link-type": "ietf-network-inventory-topology:fiber"
            }
          }
        ]
      }
    ]
  }
}
]]></sourcecode>
    </section>
    <section anchor="json-example-of-an-multi-fibre-push-on-mpo-breakout-channel-port">
      <name>JSON Example of an Multi-fibre Push On (MPO) Breakout-Channel Port</name>
      <t>This appendix provides an example of a 400 Gb/s DR4 port that is physically implemented as four independent 100 Gb/s lanes (an MPO breakout). The lanes are exposed as breakout-channel entries so that the port can later be configured as either a single 400G trunk or four 100G breakout interfaces. The instance data below shows the minimal JSON encoding <xref target="RFC7951"/> of the "port-breakout" container for this port.</t>
      <sourcecode type="json"><![CDATA[
=============== NOTE: '\' line wrapping per RFC 8792 ================

{
  "ietf-network:networks": {
    "network": [
      {
        "network-id": "example:underlay-topology-400g",
        "network-types": {
          "ietf-network-inventory-topology:inventory-topology": {}
        },
        "node": [
          {
            "node-id": "example:n1",
            "ietf-network-topology:termination-point": [
              {
                "tp-id": "example:400g-1/0/1",
                "ietf-network-inventory-topology:inventory-mapping-\
                                                       attributes": {
                  "ne-ref": "example:NE-1",
                  "port-ref": "example:port-1"
                },
                "ietf-network-inventory-topology:port-breakout": {
                  "breakout-channel": [
                    {
                      "channel-id": 1
                    },
                    {
                      "channel-id": 2
                    },
                    {
                      "channel-id": 3
                    },
                    {
                      "channel-id": 4
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    ]
  }
}
]]></sourcecode>
    </section>
    <section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>The authors wish to thank Italo Busi, Olga Havel, Aihua Guo, Oscar
   Gonzalez de Dios, and many others for their helpful comments and
   suggestions.</t>
      <t>Thanks to Olga Havel for the detailed shepherd review.</t>
    </section>
    <section anchor="contributors" numbered="false" toc="include" removeInRFC="false">
      <name>Contributors</name>
      <contact fullname="Chaode Yu">
        <organization>Huawei</organization>
        <address>
          <email>yuchaode@huawei.com</email>
        </address>
      </contact>
    </section>
  </back>
  <!-- ##markdown-source:
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
4Kxt4trmzkK1kCuYPqGOKPJmEvwfZgJKTASCAAA=

-->

</rfc>
