首页 ExtendCluster

ExtendCluster

更新时间: 2026-07-22 16:32:26

Scales out a cluster.

Operation description

Closes a remote session.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

eflo:ExtendCluster

update

*Cluster

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

  • eflo:ImageSource
  • eflo:ImageOwnerId
None

Request parameters

Parameter

Type

Required

Description

Example

ClusterId

string

No

The cluster ID.

i15b480fbd2fcdbc2869cd80

NodeGroups

array<object>

No

The node groups.

array<object>

No

The node groups.

Nodes

array<object>

No

The node list.

array<object>

No

The node list.

Hostname

string

No

The hostname.

d044d220-33fd-11ed-86a6

NodeId

string

No

The node ID.

e01-cn-zvp2zdpy601

LoginPassword

string

No

The logon password.

***

VpcId

string

No

The VPC ID.

vpc-0jlasms92fdxqd3wlf8ny

VSwitchId

string

No

The vSwitch ID.

vsw-bp169pi5fj151rrms4sia

DataDisk

array<object>

No

The data cloud disk specifications.

object

No

Data disk specification.

DeleteWithNode

boolean

No

Whether the data disk is deleted when the node is unsubscribed.

true

Category

string

No

Disk type.

cloud_essd

Size

integer

No

Disk size.

80

PerformanceLevel

string

No

Data disk performance level.

PL0

BurstingEnabled

boolean

No

Whether to enable burst (performance bursting).

true

ProvisionedIops

integer

No

Provisioned performance (IOPS). Valid values: 0 to 50000.

1000

SecurityGroupId

string

No

The security group ID.

sg-uf68xu2102avz7pl3t5d

HyperNodes

array<object>

No

The list of hyper nodes.

array<object>

No

The hyper node information.

Hostname

string

No

The hostname.

liliang-rmn7stf7-0000

LoginPassword

string

No

The logon password.

***

HyperNodeId

string

No

The hyper node ID.

e01-cn-2r42tmj4z02

VpcId

string

No

The VPC ID.

vpc-0jl8gs7qmx89739e210dn

VSwitchId

string

No

The vSwitch ID.

vsw-8vbobo4cvzsygw98f4j6b

DataDisk

array<object>

No

The list of cloud disk information.

object

No

Disk information.

DeleteWithNode

boolean

No

Whether the data disk is deleted when the node is unsubscribed.

True

Category

string

No

Disk type. Valid values:

  • cloud_essd: ESSD cloud disk.

cloud_essd

Size

integer

No

Disk size, in GiB.

10

PerformanceLevel

string

No

The performance level of the ESSD cloud disk used as the system disk. Valid values:

  • PL0: maximum random read/write IOPS of 10,000 per disk.

  • PL1: maximum random read/write IOPS of 50,000 per disk.

PL1

BurstingEnabled

boolean

No

Whether to enable burst (performance bursting).

false

ProvisionedIops

integer

No

Provisioned read/write IOPS of the ESSD AutoPL cloud disk (per disk).

9600

SecurityGroupId

string

No

The security group ID.

sg-uf68xu2102avz7pl3t5d

NodeGroupId

string

No

The node group ID.

i16d4883a46cbadeb4bc9

UserData

string

No

The custom executable shell script. The script must be Base64-encoded. The maximum size of the raw data is 16 KB.

ZWNobyBoZWxsbyBlY3Mh

ZoneId

string

No

The zone ID.

cn-hangzhou-i

Amount

integer

No

The number of nodes to purchase. Valid values: 0 to 500. If Amount is set to 0, no nodes are purchased and existing nodes are used for scale-out. If Amount is set to a value from 1 to 500, the specified number of nodes are purchased and used for scale-out. Default value: 0

4

ChargeType

string

No

The billing method of the nodes. This parameter does not take effect when Amount is set to 0. Valid values: PREPAY: subscription. POSTPAY: pay-as-you-go. Default value: PREPAY.

PostPaid

Period

integer

No

The subscription duration of the purchased nodes. Unit: months. Valid values: 1, 6, 12, 24, 36, and 48. This parameter takes effect when Amount is not 0 and ChargeType is set to PREPAY.

6

AutoRenew

boolean

No

Specifies whether to enable auto-renewal for the purchased nodes. This parameter takes effect when Amount is not 0 and ChargeType is set to PREPAY or POSTPAY. Valid values: True: Enable auto-renewal. False: Disable auto-renewal. Default value: False.

True

Hostnames

array

No

The hostnames of the purchased nodes. This parameter does not take effect when Amount is set to 0.

string

No

The hostname.

i22c11282.eu95sqa

LoginPassword

string

No

The logon password of the purchased nodes. This parameter does not take effect when Amount is set to 0.

skkO(*89Y

NodeTag

array<object>

No

The node tags.

object

No

The node tags.

Key

string

No

The tag key of the node.

key_my

Value

string

No

The tag value of the node.

value_my

VpcId

string

No

The VPC ID.

vpc-0jl3b0c0ukydlfezr13n6

VSwitchId

string

No

The vSwitch ID.

vsw-uf65m8xqjgy55xj9jw92n

SavingsPlanId

string

No

The savings plan ID.

spn-25e985acAWbrwEBJ

IgnoreFailedNodeTasks

boolean

No

Specifies whether to skip failed nodes. Default value: False.

False

VpdSubnets

array

No

The list of cluster subnets.

string

No

The VPD subnet.

["subnet-3od2fe","subnet-fdo3dv"]

IpAllocationPolicy

array<object>

No

The combined IP allocation policy. Each policy can use only one policy type, and multiple policies can be combined.

array<object>

No

The IP allocation policy.

BondPolicy

object

No

Specifies the cluster subnet ID based on the bond name.

BondDefaultSubnet

string

No

The default bond cluster subnet.

subnet-3od2fe

Bonds

array<object>

No

The bond information.

object

No

The bond object.

Name

string

No

Bond name.

Bond0

Subnet

string

No

IP source cluster subnet.

subnet-3od2fe

MachineTypePolicy

array<object>

No

The machine type allocation policy.

array<object>

No

The policy object.

Bonds

array<object>

No

The bond information.

object

No

Bond object.

Name

string

No

Bond name.

Bond0

Subnet

string

No

IP source cluster subnet.

subnet-fdo3dv

MachineType

string

No

The machine type.

efg1.nvga1

NodePolicy

array<object>

No

The node allocation policy.

array<object>

No

The policy object.

Bonds

array<object>

No

The bond information.

object

No

Bond object.

Name

string

No

Bond name.

Bond0

Subnet

string

No

IP source cluster subnet.

subnet-fdo3dv

NodeId

string

No

The node ID.

i-3fdodw2

Hostname

string

No

The hostname.

a100-xa5dza28-0085

VSwitchZoneId

string

No

The zone ID of the vSwitch.

Valid values:

  • cn-beijing-d :

    cn-beijing-b

cn-shanghai-b

Response elements

Element

Type

Description

Example

object

The response parameters.

RequestId

string

The request ID.

03668372-18FF-5959-98D9-6B36A4643C7A

TaskId

string

The task ID.

i158475611663639202234

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.

阿里云首页 智能计算灵骏 相关技术圈