添加一个或多个已创建的ECS实例作为计算节点，加入到指定集群中。
接口说明
接口说明
-
待添加到集群的节点处于已停止状态。
-
加入集群后，该节点的操作系统会更换为 ImageId 指定的操作系统。
-
节点主机名不能和集群内已有节点的主机名冲突，否则会添加失败。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ehpc:AddExistedNodes |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClusterId |
string |
是 |
该节点待加入的集群 ID。 您可以通过调用 ListClusters 获取集群 ID。 |
ehpc-hz-FYUr32**** |
| ImageId |
string |
是 |
为待加入集群的计算节点指定的镜像，该镜像需满足以下条件：
说明
如果集群为混合云集群，并且开启支持多系统功能，当集群中节点的操作系统为 Windows 时，指定的镜像可以为 Windows、CentOS。
您可以通过调用 ListImages 和 ListCustomImages 接口获取镜像 ID。 |
centos_7_06_64_20G_alibase_20190711.vhd |
| JobQueue |
string |
否 |
该节点要加入的集群中的队列。 |
workq |
| ImageOwnerAlias |
string |
是 |
镜像类型。取值范围：
默认值：system |
system |
| Instance |
array<object> |
是 |
要添加的节点信息。 |
|
|
object |
否 |
节点信息数组。 |
||
| Id |
string |
是 |
第 N 个（N 从 1 开始编号，可以有多条）要添加的节点 ID。取值范围：1~100。 |
i-bp16mxn6mt3t7ftk**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| TaskId |
string |
任务 ID。 |
04F0F334-1335-436C-A1D7-6C044FE7**** |
| RequestId |
string |
请求 ID。 |
04F0F334-1335-436C-A1D7-6C044FE7**** |
示例
正常返回示例
JSON格式
{
"TaskId": "04F0F334-1335-436C-A1D7-6C044FE7****",
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE7****"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParams | The specified parameter %s is invalid. | 指定的参数 %s 无效。 |
| 400 | NotEnabled | You have not enabled this service | 您的账户还未开通此服务 |
| 400 | InDebt | Your account has overdue payments. | 您的账户已欠费 |
| 500 | UnknownError | An unknown error occurred. | 未知错误 |
| 403 | TooManyComputes | The number of computing nodes exceeds the quota. | 计算节点数超过用户配额 |
| 403 | InvalidClusterStatus | The operation failed due to invalid cluster status. | 集群状态不允许执行本次操作。 |
| 403 | InvalidOpt | The specified operation is invalid. Please try again later. If the problem still exists, submit a ticket. | |
| 403 | ConflictOpt | A conflicting operation is running. | 有冲突的操作在执行中，请您稍后再试。 |
| 403 | ImageNotSupported | The specified image is not supported. | 暂不支持所选的镜像，请您更换镜像后重试。 |
| 404 | ImageNotFound | The specified image does not exist. | 指定的镜像不存在，请您检查该参数是否正确。 |
| 404 | ClusterNotFound | The specified cluster does not exist. | 指定的集群不存在，请您检查该参数是否正确。 |
| 404 | VolumeNotFound | The specified volume does not exist. | 指定的存储不存在，请您检查该参数是否正确。 |
| 404 | ManagerNotFound | The manager nodes do not exist or their status is abnormal. | 管理节点不存在或状态异常。 |
| 404 | ObjectNotFound | The specified object is not found. | 指定的对象未找到，请您检查该参数是否正确。 |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server | 请求失败，服务暂时不可用 |
| 406 | EcsError | An error occurred while calling the ECS API operation. | ECS API调用出错. %s |
| 406 | DbError | A database service error occurred. | 数据库请求失败 |
| 406 | AliyunError | An Alibaba Cloud product error occurred. | 阿里云产品错误。%s |
| 407 | NotAuthorized | You are not authorized by RAM for this request. | 此请求未获得RAM授权 |
| 409 | PartFailure | Part of the batch operation failed. | 批量操作部分失败 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。