yumaworks-restconf

This module contains abstract object definitions for the RESTCONF protocol.

  • Version: 2024-06-18

    yumaworks-restconf@2024-06-18


    
      module yumaworks-restconf {
    
        yang-version 1;
    
        namespace
          "urn:ietf:params:xml:ns:yang:yumaworks-restconf";
    
        prefix yrc;
    
        import ietf-yang-types {
          prefix yang;
        }
        import ietf-restconf {
          prefix rc;
        }
        import yang-data-ext {
          prefix yd;
        }
    
        organization "YumaWorks, Inc.";
    
        contact
          "Support <support@yumaworks.com>";
    
        description
          "This module contains abstract object definitions for
    the RESTCONF protocol.";
    
        revision "2024-06-18" {
          description
            "Change type of leaf 'depth' from uint32 to uint16";
        }
    
        revision "2024-02-15" {
          description
            "Add 'streams' leaf to restconf struct augment";
        }
    
        revision "2023-10-31" {
          description
            "Add RESTCONF Extensions to Support NMDA";
        }
    
        revision "2017-07-03" {
          description
            "Convert plain augment to augment-yang-data";
        }
    
        revision "2017-03-29" {
          description
            "Update text to use restconf by reference.";
        }
    
        revision "2015-12-03" {
          description
            "Move restconf grouping back to ietf-restconf and
    augment it with 2 leafs.";
        }
    
        revision "2015-07-29" {
          description "Initial version";
        }
    
        yd:augment-yang-data "/rc:restconf";
    
        augment /rc:restconf {
          leaf stream {
            type empty;
            description
              "Used for the event-streams. (legacy)
    
    This is the legacy RESTCONF stream that is really
    the NETCONF stream.  Use the 'restconf/streams/NETCONF'
    URI instead of 'restconf/stream'.";
          }
    
          leaf streams {
            type empty;
            description
              "Used for the event-streams. (current).
    
    This is the current RESTCONF streams root that expects
    the stream name to follow in the URI.
    Read the 'restconf/data//restconf/streams' subtree
    for info on the available RESTCONF event streams.
    
    Introduced: 23.10-6
    ";
          }
    
          leaf yang {
            type empty;
            description
              "Used for the schema retriaval";
          }
    
          leaf ds {
            type empty;
            description
              "Used for the NMDA support";
          }
        }
    
        grouping content-parameter {
          leaf content {
            type enumeration {
              enum "config" {
                value 0;
                description
                  "Return only configuration descendant data nodes";
              }
              enum "nonconfig" {
                value 1;
                description
                  "Return only non-configuration descendant data nodes";
              }
              enum "all" {
                value 2;
                description
                  "Return all descendant data nodes";
              }
            }
            description
              "The content parameter from RESTCONF.";
            reference
              "RFC 8040";
    
          }
        }  // grouping content-parameter
    
        grouping depth-parameter {
          description
            "IETF RESTCONF depth parameter";
          leaf depth {
            type union {
              type enumeration {
                enum "unbounded" {
                  value 0;
                  description
                    "All sub-resources will be returned.";
                }
              }
              type uint16 {
                range "1..max";
              }
            }
            default "unbounded";
            description
              "The 'depth' parameter from RESTCONF";
            reference
              "RFC 8040.";
    
          }
        }  // grouping depth-parameter
    
        grouping query-parameters {
          description
            "Contains conceptual definitions for the query string
    parameters used in the RESTCONF protocol.";
          uses content-parameter;
    
          uses depth-parameter;
    
          leaf filter {
            type yang:xpath1.0;
            description
              "The 'filter' parameter from RESTCONF.";
            reference
              "RFC 8040.";
    
          }
    
          leaf insert {
            type enumeration {
              enum "first" {
                value 0;
                description
                  "Insert the new data as the new first entry.";
              }
              enum "last" {
                value 1;
                description
                  "Insert the new data as the new last entry.";
              }
              enum "before" {
                value 2;
                description
                  "Insert the new data before the insertion point,
    specified by the value of the 'point' parameter.";
              }
              enum "after" {
                value 3;
                description
                  "Insert the new data after the insertion point,
    specified by the value of the 'point' parameter.";
              }
            }
            default "last";
            description
              "The 'insert' parameter from RESTCONF";
            reference
              "RFC 8040";
    
          }
    
          leaf point {
            type string;
            description
              "The 'point' parameter from RESTCONF.";
            reference
              "RFC 8040";
    
          }
    
          leaf start-time {
            type yang:date-and-time;
            description
              "The 'start-time' parameter from RESTCONF";
            reference
              "RFC 8040";
    
          }
    
          leaf stop-time {
            type yang:date-and-time;
            description
              "The 'stop-time' parameter from RESTCONF";
            reference
              "RFC 8040";
    
          }
    
          leaf with-origin {
            type empty;
            description
              "The with-origin parameter from RESTCONF Extensions to Support NMDA.";
            reference
              "RFC 8527";
    
          }
        }  // grouping query-parameters
      }  // module yumaworks-restconf
    

© 2023 YumaWorks, Inc. All rights reserved.