YANG is a data modeling language developed in the Internet Engineering Task Force. It is used to model configuration and state data manipulated by protocols such as NETCONF and RESTCONF. YANG enables easier management of network elements, such as routers, and is widely used and deployed by many network equipment vendors and network operators.
The YANG Catalog allows users to find models relevant to their use cases from the large and growing number of YANG modules being published. The YANG Catalog includes modules from various companies and organizations, including standards organizations such as the IETF, the Broadband Forum, the IEEE, the Metro Ethernet Forum, including some equipment vendors, as well as open source communities such as the Open Daylight Project.
Web Access
The YANG Catalog website provides links to:
- A NETCONF and REST (not RESTCONF-compliant yet) server loaded with the YANG module from draft-clacla-netmod-model-catalog. It currently only allows public read access to
the content. Feel free to reach out through the github forum if you are interested in write access. The username is
oper
and the password isoper
. - A YANG Validator: a web frontend that allows for validation of YANG modules and IETF Internet-Drafts
- A YANG Search: a web frontend that allows for searches of the content of the YANG Catalog
- A YANG Impact Analysis: a tool which graphs the dependencies across individual YANG modules
- YANG Module Detail Viewer: a web frontend which displays the detailed metadata of any particular module
- A YANG Regex Validator: a YANG regular expression validator which enables experimentation with W3C YANG "pattern" statements
API Accesss
The YANG Catalog includes a NETCONF and REST (not RESTCONF-compliant yet) server loaded with the YANG module from draft-clacla-netmod-model-catalog with public read access to the content. The username is oper and the password is oper. For write access, please submit a request via this form.
For access to the YANG Catalog’s REST interface using curl, use the following to receive the content of the organization’s subtree from the yang-catalog.yang module. (Note, the currently supported revision yang-catalog.yang is 2017-09-26)
$ curl https://yangcatalog.org/api/search/catalog
This will return JSON-formatted data. NOTE: the catalog is quite large and growing all the time. You may also use the following to pull the module metadata:
$ curl https://yangcatalog.org/api/search/modules
The following will provide vendor implementation metadata:
$ curl https://yangcatalog.org/api/search/vendors