文档首页/云数据迁移 CDM/API参考/API/集群管理/停止集群（待下线） - StopCluster
更新时间：2025-11-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

停止集群（待下线） - StopCluster

功能介绍

停止集群接口。

调用方法

请参见如何调用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参数

参数

是否必选

参数类型

描述

stop

是

stop object

集群停止操作，定义集群停止标识，请参见stop参数说明。

表4 stop

参数

是否必选

参数类型

描述

stopMode

是

String

关机类型：

  • IMMEDIATELY：立即关机。

  • GRACEFULLY：优雅关机。

delayTime

否

Integer

关机时延，仅在stopMode为“GRACEFULLY”生效，单位：秒。该值为-1时，表示等待所有作业完成，并停止接受新作业。该值为大于0的任意值表示等待该时长后关机，并停止接受新作业。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

jobId

Array of strings

作业ID。

请求示例

停止集群

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

{
  "stop" : {
    "stopMode" : "GRACEFULLY",
    "delayTime" : -1
  }
}

响应示例

状态码：200

OK。

{
  "jobId" : [ "ff8080815e59d92d015e5b27ccb0004d" ]
}

状态码

状态码

描述

200

OK。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

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

503

服务不可用。

错误码

请参见错误码。

父主题：集群管理