重置转换 API

编辑

重置一个转换。

请求

编辑

POST _transform/<transform_id>/_reset

先决条件

编辑
  • 需要 manage_transform 集群权限。此权限包含在 transform_admin 内置角色中。

描述

编辑

在重置转换之前,您必须停止它;或者,使用 force 查询参数。

如果重置转换,所有检查点、状态和目标索引(如果由转换创建)都将被删除。转换将更新为最新格式,就像使用了更新转换 API 一样。转换可以像刚创建时一样再次启动。

路径参数

编辑
<transform_id>
(必需,字符串)转换的标识符。

查询参数

编辑
force
(可选,布尔值)如果此值为 true,则无论其当前状态如何,都将重置转换。如果为 false,则转换必须 stopped 才能重置。默认值为 false
timeout
(可选,时间)等待响应的时间段。如果在超时到期之前未收到响应,则请求将失败并返回错误。默认为 30s

示例

编辑
resp = client.transform.reset_transform(
    transform_id="ecommerce_transform",
)
print(resp)
response = client.transform.reset_transform(
  transform_id: 'ecommerce_transform'
)
puts response
const response = await client.transform.resetTransform({
  transform_id: "ecommerce_transform",
});
console.log(response);
POST _transform/ecommerce_transform/_reset

当转换被重置时,您将收到以下结果

{
  "acknowledged" : true
}