scope:

The network management architecture defined in [ITU-T M.3010] introduces the use of multiple management protocols. So far, the guidelines for the definition of managed objects (GDMO) / common management information protocol (CMIP), common object request broker architecture (CORBA) / Internet inter-ORB protocol (IIOP), structure of management information (SMI) / simple network management protocol (SNMP), web services / simple object access protocol (SOAP) are possible choices at the application layer. Based on the management interface specification methodology defined in [ITU-T M.3020], more technology-based paradigms can be introduced into network management interfaces, and REST/HTTP is now an additional paradigm for network management.

This Recommendation sets out a framework for defining how interfaces supported by management systems and network elements should be modelled using JSON/YAML schemas. It is within the scope of this Recommendation to provide the following guidelines or instructions:

- principles for REST interface designs;

- containment, association and inheritance relationship and naming rules for managed entities;

- generic accessing methods for managed objects;

- guidelines for defining accessing methods for specific resources;

- information modelling guidelines for REST-based interfaces;

- common data type definitions.