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

E-MapReduce

  • Documentation
    • E-MapReduceAPI referenceEMR on ECS API referenceNode group managementScaleOutNodeGroup - scale out node group
Copy page
Download PDF
Node group management
ScaleOutNodeGroup - scale out node group
Copy page
Download PDF
ScaleOutNodeGroup - scale out node group

Scale out node group

Usage instructions

Call ScaleOutNodeGroup to scale out a node group in an E-MapReduce (EMR) cluster.

Important notes

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

Request instructions

Request method: POST
Request URL: https://open.volcengineapi.com/?Version=2023-08-15&Action=ListClusters

Debug

API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
Go to debug

Request parameters

The table below 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

ScaleOutNodeGroup

The operation to be performed. Value: ScaleOutNodeGroup.

Version
String
Yes

2023-08-15

API version. Value: 2023-08-15.

ClientToken
String
No

xxx

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

ClusterId
String
Yes

emr-xxx

Cluster ID.

NodeGroupId
String
Yes

core-1.emr-xxx

Node group ID.

ScaleOutNodeCount
Integer
Yes

1

Number of nodes to be scaled out.

ElasticScheduledInstanceType
String
No

ESI

Elastic scheduled instance type. Values: ESI (default): Elastic scheduled instance; Segmented: Elastic scheduled instance - time segment type.

ElasticScheduledInstanceDeliveryType
String
No

Immediate

Elastic scheduled instance - time segment delivery type. Values: Reserve (default): Reserved delivery; Immediate: Immediate delivery. Note: This parameter is required only when ElasticScheduledInstanceType is set to Segmented.

ElasticScheduledInstanceAutoReleaseAt
String
No

2023-03-29T17:50:00+08:00

Instance auto release time. Must be at a 10-minute interval. When ElasticScheduledInstanceType is set to Segmented, this parameter is required. Value range: If DeliveryType is Reserve, the earliest release time is the reserved delivery time segment plus 1 hour. If DeliveryType is Immediate, the earliest release time is the next 10-minute interval after the current time. For example, if the current time is 5:02, the earliest auto release time is 5:20.

ElasticScheduledInstanceEndDeliveryAt
String
No

2023-03-29T17:50:00+08:00

Payment settings for reserved instance. Instance end delivery time must be at a 10-minute interval, and the interval with StartDeliveryAt must be 10 minutes. Required when chargeType=SCHEDULED.

ElasticScheduledInstanceStartDeliveryAt
String
No

2023-03-29T17:50:00+08:00

Delivery start time settings for reserved instance. Instance start delivery time must be at a 10-minute interval. Required when chargeType=SCHEDULED.

Response parameters

The table below 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

emr-xxx

Cluster operation ID.

ResultData
Object

null

Returned result.

Sample request 

{ 
    "RequestId":null, 
    "RegionId":"cn-beijing", 
    "UserId":5xxx, 
    "AccountId":21000xxx, 
    "ClientToken":"12xxx", 
    "ClusterId":"emr-xxx", 
    "NodeGroupId":"core-1.emr-xxx", 
    "ScaleOutNodeCount":3 
}

Sample response 

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

Error codes

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

Status code
Error code
Error message
Note
400
InvalidClusterId

cluster id {clusterId} not found

Cluster does not exist.

400
InvalidRequest

Access Denied {clusterId}

No permission for this cluster.

Last updated: 2026.06.01 17:04:20