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

E-MapReduce

Copy page
Download PDF
Node group management
DeleteNodeGroup - Delete node group
Copy page
Download PDF
DeleteNodeGroup - Delete node group

Delete node group

Usage note

Call DeleteNodeGroup to delete a node group under an E-MapReduce (EMR) cluster.

important notes

You must have a Volcano Engine account and have enabled EMR permissions.
You must first scale the number of nodes in the node group down to 0 before you can delete the node group.

Request details

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

Debug

request parameters

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

Parameter
Type
Required
Example value
Description
Action
String
Yes

DeleteNodeGroup

The operation to be performed. Value: DeleteNodeGroup

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

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 response parameters specific to 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":210xxx, 
    "ClusterId":"emr-xxx", 
    "NodeGroupId":"task-1.emr-xxx" 
}

sample response

{ 
    "ResponseMetadata": { 
        "RequestId": "202312042119240BF2149xxx", 
        "Action": "DeleteNodeGroup", 
        "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
InvalidClusterId
cluster id {clusterId} not found

Cluster does not exist

400
UnSupportedDeleteNodeGroup
UnSupported delete nodeGroup {0} When Group is not empty

Node group deletion is not supported when the node group is not empty.

Last updated: 2026.06.01 17:04:20