在指定集群下添加已有的云服务器（ECS）实例。

使用说明

• 调用该接口前，请确保已创建节点池（默认节点池或自定义节点池）且节点池状态必须处于 {Running, [*]}，否则无法调用该接口添加已有节点。
  • 默认节点池：调用 CreateDefaultNodePool 接口创建默认节点池（vke-default-nodepool），或者通过控制台在 添加已有节点 时创建默认节点池。
  • 自定义节点池：调用 CreateNodePool 接口创建自定义节点池，或者通过控制台 创建节点池。

    注意

    • 仅满足如下条件的自定义节点池，支持添加 ECS 实例：
      • 节点池未开启 弹性伸缩 开关。
      • 当前节点池计费模式为 按量计费 或 包年包月。
    • 仅满足如下条件的 ECS 实例，支持被添加到自定义节点池：
      • 属于当前集群相同的私有网络（VPC）。
      • 与目标节点池所属的项目（Project）一致。
      • 实例未加入任何集群或弹性伸缩（Auto Scaling）服务的伸缩组。
      • 实例仅有一张网卡，已绑定多张网卡的 ECS 实例不支持被添加。
      • 实例系统盘需满足：容量 > （目标节点池配置的镜像大小+ 10 GiB）。
      • 实例数据盘必须包含目标节点池指定了挂载的数据盘，且盘类型和大小完全一致。
• 调用该接口前，请先调用 ListSupportedResourceTypes 接口，确认创建节点时需要用到的资源是否在指定的地域和可用区中支持。
• 此接口为异步接口，当此接口返回成功时，会返回节点的 ID 信息，此时节点将进入{Creating, [Progressing]}状态，直到创建执行成功{Running, [Ok]}。请调用 ListNodes 接口获取该节点当前的状态，查看节点是否创建成功。
• 添加 弹性裸金属型 节点后，下线此类节点时，ECS 侧会根据运行状态优先正常关机，如无法正常关机，将执行强制关机。更多信息，请参见 StopInstance。

请求说明

• 请求方式：POST
• 请求地址：https://open.volcengineapi.com/?Action=CreateNodes&Version=2022-05-12

请求参数

调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见 公共参数。

请求示例

POST /?Action=CreateNodes&Version=2022-05-12 HTTP/1.1
Content-Type:application/json
{
    "ClusterId": "cc5silumrsfeq****",
    "InstanceIds": [
        "i-ybo9229pdf****"
    ],
    "KeepInstanceName": false,
    "AdditionalContainerStorageEnabled": false,
    "ClientToken": "ed6b1190-dc17-11ec-9519-eb58a7******"
}

返回参数

本接口返回参数如下表所示，公共返回参数请参见 返回结果。

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "021635330810134****",
        "Action": "CreateNodes",
        "Version": "2022-05-12",
        "Service": "vke",
        "Region": "cn-beijing"
    },
    "Result": {
        "Ids": [
            "nc5t5epmrsf****"
        ]
    }
}

错误码

本接口错误码如下表所示，公共错误码请参见 公共错误码。