4.8.7. “start-time”查询参数

start-time”查询参数用于触发[RFC5277]中定义的通知重放功能,并指示重放应在指定的时间开始。如果流不支持按流资源的“stream”列表条目返回的“replay-support”属性进行重播,那么服务器务必返回“400 Bad Request”状态行。

start-time”参数的值是在“ietf-yang-typesYANG模块[RFC6991]中定义的“date-and-time”类型。

此参数仅适用于“text/event-stream”数据资源上的GET方法。如果用于其他方法或资源类型,则返回“400 Bad Request”状态行。

如果此参数不存在,则不会请求重播订阅。指定晚于当前时间的开始时间是无效的。如果指定的值早于日志可以支持的值,则重播将从最早的可用通知开始。根据[RFC7231],客户端可以通过检查服务器在响应消息中返回的“Date”头字段来获取服务器的当前时间。

如果服务器支持这个查询参数,那么“replay”查询参数URI必须列在9.3节定义的“capability”叶子列表中,并且“stop-time”查询参数也必须被服务器支持。

如果“replay-support”叶子在“stream”条目(在9.3节中定义)中的值为“true”,那么服务器必须支持该流的“start-time”和“stop-time”查询参数。