Docs

E-MapReduce

Node group management

ListNodeGroupElasticScheduledInstances - Retrieve the list of ESI instances in a node group

Retrieve the list of ESI instances in a node group

Debugging

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 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	Description
Action	String	Yes	ListNodeGroupElasticScheduledInstances	The operation to perform. Value: ListNodeGroupElasticScheduledInstances.
Version	String	Yes	2023-08-15	API version. Value: 2023-08-15.
NodeGroupIds	Array of String	Yes	core-1.emr-xxx	Node group ID
ClusterId	String	Yes	emr-xxx	Cluster ID

response parameters

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

Parameter	Type	Example	Description
TotalCount	Integer	10	Total number of records
NextToken	String	NextToken	Token for the next page in paginated queries
MaxResults	Integer	10	Maximum number of records returned per query
Items	Array of Object	See below	List of scheduled instances

sample request

POST /?Action=ListNodeGroupElasticScheduledInstances&Version=2023-08-15 HTTP/1.1 
Host: emr.cn-beijing.volcengine-api.com 
Content-Type: application/json; charset=UTF-8 
X-Date: 20260321T090157Z 
X-Content-Sha256: 287e874e******d653b44d21e 
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260321/cn-beijing/emr/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f 

{ 
  "ClusterId": "y34edC1jW" 
}

sample response

{ 
  "ResponseMetadata": { 
    "RequestId": "20260321170204239141145072B1CAC5", 
    "Action": "ListNodeGroupElasticScheduledInstances", 
    "Version": "2023-08-15", 
    "Service": "emr", 
    "Region": "cn-beijing" 
  }, 
  "Result": { 
    "TotalCount": 452, 
    "NextToken": "lCsNVy", 
    "MaxResults": 299, 
    "Items": [] 
  } 
}

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.

Status code	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

Last updated: 2026.06.01 17:04:20

E-MapReduce

Debugging #

request parameters #

response parameters #

sample request #