调用 ScaleOutCluster 增加集群中 Worker 节点的数量(支持多可用区实例)。

请求信息

请求行 RequestLine

POST /api/v2/clusters/{cluster_id} HTTP/1.1
表 1. 请求行参数 URI Param
名称 类型 是否必须 描述
cluster_id string 集群 ID。

特有请求头 RequestHead。

无,请参考公共请求头部

请求体 RequestBody。

{
"key_pair":"keypair名称,和login_password 二选一",
"vswitch_ids": "一台或多台虚拟交换机 ID,N 的取值范围为 [1,3]",
"worker_instance_types": "Worker实例规格多实例规格参数",
"worker_system_disk_category": "Worker系统盘类型",
"worker_system_disk_size": "Worker节点系统盘大小",
"worker_data_disk":"是否挂载数据盘 true|false",
"tags": "给集群打tag标签, 数组格式对象",
"count":"扩容的数量",
"worker_data_disks": "Worker节点数据盘配置"
}
表 2. 请求体解释
名称 类型 必须 描述
count int 扩容数量。
vswitch_ids list Worker 节点的交换机 ID。
worker_data_disk bool 是否挂载数据盘,可选择为:
  • true:表示 worker 节点挂载数据盘。
  • false:表示 worker 节点不挂载数据盘。
worker_instance_types list Worker 节点 ECS 规格类型代码。更多详细信息,参见实例规格族
key_pair string keypair 名称。与 login_password 二选一。
login_password string 扩容的 worker 节点密码。密码规则为8 - 30 个字符,且同时包含三项(大小写字母、数字和特殊符号),和 key_pair 二选一。
worker_data_disks list Worker 数据盘类型、大小等配置的组合。该参数只有在挂载 Worker 节点数据盘时有效,包含以下参数:
  • category:数据盘类型。取值范围如下。
    • cloud:普通云盘。
    • cloud_efficiency:高效云盘。
    • cloud_ssd:SSD 云盘。
  • size:数据盘大小,单位为GiB。
worker_system_disk_category string Worker 节点系统盘类型。
worker_system_disk_size int Worker节点系统盘大小,单位为 GiB。

返回信息

返回行 ResponseLine

HTTP/1.1 202 Accepted

特有返回头 ResponseHead

无,请参考公共返回头部

返回体 ResponseBody

{
    "cluster_id":"string",
    "request_id":"string",
    "task_id":"string",
    "instanceId":"string"
}

示例

请求示例

POST /api/v2/clusters/Cccfd68c474454665ace07efce924**** HTTP/1.1
<公共请求头>
{
    "key_pair":"common", // KeyPair 
    "vswitch_ids":["vsw-uf684tfrpwup8gcsw****"],
    "worker_instance_types":["ecs.c5.xlarge"],
    "worker_system_disk_category":"cloud_efficiency",
    "worker_system_disk_size":120,
    "worker_data_disk":false,
    "worker_data_disks": [{"category": "cloud_ssd", "size": 500}],
    "tags":[],
    "count":1
}

返回示例

HTTP/1.1 202 Accepted
<公共响应头>
{
    "cluster_id": "Cccfd68c474454665ace07efce924****",
    "request_id": "687C5BAA-D103-4993-884B-C35E4314A1E1",
    "task_id": "T-5a54309c80282e39ea00002f",
    "instanceId":"Cccfd68c474454665ace07efce924****"
}