/api/tree/collisions

在处理 TSMeta 时,如果生成的叶子将用其他 TSUID 覆盖现有叶子,则将记录冲突。该端点允许检索由于冲突而未包含在树中的 TSUID 的列表。这对于调试很有用,因为如果在此列表中找到 TSUID,则可以将其通过/tree/test端点传递,以获取有关发生冲突的原因的详细信息。

Note

调用此端点而不列出一个或多个 TSUID 的列表将返回树中的所有冲突。如果您的系统中有大量时间序列,则响应可能会非常大。因此,最好将此端点与特定的 TSUID 一起使用。

Note

如果该树可使用storeFailures,则此端点将不返回任何数据。冲突仍将出现在 TSD 的日志中。

Verbs

  • GET

Requests

以下字段用于此端点

NameData TypeRequiredDescriptionDefaultQSRWExample
treeIdIntegerRequired通过 TSMeta 对象传递的树的 ID treeid 1
tsuidsStringRequired用于搜索冲突条目的一个或多个 TSUID 的列表。如果要求测试多个 TSUID,则应以逗号分隔。 tsuids 000001000001000001,00000200000200002

Response

成功的响应将返回键/值对的 Map,其中未记录的 TSUID 作为键,而现有休 PseudoTSUID 作为值。响应将仅返回找到的冲突。如果所请求的一个或多个 TSUID 没有导致冲突,则不会将其与结果一起返回。这可能意味着 TSMeta 尚未处理。请注意,如果没有发生冲突或树尚未处理任何数据,则结果集将为空。如果请求的树在系统中不存在,则将返回404并显示一条错误消息。如果提供了无效数据,将返回400错误。

Example Request

Example Response

{
    "010101": "AAAAAA",
    "020202": "BBBBBB"
}