B.3.9. “with-defaults”参数

假设服务器实现[RFC6243]的附录A.1中定义的模块“example”,并且假定服务器的数据存储如[RFC6243]的附录A.2中所定义。

如果服务器的“defaults”协议能力URI第9.1.2节)中的“basic-mode”参数是“trim”,则接口“eth1”的以下请求可能如下所示:

没有查询参数:

GET /restconf/data/example:interfaces/interface=eth1 HTTP/1.1
Host: example.com
Accept: application/yang-data+json

服务器可能会如下回应:

HTTP/1.1 200 OK
Date: Thu, 26 Jan 2017 20:56:30 GMT
Server: example-server
Content-Type: application/yang-data+json

{
  "example:interface" : [
    {
      "name" : "eth1",
      "status" : "up"
    }
  ]
}

请注意,缺少“mtu”叶字节点,因为它被设置为默认“1500”,并且服务器的默认处理“basic-mode”参数是“trim”。

使用查询参数:

GET /restconf/data/example:interfaces/interface=eth1?with-defaults=report-all HTTP/1.1
Host: example.com
Accept: application/yang-data+json

服务器可能会如下回应:

HTTP/1.1 200 OK
Date: Thu, 26 Jan 2017 20:56:30 GMT
Server: example-server
Content-Type: application/yang-data+json

{
  "example:interface" : [
    {
      "name" : "eth1",
      "mtu" : 1500,
      "status" : "up"
    }
  ]
}

请注意,服务器返回“mtu”叶子节点,因为“report-all”使用“with-defaults”查询参数请求模式。

results matching ""

    No results matching ""