全部产品
Search
文档中心

容器服务 Kubernetes 版 ACK:添加已有ECS实例

更新时间:Aug 31, 2026

将已有ECS(Elastic Compute Service,云服务器)实例添加到ACK集群。

完整API参考信息,请参见添加已有节点到节点池。

请求语法

aliyun cs POST /clusters/<YOUR-CLUSTER-ID>/attach --header "Content-Type=application/json" --body "$(cat attach.json)"

请求参数

CLI参数

参数

说明

--header

请求头。需指定Content-Type为application/json。

--body

请求体,为JSON格式。将请求体内容保存为本地文件(例如attach.json),并通过$(cat attach.json)传入。

请求体

参数

说明

instances

要添加到集群的ECS实例ID。

password

ECS实例的登录密码。

key_pair

用于登录ECS实例的密钥对。

format_disk

是否格式化ECS实例上的数据盘。

tags

要添加到节点的标签,数组格式。

attach.json示例

{
    "instances": "<YOUR-INSTANCE-IDS>",
    "password": "<YOUR-INSTANCE-PASSWORD>",
    "key_pair": "<YOUR-KEY-PAIR-NAME>",
    "format_disk": "<true|false>",
    "tags": []
}

返回参数

字段

说明

list

每个ECS实例的添加结果。每项包含code、instanceId和message。

list.code

添加结果的状态码。200表示成功。

list.instanceId

ECS实例ID。

list.message

添加操作的结果信息。

task_id

本次操作创建的任务ID。

示例

请求示例

aliyun cs POST /clusters/<YOUR-CLUSTER-ID>/attach --header "Content-Type=application/json" --body "$(cat attach.json)"

返回示例

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