Network Working Group                                             J. Li
Internet Draft                                             China Mobile
Intended status: Standards Track                                 C. Lin
Expires: April 20, 2026                            New H3C Technologies
                                                       October 20, 2025


              A YANG Data Model for network energy efficiency
              draft-li-green-network-energy-efficiency-yang-00


Abstract

   This document defines the YANG data model for network energy
   efficiency management, used to maintain network energy efficiency
   attributes, including device-level, board-level, and port-level.

Status of this Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at https://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six
   months and may be updated, replaced, or obsoleted by other documents
   at any time.  It is inappropriate to use Internet-Drafts as
   reference material or to cite them other than as "work in progress."

   This Internet-Draft will expire on April 20, 2026.

Copyright Notice

   Copyright (c) 2025 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (https://trustee.ietf.org/license-info) in effect on the date of
   publication of this document. Please review these documents
   carefully, as they describe your rights and restrictions with
   respect to this document.  Code Components extracted from this
   document must include Revised BSD License text as described in
   Section 4.e of the Trust Legal Provisions and are provided without
   warranty as described in the Revised BSD License.




li, et al.             Expires April 20, 2026                 [Page 1]

Internet-Draft         A YANG Data Model for GREEN        October 2025
Table of Contents


   1. Introduction...................................................2
   2. Terminology and Notations......................................2
      2.1. Requirements Language.....................................2
      2.2. Terminology...............................................2
      2.3. Tree Diagrams.............................................3
      2.4. YANG Prefixes.............................................3
   3. Network Energy Efficiency Tree Diagram.........................3
   4. YANG Data Model for Network Energy Efficiency..................4
   5. IANA Considerations............................................9
   6. References.....................................................9
      6.1. Normative References......................................9
      6.2. Informative References...................................10
   Authors' Addresses...............................................11

1. Introduction

   This document defines the YANG data model for network energy
   efficiency management, used to maintain network energy efficiency
   attributes, including device-level, board-level, and port-level.

   The network model augments the "ietf-network" module [RFC8345].

   This document defines energy efficiency based on energy consumption
   per unit of traffic, rather than simply advertising the power
   consumed by each unit.

2. Terminology and Notations

2.1. Requirements Language

   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 [RFC2119] [RFC8174] when, and only when, they appear in all
   capitals, as shown here.

2.2. Terminology

    The following terms are defined in [RFC7950] and are not redefined
    here:

    *  server

    *  augment

    *  data model


Li, et al.             Expires April 20, 2026                 [Page 2]

Internet-Draft         A YANG Data Model for GREEN        October 2025
    *  data node

    The following terms are defined in [RFC6241] and are not redefined
    here:

    *  configuration data

    *  state data

    The following terms are defined in [RFC8342] and are not redefined
    here:

    *  applied configuration

    Also, the document makes use of the following terms:

    Device:

    Card:

    port:

2.3. Tree Diagrams

    The meanings of the symbols in the YANG tree diagrams are defined in
    [RFC8340].

2.4. YANG Prefixes

     +========+========================+========================+
     | Prefix | YANG Module            | Reference              |
     +========+========================+========================+
     | ianahw | iana-hardware          | [IANA_YANG]            |
     +--------+------------------------+------------------------+
     | ni     | ietf-network-inventory | [ietf-ivy-network-     |
     |        |                        |  inventory-yang]       |
     +--------+------------------------+------------------------+
                Table 1: Prefixes and corresponding YANG modules



3. Network Energy Efficiency Tree Diagram

   The structure of the Network Energy Efficiency Model is depicted in
   Figure 1.






Li, et al.             Expires April 20, 2026                 [Page 3]

Internet-Draft         A YANG Data Model for GREEN        October 2025
   module: ietf-network (RFC 8345)
     +--rw networks
       +--rw network* [network-id]
         +--rw network-id            network-id
         +--rw network-types
         +--rw supporting-network* [network-ref]
         |  +--rw network-ref    -> /networks/network/network-id
         |  +--rw node* [node-id]
         |
         |
   module: ietf-network-energy-efficiency (This Document)
     augment /nw:networks/nw:network/nw:node:
         +--ro component* [name]
           +--ro name              string
           +--ro class             identityref
           +-- green-energy-efficiency*
             +-- ro type?          green-type(avg/max/real-time)
             +-- ro value?         decimal64
             +-- ro timestamp?     yang:date-and-time
             +-- ro update-period? uint32
            Figure 2: Network Energy Efficiency tree diagram


4. YANG Data Model for Network Energy Efficiency

   <CODE BEGINS> file "ietf-network-energy-efficiency@2025-10-20.yang"

   module ietf-network-energy-efficiency {

     yang-version 1.1;

     namespace "urn:ietf:params:xml:ns:yang:ietf-network-energy-
   efficiency";

     prefix ntw-eff;



     import ietf-network {

       prefix nw;

       reference

         "RFC 8345: A YANG Data Model for Network Topologies";

     }

     import ietf-yang-types {


Li, et al.             Expires April 20, 2026                 [Page 4]

Internet-Draft         A YANG Data Model for GREEN        October 2025
       prefix yang;

       reference

         "RFC 6991: Common YANG Types";

     }

     import iana-hardware {

       prefix ianahw;

       reference

         "https://www.iana.org/assignments/iana-hardware/iana-
   hardware.xhtml";

     }



     organization "IETF NETMOD Working Group";

     contact

       "WG Web:   <https://datatracker.ietf.org/wg/netmod/>

        WG List:  <mailto:netmod@ietf.org>";



     description

       "This module augments the ietf-network model to add power

        consumption monitoring capabilities for hardware components.

        Copyright (c) 2025 IETF Trust and the persons identified as

        authors of the code. All rights reserved.";



     revision 2025-10-20 {

       description

         "Initial revision.";

       reference

Li, et al.             Expires April 20, 2026                 [Page 5]

Internet-Draft         A YANG Data Model for GREEN        October 2025
         "RFC XXXX: Power Consumption Extension for Hardware
   Management";

     }



     feature energy-efficiency {

       description

         "Indicates support for energy efficiency monitoring features";

     }



     // ========== Type Definitions ==========

     identity green-type {

       description "Base identity for energy-efficiency types";

     }



     identity average {

       base green-type;

       description "Average energy-efficiency over time";

     }



     identity maximum {

       base green-type;

       description "Maximum energy-efficiency observed";

     }



     identity real-time {

       base green-type;

Li, et al.             Expires April 20, 2026                 [Page 6]

Internet-Draft         A YANG Data Model for GREEN        October 2025
       description "Real-time energy-efficiency reading";

     }



     grouping green-energy-efficiency {

       description "Energy Efficiency attributes";



       leaf value {

         type decimal64 {

           fraction-digits 4;

         }

         units "watts/GB";

         mandatory true;

         description "Energy Efficiency value";

       }



       leaf timestamp {

         type yang:date-and-time;

         description "Time when measurement was taken";

       }



       leaf update-period {

         type uint32;

         units "seconds";

         description

           "For maximum and real-time values, it indicates the minimum
   refresh time when there is a change; if the value remains unchanged,

Li, et al.             Expires April 20, 2026                 [Page 7]

Internet-Draft         A YANG Data Model for GREEN        October 2025
   no refresh occurs. For the average, it represents the sampling
   window.";

       }

     } // End of green-energy-efficiency grouping



     // ========== Main Augmentation ==========

     augment "/nw:networks/nw:network/nw:node" {

       if-feature energy-efficiency;

       description

         "Add green consumption to network components";



       list component {

         key name;

         config false;

         description

           "List of components.";



         leaf name {

           type string;

           description

             "The name assigned to this component.

              This name is not required to be the same as

              entPhysicalName.";

         }



         leaf class {

Li, et al.             Expires April 20, 2026                 [Page 8]

Internet-Draft         A YANG Data Model for GREEN        October 2025
           type identityref {

             base ianahw:hardware-class;

           }

           mandatory true;

           description

             "An indication of the general hardware type of the

              component.";

           reference

             "RFC 6933: Entity MIB (Version 4) - entPhysicalClass";

         }



         uses green-energy-efficiency;

       } // End of component list

     } // End of augment

   } // End of module

   <CODE ENDS>

                     Figure 3: Network Energy Efficiency YANG module



5. IANA Considerations

   TBD.
6. References

6.1. Normative References

   [RFC8348] A. Bierman, YumaWorks, M. Bjorklund, Tail-f Systems, J.
             Dong, Huawei Technologies, D. Romascanu, "A YANG Data
             Model for Hardware Management", RFC 8348, DOI
             10.17487/RFC8348,  March 2018, <https://www.rfc-
             editor.org/info/rfc8348>.



Li, et al.             Expires April 20, 2026                 [Page 9]

Internet-Draft         A YANG Data Model for GREEN        October 2025
6.2. Informative References

   TBD.














































Li, et al.             Expires April 20, 2026                [Page 10]

Internet-Draft         A YANG Data Model for GREEN        October 2025
Authors' Addresses


   Jinming Li
   China Mobile
   32 Xuanwumen West Street
   Beijing
   Xicheng District, 100053
   China
   Email: lijinming@chinamobile.com

   Changwang Lin
   New H3C Technologies
   Beijing
   China
   Email: linchangwang.04414@h3c.com


































Li, et al.             Expires April 20, 2026                [Page 11]

