更新时间:2023-06-15 GMT+08:00

停止集群

功能介绍

停止集群接口。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

cluster_id

String

集群ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

表3 请求Body参数

参数

是否必选

参数类型

描述

stop

stop object

集群启动操作,定义集群启动标识,为空对象

表4 stop

参数

是否必选

参数类型

描述

stopMode

String

关机类型:

  • IMMEDIATELY:立即关机。

  • GRACEFULLY:优雅关机。

枚举值:

  • 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

服务不可用

错误码

请参见错误码