旧版 URL 别名
编辑旧版 URL 别名
编辑此页面描述了旧版 URL 别名:它们是什么、来自哪里以及如何禁用它们。
概述
编辑许多保存的对象类型在 Kibana 8.0 中进行了转换,因此它们最终可以在空间之间共享。在 8.0 之前,您可以在两个不同的空间中拥有两个具有相同类型和相同 ID 的对象。此转换的一部分是确保给定类型的所有对象 ID 在所有空间中都是全局唯一的。
Kibana 为每个需要新 ID 的保存对象创建一个名为旧版 URL 别名的特殊实体。此旧版 URL 别名允许 Kibana 保留这些对象存在的任何深层链接 URL。
示例
编辑考虑以下场景
您拥有 Kibana 7.16,并且您创建了一个新的仪表板。此仪表板的 ID 为“123”。您创建一个名为“Bill 的空间”的新空间,并且复制您的仪表板到另一个空间。现在您有两个不同的仪表板,可以通过以下 URL 访问
-
默认空间:
https://127.0.0.1:5601/app/dashboards#/view/123
-
Bill 的空间:
https://127.0.0.1:5601/s/bills-space/app/dashboards#/view/123
您经常使用这两个仪表板,因此您将它们添加到您的 Web 浏览器中的书签。一段时间后,您决定升级到 Kibana 8.0。当这两个仪表板经过转换过程时,“Bill 的空间”中的仪表板的 ID 将更改为“456”。访问该仪表板的 URL 是不同的 — 但不用担心,该仪表板有一个旧版 URL 别名。
如果您使用书签通过旧的 URL 访问该仪表板,Kibana 会检测到您正在使用旧版 URL,并找到新的对象 ID。如果您导航到 https://127.0.0.1:5601/s/bills-space/app/dashboards#/view/123
,您将看到一条消息,指示该仪表板有一个新的 URL,并且您会自动重定向到 https://127.0.0.1:5601/s/bills-space/app/dashboards#/view/456
。
处理错误
编辑旧版 URL 别名旨在完全透明,但在极少数情况下,这可能会导致错误。例如,您可能有一个仪表板,并且其中一个可视化加载失败,从而将您定向到此页面。如果您在这种情况下遇到错误,您可能需要完全禁用旧版 URL 别名。这会使保存的对象保持不变,并且您不会丢失任何数据 — 您只是无法使用旧的 URL 访问该保存的对象。
要禁用旧版 URL 别名,您需要三条信息:targetSpace
、targetType
和 sourceId
。然后使用 _disable_legacy_url_aliases
API 来禁用有问题的旧版 URL 别名。