Swarm API参考  集群API列表  添加已有实例

添加已有实例到集群。

        说明
添加过程中会替换系统盘，需要提前做好数据备份。



请求信息


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

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述cluster_idstring是集群 ID
特有请求头 RequestHead
无，请参考 公共请求头部。
请求体 RequestBody
{
    "password": "ECS实例root登录密码",
    "instances": "要添加的实例数组",
    "ecs_image_id": "操作系统镜像",
    "release_eip_flag": "是否需要在集群配置完成后释放EIP"
}
请求体解析 [tr=rgb(51, 205, 229)][td]名称 类型是否必须描述passwordString是ECS 实例密码。instancesArray是已有实例的数组ecs_image_idString是ECS 使用的系统镜像 ID。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 文件。

返回信息


返回行 ResponseLine
HTTP/1.1 202 OK
{
    "list": [
        {
            "code": "200",
            "instanceId": "i-xxx",
            "message": "successful"
        },
        {
            "code": "200",
            "instanceId": "i-yyy",
            "message": "successful"
        }
    ],
    "task_id": "T-5a544aff80282e39ea000039"
}
特有返回头 ResponseHead
无，请参考 公共返回头部。
返回体 ResponseBody


{
    "list": [
        {
            "code": "200",
            "instanceId": "i-2zee3oiwcyoz7kwdo8bt",
            "message": "successful"
        },
        {
            "code": "200",
            "instanceId": "i-2ze0lgm3y6iylcbtcypf",
            "message": "successful"
        }
    ],
    "task_id": "T-5a544aff80282e39ea000039"
}

示例


请求示例POST /clusters/Cccfd68c474454665ace07efce924f75f /attach HTTP/ 1.1<公共请求头>
返回示例
HTTP/1.1 202 Accepted
<公共响应头>
{
    "list": [
        {
            "code": "200",
            "instanceId": "i-2zee3oiwcyoz7kwdo8bt",
            "message": "successful"
        },
        {
            "code": "200",
            "instanceId": "i-2ze0lgm3y6iylcbtcypf",
            "message": "successful"
        }
    ],
    "task_id": "T-5a544aff80282e39ea000039"
}