4.8.9. “with-defaults”查询参数

with-defaults”查询参数用于指定如何响应数据资源的GET请求返回关于默认数据节点的信息。

如果服务器支持这种能力,那么它必须实现RFC6243第4.5.1节中描述的行为,除了应用于RESTCONF GET操作而不是NETCONF操作。

说明
report-all 所有数据节点都被报告
trim 设置为YANG默认的数据节点不会被报告
explicit 报告客户端设置为YANG默认的数据节点
report-all-tagged 所有的数据节点都被报告,并且默认值被标记

如果“with-defaults”参数设置为“report-all”,那么服务器必须遵守[RFC6243]的第3.1节中定义的默认报告行为。

如果“with-defaults”参数设置为“trim”,那么服务器必须遵守[RFC6243]的第3.2节中定义的默认报告行为。

如果“with-defaults”参数设置为“explicit”,那么服务器必须遵守[RFC6243]的[第3.3节()]中定义的默认报告行为。

如果“with-defaults”参数设置为“report-all-tagged”,则服务器必须遵守[RFC6243]的第3.4节中定义的默认报告行为。元数据由服务器按照5.3节的规定报告。服务器为默认节点发送的“default”属性的XML编码在[RFC6243]的第6节中定义。 “default”属性的JSON编码必须使用[RFC6243]中定义的相同值,但是按照[RFC7952]中的规则进行编码。必须使用模块名称“ietf-netconf-with-defaults”作为“default”属性。

如果“with-defaults”参数不存在,那么服务器必须遵守9.1.2节定义的“default”协议能力URI的“basic-mode”参数中定义的默认报告行为。

如果服务器在9.3节定义的“capability”叶子列表中包含“with-defaults”查询参数URI,则必须支持“with-defaults”查询参数。

由于服务器没有按照[RFC6243]的第4.3节所述报告“also-supported”的参数,因此可能不支持“with-defaults”参数的某些值。如果服务器不支持“with-defaults”参数的请求值,则服务器务必返回一个带有“400 Bad Request”状态行的响应。在这种情况下使用错误标签值“invalid-value”。