调用ExtendCluster扩容灵骏集群-人工智能平台 PAI-阿里云-智能计算灵骏(LINGJUN)-阿里云帮助中心

集群扩容。

接口说明

关闭远程会话的接口。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

eflo:ExtendCluster

update

*Cluster

acs:eflo:{#regionId}:{#accountId}:cluster/{#ClusterId}

eflo:ImageSource
eflo:ImageOwnerId

无

请求参数

名称	类型	必填	描述	示例值
ClusterId	string	否	集群 ID	i15b480fbd2fcdbc2869cd80
NodeGroups	array<object>	否	节点组
	array<object>	否	节点组
Amount	integer	否	购买节点的数量。取值范围：0～500。如果 Amount 参数取值为 0，则表示不购买节点，使用已有节点进行扩容。如果 Amount 参数取值为 1～500，则表示购买一定数量节点，并使用购买的节点进行扩容。默认值：0	4
AutoRenew	boolean	否	购买的节点是否要自动续费。当 Amount 参数取值不为 0 且 ChargeType 取值为 PREPAY 或 POSTPAY 时，该参数生效。取值范围： True：自动续费 ; False：不自动续费。默认值：False	True
ChargeType	string	否	节点的付费方式。当 Amount 参数取值为 0 时，该参数不生效。取值范围： PREPAY：包年包月；POSTPAY：按量付费。默认值：PREPAY。	PostPaid
Hostnames	array	否	设置购买节点的主机名。当 Amount 参数取值为 0 时，该参数不生效。
	string	否	主机名。	i22c11282.eu95sqa
HyperNodes	array<object>	否	超节点列表
	array<object>	否	超节点信息
DataDisk	array<object>	否	磁盘信息列表
	object	否	磁盘信息
BurstingEnabled	boolean	否	是否开启 Burst（性能突发）。	false
Category	string	否	磁盘类型。取值范围： cloud_essd：ESSD 云盘。	cloud_essd
DeleteWithNode	boolean	否	数据盘是否随节点退订删除	True
Device	string	否	数据盘的设备名。该参数仅用于全镜像场景，您可以通过此参数设置数据盘设备名，和全镜像中源数据盘进行匹配，并可修改对应数据盘属性。非全镜像扩容，Device 由系统默认设置；使用全镜像扩容时：无论是否显示设置数据盘参数，系统都会为用户恢复出源镜像中的数据盘，其内容和源镜像数据盘一致。显示指定数据盘，但参数未设置 Deivce，此时会创建出额外空数据盘，其数量和属性为用户数据盘参数指定。显示指定数据盘 Deivce，但 Device 和源镜像数据盘 Device 不匹配，此时会创建出额外空数据盘，其数量和属性为用户数据盘参数指定。显示指定多块数据盘及其 Device，但 Device 全部指向源镜像的某一块数据盘 device。此时用户指定的多块数据盘中只有 1 块通过 device 匹配并覆盖源镜像数据盘，其他指定数据盘被静默丢弃，不会创建出额外空数据盘。显示指定数据盘 Deivce，且 Device 和源镜像数据盘 Device 匹配，此时不会创建出额外空数据盘，用户指定的数据盘通过 deivce 和源镜像数据盘一一对应。如果用户设置的数据盘 Size 小于源镜像数据盘 Size，返回 Http Code : 417 ，ErrorMessage : Data disk Size can not be less than the image data disk snapshot size for Device '/dev/xvdb'。节点指定挂载数据盘数量 + 通过镜像恢复的数据盘数量：普通云盘分组，不超过 16 块；开启 CPFS，不超过 4 块。	/dev/xvdb
PerformanceLevel	string	否	创建 ESSD 云盘作为系统盘使用时，设置云盘的性能等级。取值范围： PL0：单盘最高随机读写 IOPS 1 万。 PL1：单盘最高随机读写 IOPS 5 万。	PL1
ProvisionedIops	integer	否	ESSD AutoPL 云盘（单盘）预配置性能的读写 IOPS。	9600
Size	integer	否	磁盘大小，单位 GiB。	10
Hostname	string	否	主机名	liliang-rmn7stf7-0000
HyperNodeId	string	否	超节点 ID	e01-cn-2r42tmj4z02
LoginPassword	string	否	登录密码	***
SecurityGroupId	string	否	安全组 ID	sg-uf68xu2102avz7pl3t5d
VSwitchId	string	否	交换机 ID	vsw-8vbobo4cvzsygw98f4j6b
VpcId	string	否	专有网络 ID	vpc-0jl8gs7qmx89739e210dn
LoginPassword	string	否	设置购买节点的登录密码。当 Amount 参数取值为 0 时，该参数不生效。	skkO(*89Y
NodeGroupId	string	否	节点组 ID	i16d4883a46cbadeb4bc9
NodeTag	array<object>	否	节点标签
	object	否	节点标签
Key	string	否	节点标签 key	key_my
Value	string	否	节点标签 value	value_my
Nodes	array<object>	否	节点列表
	array<object>	否	节点列表
DataDisk	array<object>	否	数据盘规格
	object	否	数据盘规格
BurstingEnabled	boolean	否	是否开启 Burst（性能突发）	true
Category	string	否	类型	cloud_essd
DeleteWithNode	boolean	否	数据盘是否随节点退订删除	true
Device	string	否	数据盘的设备名。该参数仅用于全镜像场景，您可以通过此参数设置数据盘设备名，和全镜像中源数据盘进行匹配，并可修改对应数据盘属性。非全镜像扩容，Device 由系统默认设置；使用全镜像扩容时：无论是否显示设置数据盘参数，系统都会为用户恢复出源镜像中的数据盘，其内容和源镜像数据盘一致。显示指定数据盘，但参数未设置 Deivce，此时会创建出额外空数据盘，其数量和属性为用户数据盘参数指定。显示指定数据盘 Deivce，但 Device 和源镜像数据盘 Device 不匹配，此时会创建出额外空数据盘，其数量和属性为用户数据盘参数指定。显示指定多块数据盘及其 Device，但 Device 全部指向源镜像的某一块数据盘 device。此时用户指定的多块数据盘中只有 1 块通过 device 匹配并覆盖源镜像数据盘，其他指定数据盘被静默丢弃，不会创建出额外空数据盘。显示指定数据盘 Deivce，且 Device 和源镜像数据盘 Device 匹配，此时不会创建出额外空数据盘，用户指定的数据盘通过 deivce 和源镜像数据盘一一对应。如果用户设置的数据盘 Size 小于源镜像数据盘 Size，返回 Http Code : 417 ，ErrorMessage : Data disk Size can not be less than the image data disk snapshot size for Device '/dev/xvdb'。节点指定挂载数据盘数量 + 通过镜像恢复的数据盘数量：普通云盘分组，不超过 16 块；开启 CPFS，不超过 4 块。	/dev/xvdb
PerformanceLevel	string	否	数据盘性能参数	PL0
ProvisionedIops	integer	否	预配置性能（IOPS）。取值范围为 0~50000。	1000
Size	integer	否	磁盘大小	80
Hostname	string	否	主机名	d044d220-33fd-11ed-86a6
LoginPassword	string	否	登录密码	***
NodeId	string	否	节点 ID	e01-cn-zvp2zdpy601
SecurityGroupId	string	否	安全组 ID	sg-uf68xu2102avz7pl3t5d
VSwitchId	string	否	交换机 ID	vsw-bp169pi5fj151rrms4sia
VpcId	string	否	专有网络 ID	vpc-0jlasms92fdxqd3wlf8ny
Period	integer	否	购买节点的时长（单位：月）。取值范围：1、6、12、24、36、48。当 Amount 参数取值不为 0 且 ChargeType 取值为 PREPAY 时，该参数生效。	6
SavingsPlanId	string	否	节省计划 ID	spn-25e985acAWbrwEBJ
UserData	string	否	自定义可执行 shell 脚本，需要以 Base64 方式编码，原始数据最多为 16 KB。	ZWNobyBoZWxsbyBlY3Mh
VSwitchId	string	否	交换机 ID	vsw-uf65m8xqjgy55xj9jw92n
VpcId	string	否	专有网络 ID	vpc-0jl3b0c0ukydlfezr13n6
ZoneId	string	否	可用区 ID	cn-hangzhou-i
IgnoreFailedNodeTasks	boolean	否	是否允许跳过失败节点，默认值为 False	false
VpdSubnets	array	否	集群子网列表
	string	否	vpd 子网	["subnet-3od2fe","subnet-fdo3dv"]
IpAllocationPolicy	array<object>	否	分配 IP 的组合策略：每个策略只能选择一种策略类型，可以有多个策略进行组合
	array<object>	否	分配 IP 策略
BondPolicy	object	否	根据 bond 名称指定集群子网 ID
BondDefaultSubnet	string	否	默认 bond 集群子网	subnet-3od2fe
Bonds	array<object>	否	bond 信息
	object	否	bond 对象
Name	string	否	bond 名称	Bond0
Subnet	string	否	IP 来源集群子网	subnet-3od2fe
MachineTypePolicy	array<object>	否	机型分配策略
	array<object>	否	策略对象
Bonds	array<object>	否	bond 信息
	object	否	bond 对象
Name	string	否	bond 名称	Bond0
Subnet	string	否	IP 来源集群子网	subnet-fdo3dv
MachineType	string	否	机型	efg1.nvga1
NodePolicy	array<object>	否	节点分配策略
	array<object>	否	策略对象
Bonds	array<object>	否	bond 信息
	object	否	bond 对象
Name	string	否	bond 名称	Bond0
Subnet	string	否	IP 来源集群子网	subnet-fdo3dv
Hostname	string	否	主机名	a100-xa5dza28-0085
NodeId	string	否	节点 ID	i-3fdodw2
VSwitchZoneId	string	否	交换机可用区 ID 枚举值： cn-beijing-d : cn-beijing-b	cn-shanghai-b

返回参数

名称	类型	描述	示例值
	object	出参
RequestId	string	请求 ID	03668372-18FF-5959-98D9-6B36A4643C7A
TaskId	string	任务 ID	i158475611663639202234

示例

正常返回示例

JSON格式

{
  "RequestId": "03668372-18FF-5959-98D9-6B36A4643C7A",
  "TaskId": "i158475611663639202234"
}

错误码

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

变更历史

更多信息，参考变更详情。