文档首页/数据治理中心 DataArts Studio/更多文档/API参考 (联盟区域) /数据集成API/集群管理/重启集群
更新时间：2026-01-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

重启集群

功能介绍

重启集群接口。

调用方法

请参见如何调用API。

URI

POST /v1.1/{project_id}/clusters/{cluster_id}/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参见项目ID和账号ID。

cluster_id

是

String

集群ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数

参数

是否必选

参数类型

描述

restart

是

restart object

集群重启操作，定义哪些集群节点需要重启，请参见restart参数说明。

表4 restart

参数

是否必选

参数类型

描述

restartDelayTime

否

Integer

重启时延，单位：秒。

restartMode

否

String

重启类型：

  • IMMEDIATELY：立即重启。

  • FORCELY：强制重启。

  • SOFTLY：一般重启。

默认值为“IMMEDIATELY”。强制重启业务进程会中断，并重启集群的虚拟机。

restartLevel

否

String

重启级别：

  • SERVICE：重启服务。

  • VM：重启虚拟机。

默认值为“SERVICE”。

type

是

String

集群节点类型，只支持“cdm”。

instance

否

String

预留字段，“restartLevel” 为“SERVICE”时，“instance”必填，填空字串。

group

否

String

预留字段，“restartLevel” 为“SERVICE”时，“group”必填，填空字串。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

jobId

String

作业ID。

请求示例

重启集群。

POST /v1.1/1551c7f6c808414d8e9f3c514a170f2e/clusters/bae65496-643e-47ca-84af-948672de7eeb/action

{
  "restart" : {
    "instance" : "",
    "type" : "cdm",
    "group" : ""
  }
}

响应示例

状态码：200

OK。

{
  "jobId" : "ff8080815e59d92d015e5b27ccb0004d"
}

状态码

状态码

描述

200

OK。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误，具体返回错误码请参考错误码。

503

服务不可用。

错误码

请参见错误码。

父主题：集群管理