调用ScaleOutCluster增加集群中Worker节点数量。目前只能扩容边缘节点服务(Edge Node Service, ENS)实例。

说明 目前节点的操作均合入节点池,ACK不再维护ScaleOutCluster接口。请通过扩容节点池操作增加集群的Worker节点。具体操作,请参见 扩容节点池

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求语法

POST /api/v2/clusters/ClusterId HTTP/1.1
Content-Type:application/json
{
  "count" : Long,
  "worker_instance_type" : "String",
  "ens_region_id" : "String",
  "worker_image_id" : "String",
  "ens_internet_charge_type": "String",
  "worker_period": Long,
  "login_password": "String",
  "worker_system_disk_size": Long,
  "is_edge_worker": Boolean,
  "worker_data_disk_size": Long,
  "worker_auto_renew": Boolean,
  "worker_auto_renew_period": Long,
  "timeout_mins": Long
}

请求参数

表 1. 请求Path参数
参数名称 类型 是否必选 示例 说明
ClusterId String Cccfd68c474454665ace07efce924****

集群ID。

表 2. 请求Body参数
名称 类型 必须 示例值 描述
count Long 1 扩容ENS实例数量。
worker_instance_type String ens.sn1.tiny ENS实例规格。
ens_region_id String cn-beijing-cmcc-2 ENS地域ID。
worker_image_id String centos_7_06_64_20G_alibase_2019****

节点自定义镜像,默认使用系统镜像。当选择自定义镜像时,将取代默认系统镜像。请参见自定义镜像

ens_Internet_charge_type String BandwidthByDay 计费方式,取值:
  • BandwidthByDay:日峰值带宽。
  • 95BandwidthByMonth:月95峰值带宽。
worker_period Long 1

Worker节点包年包月时长,当worker_instance_charge_type取值为PrePaid时才生效且为必选值。

取值范围:{1, 2, 3, 6, 12, 24, 36, 48, 60}。

默认值:1。

login_password String HelloWorl****

SSH登录密码,和key_pair 二选一。密码规则为8~30个字符,且至少同时包含三项(大小写字母、数字和特殊符号)。

worker_system_disk_size Long 40 系统盘大小,单位为GiB。取值:20~100之间10的倍数,并且要大于OS镜像大小。
is_edge_worker Boolean true 扩容的ENS节点是否作为边缘worker节点。取值:
  • true:作为边缘Worker节点。
  • false:不作为边缘Worker。
该场景下,只允许为true
worker_data_disk_size Long 40 数据盘大小。0表示不需要数据盘,20~200之间的10的倍数。
worker_auto_renew Boolean true 是否要自动续费。取值
  • true:自动续费。
  • false:不自动续费。
默认值:false
worker_auto_renew_period Long 1 每次自动续费的时长,当参数worker_auto_renew取值true时为必填。取值范围:[1,12]。
timeout_mins Long 60 扩容超时时间,单位分钟。

响应体语法

HTTP/1.1 200
Content-Type:application/json
{
  "cluster_id" : "String",
  "request_id" : "String",
  "task_id" : "String"
}

响应参数

表 3. 响应Body参数
名称 类型 示例值 描述
cluster_id String Cccfd68c474454665ace07efce924****

集群ID。

request_id String 687C5BAA-D103-4993-884B-C35E4314A1E1

请求ID。

task_id String T-5a54309c80282e39ea00002f

任务ID。

扩容ACK边缘托管版集群示例

请求示例

POST /api/v2/clusters/Cccfd68c474454665ace07efce924**** 
<公共请求头>
{
  "timeout_mins": 60,
  "worker_instance_type": "ens.sn1.tiny",
  "ens_region_id": "cn-beijing-telecom",
  "worker_image_id": "m-2QVLO2T8NYgm8CNQVg****",  
  "ens_internet_charge_type": "BandwidthByDay",
  "worker_period": 1,
  "worker_auto_renew": true,
  "worker_auto_renew_period": 1,
  "login_password": "Hello1234!",
  "count": 1,
  "worker_system_disk_size": 20,
  "worker_data_disk_size": 0,
  "is_edge_worker": true
}

正常返回示例

XML 格式

<cluster_id>Cccfd68c474454665ace07efce924****</cluster_id>
<task_id>T-5a54309c80282e39ea00002f</task_id>
<request_id>687C5BAA-D103-4993-884B-C35E4314A1E1</request_id>

JSON 格式

{
    "cluster_id": "c82e6987e2961451182edacd74faf****",
    "task_id": "T-5a54309c80282e39ea00002f",
    "request_id": "687C5BAA-D103-4993-884B-C35E4314A1E1"
}

错误码

访问错误中心查看更多错误码。