All Products
Search
Document Center

E-MapReduce:UpdateNodeGroupAttributes

Last Updated:Jun 22, 2026

Updates the attributes of a node group.

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

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

The region ID.

cn-hangzhou

ClusterId

string

Yes

The cluster ID.

c-b933c5aac8fe****

NodeGroupId

string

Yes

The node group ID.

ng-869471354ecd****

NodeGroupName

string

No

The node group name.

CORE1

Description

string

No

The node group description.

emr-core-1

VSwitchId deprecated

string

No

The vSwitch ID.

vsw-hp35g7ya5ymw68mmg****

AdditionalSecurityGroupIds deprecated

array

No

The list of security group IDs.

["sg-hp3abbae8lb6lmb1****"]

string

No

The additional security group ID.

sg-2ze7z8a4kxz8l0am6l09

KeyPairName deprecated

string

No

The key pair for ECS logon.

test_pair

MinSize

integer

No

The minimum number of instances in the node group.

0

MaxSize

integer

No

The maximum number of instances in the node group.

200

EnableGracefulDecommission

boolean

No

Specifies whether to enable graceful decommission. When a cluster is created in V303, graceful decommission is disabled by default for task groups.

true

SpotInstanceRemedy

boolean

No

Specifies whether to enable spot instance supplementation. If this feature is enabled, the scaling group attempts to create new instances to replace spot instances that are about to be reclaimed when the system sends a reclamation notification. Default value: false.

true

NodeResizeStrategy

string

No

The node scale-out strategy. Valid values: COST_OPTIMIZED and PRIORITY. Default value: PRIORITY.

PRIORITY

CostOptimizedConfig CostOptimizedConfig

No

The cost-optimized mode configuration.

SpotBidPrices

array

No

The maximum bid prices for spot instances. This parameter takes effect only when spotStrategy is set to SpotWithPriceLimit.

SpotBidPrice

No

The maximum hourly bid price for the instance. The value can contain up to three decimal places. This parameter takes effect only when SpotStrategy is set to SpotWithPriceLimit.

EcsSpotStrategy

string

No

The spot instance strategy.

SpotWithPriceLimit

InstanceTypeList

array

No

The list of ECS instance types.

null

string

No

The instance type.

ecs.g8a.16xlarge

AutoCompensateState

boolean

No

The automatic compensation state.

false

NodeCount

integer

No

The target number of nodes in the node group.

8

AckConfig

AckConfig

No

The ACK cluster configuration.

Response elements

Element

Type

Description

Example

object

The response parameters.

RequestId

string

The request ID.

DD6B1B2A-5837-5237-ABE4-FF0C8944****

Examples

Success response

JSON format

{
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ConflictParameters Parameters that must not be used together. %s
400 IncompleteSignature The request signature is invalid.
400 InvalidAction The action %s requested is invalid.
400 InvalidParameter The specified parameter %s is not valid.
400 InvalidParameterValue The input parameter %s is invalid or out of range.
400 MissingAction The action %s requested is missing.
400 MissingParameter The input parameter %s that is mandatory for processing this request is not supplied.
400 NotAuthorized You do not have permission to perform this action. %s
400 ThrottlingException The request was denied due to request throttling. %s
500 InternalError The request processing has failed due to some unknown error, exception or failure.
404 ResourceNotFound The resource not found by %s.
503 ServiceFailure The request has failed due to a temporary failure of %s service.
503 ServiceUnavailable The request has failed due to a temporary failure of the server.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.