添加已有ECS实例到ACK集群。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
cs:AttachInstances | Write |
|
| 无 |
请求语法
POST /clusters/{ClusterId}/attach
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ClusterId | string | 是 | 集群 ID。 | c106f377e16f34eb1808d6b9362c9**** |
body | object | 否 | 请求体参数。 | |
instances | array | 是 | 待添加实例列表。 | |
string | 否 | 待添加的实例 ID。 | i-2zed0sswuau6o89b**** | |
key_pair | string | 否 | 待添加实例的密钥对名称,和 说明
指定 nodepool_id 后,该参数不支持。
| security-key |
password | string | 否 | 待添加实例的 SSH 登录密码,和 出于安全性考虑,密码传输过程中都是经过加密处理的。 | Hello1234 |
format_disk | boolean | 否 | 是否将容器数据和镜像存储在数据盘中。取值:
默认值: 数据盘挂载规则:
说明
当选择将数据存储至数据盘并且 ECS 已挂载数据盘,数据盘内原有数据将丢失,请注意备份数据。
| false |
keep_instance_name | boolean | 否 | 是否保留原实例名称。取值:
默认值: | false |
is_edge_worker | boolean | 否 | 是否为边缘节点,即 ENS 节点。取值:
默认值: 说明
如果是边缘节点,取值必须是 true ,用于标识该节点类型为 ENS 节点。
| false |
nodepool_id | string | 否 | 节点池 ID。如果不指定,则将节点添加到默认节点池中。 | np615c0e0966124216a0412e10afe0**** |
image_id | string | 否 | 自定义镜像 ID,如果不传则使用默认系统镜像。 说明
| aliyun_2_1903_x64_20G_alibase_20200529.vhd |
cpu_policy | string | 否 | 节点 CPU 管理策略。当集群版本在 1.12.6 及以上时支持以下两种策略:
默认值: 说明
指定 nodepool_id 后,该参数不支持。
| none |
user_data | string | 否 | 节点自定义数据。更多详情,请参见生成实例自定义数据。 说明
指定 nodepool_id 后,该参数不支持。
| IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi |
rds_instances | array | 否 | RDS 实例列表。 | |
string | 否 | RDS 实例 ID。 说明
指定 nodepool_id 后,该参数不支持。
| rm-67yawhau**** | |
runtime | runtime | 否 | 容器运行时。 说明
指定 nodepool_id 后,该参数不支持。
| |
tags | array | 否 | 节点标签。标签定义规则:
说明
指定 nodepool_id 后,该参数不支持。
| |
tag | 否 | 节点标签。 |
返回参数
示例
正常返回示例
JSON
格式
{
"list": [
{
"code": "200",
"instanceId": "i-2ze0lgm3y6iylcbt****",
"message": "successful"
}
],
"task_id": "T-5a544aff80282e39ea000039"
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|