文档首页/ 云搜索服务 CSS/ API参考/ Logstash接口/ 热启动pipeline迁移数据
更新时间:2024-10-17 GMT+08:00

热启动pipeline迁移数据

功能介绍

该接口用于热启动pipeline迁移数据。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/lgsconf/hot-start

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目ID和名称

cluster_id

String

指定待操作的集群ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

String

配置文件名称。

keep_alive

Boolean

热启动操作时,需要与集群已存在管道的 “是否保持常驻”值保持一致。

  • true: 开启保持常驻。

  • false: 关闭保持常驻。

    开启“保持常驻”适用于需要长期运行的业务。开启“保持常驻”以后,将会在每个节点上面配置一个守护进程,当logstash服务出现故障的时候,会主动拉起并修复。“保持常驻”不适用于短期运行的业务,因为多次主动拉起logstash服务会导致数据迁移重复。

响应参数

请求示例

POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/lgsconf/hot-start

{
  "keep_alive" : false,
  "name" : "confName1"
}

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

409

服务器在完成请求时发生冲突。

返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。

412

未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码