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 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: WG List: "; 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 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, . 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]