调用AttachInstances添加已有实例到集群。

调试

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

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

post /clusters/{ClusterId}/attach http|https

请求参数

名称 类型 是否必选 示例值 描述
ClusterId String c106f377e16f34eb1808d6b9362c9****

集群ID。

body Object

实例列表。

cpu_policy String none

CPU管理策略。

format_disk Boolean false

是否格式化数据盘。

image_id String aliyun_2_1903_x64_20G_alibase_20200529.vhd

自定义镜像ID。

instances Array of String i-2zed0sswuau6o89b****

实例ID。

is_edge_worker Boolean false

是否为边缘节点,即ens节点。

keep_instance_name Boolean true

是否保留主机名。

key_pair String ***

免密登录密钥对名称,和login_password二选一。

nodepool_id String np615c0e0966124216a0412e10afe0****

节点池ID。

password String Hello1234

SSH登录密码,和key_pair二选一。

rds_instances Array of String rds-xxx

RDS实例ID。

runtime Object

容器运行时配置。

name String docker

容器运行时名称。

version String 19.03.5

容器运行时版本。

tags Array

标签配置。

key String k-aa

标签key。

value String v-aa

标签值。

user_data String ***

自定义节点数据。

返回数据

名称 类型 示例值 描述
list Array of list

节点信息列表。

code String "200"

结果状态码。

instanceId String "i-2ze0lgm3y6iylcbt****"

节点实例ID。

message String "successful"

添加结果描述信息。

task_id String "T-5a544aff80282e39ea000039"

任务ID。

示例

请求示例

POST /clusters/[ClusterId]/attach HTTP/1.1
公共请求头
{
    "ClusterId": "c106f377e16f34eb1808d6b9362c9****",
    "instances":[
        "i-wz9e8pvnjalxkggk****"
    ],
    "format_disk":true,
    "image_id":"centos_7_7_x64_20G_alibase_20191225.vhd",
    "rds_instances":[
        "rds1",
        "rds2"
    ],
    "user_data":"ZWNobyAxMjM0NTY=",
    "tags":[
        {
            "key":"foo",
            "value":"bar"
        }
    ],
    "keep_instance_name":true,
    "cpu_policy":"none",
    "runtime":{
        "name":"docker",
        "version":"19.03.5"
    },
    "password":"Hello@1234"
}

正常返回示例

XML 格式

<task_id>T-5a544aff80282e39ea000039</task_id>
<list>
    <code>200</code>
    <instanceId>i-2ze0lgm3y6iylcbt****</instanceId>
    <message>successful</message>
</list>

JSON 格式

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

错误码

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