Capabilities

The HTTP methods are used for manipulating the resource defined in the YANG model for the CRUD operations. You must employ appropriate access control mechanisms to limit what operations can be allowed by a user.

The RESTCONF protocol capability URIs are present in the container "/restconf-state/capabilities" defined in the ietf-restconf-monitoring module. The server must include a "capability" URI leaf-list entry for the "defaults" mode or the optional query parameters used by the server. The server must include a "capability" leaf-list entry for each optional query parameter that it supports. The name and the supported URIs are as follows.

GET /restconf/data/ietf-restconf-monitoring:restconf-state/capabilities  HTTP/1.1
  Host: example.com
  Accept: application/yang.data+xml


HTTP/1.1 200 OK
   Date: Mon, 23 Apr 2012 17:02:00 GMT
   Server: example-server
   Cache-Control: no-cache
   Pragma: no-cache
   Last-Modified: Sun, 22 Apr 2012 01:00:14 GMT
   Content-Type: application/yang.data+xml
 
<capabilities xmlns="urn:ietf:params:xml:ns:yang:ietf-restconf-monitoring">
    <capability>urn:ietf:params:restconf:capability:depth:1.0</capability>
    <capability>urn:ietf:params:restconf:capability:with-defaults:1.0</capability>
    <capability>urn:ietf:params:restconf:capability:defaults:1.0?basic-mode=trim</capability>