4.8.4. “filter
”查询参数
“filter
”查询参数用于指示所有可能的事件的哪个子集感兴趣。如果不存在,所有不被其他参数排除的事件将被发送。
此参数仅适用于事件流资源上的GET
方法。如果用于其他方法或资源类型,则返回“400 Bad Request
”状态行。
此参数的格式是XPath 1.0
表达式[XPath],并在以下上下文中进行评估:
名称空间声明集是所有支持的
YANG
模块的前缀和名称空间对的集合,前缀是YANG
模块名称,命名空间是由YANG
模块中的“namespace
”语句定义的。函数库是
XPath 1.0
中定义的核心函数库,以及数据模型定义的所有函数。变量绑定的集合是空的。
上下文节点是根节点。
“filter
”查询参数按照[RFC5277]的第3.6节的定义使用。如果将表达式的布尔结果应用于概念性“notification
”文档根目录时为“true
”,则将事件通知传递给客户端。
如果在第9.3节中定义的“capability
”叶子列表中列出了“filter
”查询参数URI,则服务器支持“filter
”查询参数。