You need to enable JavaScript to run this app.
E-MapReduce

E-MapReduce

Copy page
Download PDF
Node group management
UpdateNodeGroupEcsSpec - Update node group ECS specifications
Copy page
Download PDF
UpdateNodeGroupEcsSpec - Update node group ECS specifications

Update node group ECS specifications

Usage notes

Call UpdateNodeGroupEcsSpec to update the payment type of a node group in an E-MapReduce (EMR) cluster.

important notes

You must have a Volcano Engine account and have enabled EMR permissions.

Request notes

Request method: POST
Request URL: https://emr.cn-beijing.volcengineapi.com/?Version=2023-08-15&Action=UpdateNodeGroupEcsSpec

Debug

request parameters

The following table lists only the unique request parameters for this API and some common parameters. For more information, see common parameters.

Parameter
Type
Required
Example value
Description
Action
String
Yes

UpdateNodeGroupEcsSpec

The operation to perform. Value: UpdateNodeGroupEcsSpec

Version
String
Yes

2023-08-15

API version. Value: 2023-08-15

ClusterId
String
Yes

emr-xxx

Cluster ID

NodeGroupId
String
Yes

task-1.emr-xxx

Node group ID

TargetEcsInstanceType
String
Yes

ecs.g2i.4xlarge

Target ECS specification to be changed

ClientToken
String
No

xxx

A unique identifier generated by the caller for this request, used to ensure idempotency

response parameters

The following table lists only the unique response parameters for this API. For more information, see response structure.

Parameter
Type
Example value
Description
ClusterId
String

emr-xxx

Cluster ID

OperationId
String

Orderxxx

Cluster operation ID

sample request

{ 
    "RequestId":null, 
    "RegionId":"cn-beijing", 
    "UserId":51xxx, 
    "AccountId":210xxxx, 
    "ClusterId":"emr-5ee7f08d7f527585e83d", 
    "NodeGroupId":"task-1.emr-5ee7f08d7f527585e83d", 
    "EcsInstanceTargetType":"ecs.g2i.4xlarge" 
}

sample response

{ 
    "ResponseMetadata": { 
        "RequestId": "202312042119240BF21498512xxx", 
        "Action": "UpdateNodeGroupEcsSpec", 
        "Version": "2023-08-15", 
        "Service": "emr", 
        "Region": "cn-beijing", 
        "Error": null, 
        "Deprecated": false 
    }, 
    "Result": { 
        "OperateId": "xxx", 
        "ClusterId": "emr-xxx", 
        "ResultData": null 
    } 
}

error codes

The following table lists the error codes related to the business logic of this API. For common error codes, see the common error codes documentation.

HttpCode
Error code
Error message
Note
400
InvalidRequest
Access Denied {clusterId}

No permission for this cluster

400
IllegalOperationForCluster
The cluster id {clusterId} does not support the operation

Illegal operation. This cluster does not support this operation

400
InvalidClusterId
cluster id {clusterId} not found

Cluster does not exist

Last updated: 2026.06.01 17:04:20