Swarm API参考   集群API列表  扩容集群

增加集群中节点的数量。

请求信息


请求行 RequestLinePUT /clusters/{cluster_id} HTTP/1.1
请求行参数 URI Param

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述cluster_idstring是集群 ID
特有请求头 RequestHead
无，请参考 公共请求头部。
请求体 RequestBody
{
    "password": "ECS实例root登录密码",
    "instance_type": "实例规格",
    "size": "扩容到节点数",
    "data_disk_category": "系统盘类型",
    "data_disk_size": "系统盘大小",
    "ecs_image_id": "操作系统镜像",
    "io_optimized": "是否IO优化",
    "release_eip_flag": "是否需要在集群配置完成后释放EIP"
}
请求体解析 [tr=rgb(51, 205, 229)][td]名称 类型是否必须描述passwordString是ECS 实例密码。instance_typeString是ECS 规格类型代码。更多详细信息，参见 实例规格族。sizeint是节点的总数量，要大于现有节点数量。data_disk_categoryString否
ECS 使用的磁盘类型。更多详细信息，参见 磁盘种类表。data_disk_sizeNumber否节点共享磁盘大小（单位：GB）。ecs_image_idString是ECS 使用的系统镜像 ID。io_optimizedString否根据 ECS 实例规则来确定。取值为 none 或者 optimized。release_eip_flagbool可选配置完集群后是否释放 EIP，默认为 false。
ecs_image_id 列表
请参考文档 查看镜像列表 获取 ecs_image_id 列表。如果您需要自定义集群的 ECS 镜像的 ID，需要保证 ECS 镜像满足以下条件：

• 操作系统：Ubuntu、Centos。
• Linux Kernel version ≥ 3.18，用于支持 overlayfs 以及 overlay network。
• 镜像中删除 /etc/docker/key.json 文件。

返回信息


返回行 ResponseLineHT TP/1.1 200 OK
特有返回头 ResponseHead
无，请参考 公共返回头部。
返回体 ResponseBody{"cluster_id": "string","request_id": "string","task_id": "string"}

示例


请求示例
PUT /clusters/Cccfd68c474454665ace07efce924f75f HTTP/1.1
<公共请求头>
{
  "password": "password",
  "instance_type": "ecs.s3.large",
  "size": 2,
  "data_disk_category": "cloud_ssd",
  "data_disk_size": 500,
  "ecs_image_id": "centos_7_2_64_40G_base_20170222.vhd",
  "io_optimized":"optimized",
  "release_eip_flag": false,
}


返回示例
HTTP/1.1 202 Accepted
<公共响应头>
{
    "cluster_id": "cb95aa626a47740afbf6aa099b650d7ce",
    "request_id": "687C5BAA-D103-4993-884B-C35E4314A1E1",
    "task_id": "T-5a54309c80282e39ea00002f"
}