B.3.3. “fields”参数

在本例中,客户端正在以JSON格式检索数据存储资源,但仅检索“modules-state/module”列表,并且仅检索每个列表条目中的“name”和“revision”节点。 请注意,服务器返回的顶层节点与目标资源节点(本例中为“data”)匹配。 “module-set-id”叶子没有被返回,因为它没有在fields表达式中被选中。

  1. GET /restconf/data?fields=ietf-yang-library:modules-state/module(name;revision) HTTP/1.1
  2. Host: example.com
  3. Accept: application/yang-data+json

服务器可能会如下回应:

  1. HTTP/1.1 200 OK
  2. Date: Thu, 26 Jan 2017 20:56:30 GMT
  3. Server: example-server
  4. Content-Type: application/yang-data+json
  5. {
  6. "ietf-restconf:data" : {
  7. "ietf-yang-library:modules-state" : {
  8. "module" : [
  9. {
  10. "name" : "example-jukebox",
  11. "revision" : "2016-08-15"
  12. },
  13. {
  14. "name" : "ietf-inet-types",
  15. "revision" : "2013-07-15"
  16. },
  17. {
  18. "name" : "ietf-restconf-monitoring",
  19. "revision" : "2017-01-26"
  20. },
  21. {
  22. "name" : "ietf-yang-library",
  23. "revision" : "2016-06-21"
  24. },
  25. {
  26. "name" : "ietf-yang-types",
  27. "revision" : "2013-07-15"
  28. }
  29. ]
  30. }
  31. }
  32. }