交换引用数据视图 API

编辑

交换引用数据视图 API编辑

交换已保存对象的引用

误用可能会破坏大量已保存的对象!建议使用备份进行练习。

有关最新的 API 详细信息,请参阅开放 API 规范

请求编辑

POST <kibana 主机>:<端口>/api/data_views/swap_references

POST <kibana 主机>:<端口>/s/<空间 ID>/api/data_views/swap_references

请求正文编辑

fromId
(必填,字符串)要更改的已保存对象引用。
toId
(必填,字符串)用于替换旧值的新的已保存对象引用值。
delete
(可选,布尔值)如果删除了所有引用,则删除引用的已保存对象。
fromType
(可选,字符串)指定要更改的已保存对象引用的类型。默认值为数据视图的 index-pattern
forId
(可选,字符串或字符串数组)通过 ID 将受影响的已保存对象限制为一个或多个。
forType
(可选,字符串)按类型限制受影响的已保存对象。

响应代码编辑

200
表示调用成功。

示例编辑

将对数据视图 ID“abcd-efg”的引用替换为“xyz-123”

$ curl -X api/data_views/swap_references
{
     "fromId" : "abcd-efg",
     "toId" : "xyz-123",
     "delete" : true // optional, removes data view which is no longer referenced
}

API 返回受影响的已保存对象列表

{
  result: [{ id: "123", type: "visualization" }],
  deleteStatus: {
    remainingRefs: 0,
    deletePerformed: true
  }
}