All Products
Search
Document Center

E-MapReduce:ListInstanceTypes

Last Updated:Oct 11, 2025

Retrieves a list of EMR instance types.

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

No

The cluster ID.

c-b933c5aac8fe****

ZoneId

string

Yes

The zone ID.

cn-beijing-h

NodeGroupId

string

No

The node group ID.

G-F06C4B47966A****

ClusterType

string

Yes

The cluster type.

DATALAKE

PaymentType

string

Yes

The billing method.

PayAsYouGo

NodeGroupType

string

Yes

The node group type.

CORE

IsModification

boolean

No

Specifies whether the instance type is for an instance type change. A value of true indicates an instance type change.

false

ReleaseVersion

string

No

The EMR release version.

线上已发布版本EMR-5.8.0

DeployMode

string

No

Specifies the deployment mode.

HA

InstanceType

string

No

The instance type.

ecs.g6.xlarge

Response elements

Element

Type

Description

Example

object

The response parameters.

InstanceTypes

array

The instance types.

InstanceType

The instance type.

RequestId

string

The request ID.

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

NextToken

string

A pagination token. It can be used in the next request to retrieve a new page of results.

DD6B1B2A-5837-5237-ABE4-FF0C89568980

MaxResults

integer

The maximum number of entries per page.

20

TotalCount

integer

The total number of entries returned.

200

Examples

Success response

JSON format

{
  "InstanceTypes": [
    {
      "InstanceTypeFamily": "ecs.g6",
      "InstanceType": "ecs.g6.large",
      "Status": "Available",
      "StockStatus": "WithStock",
      "Optimized": true,
      "CpuCore": 4,
      "InstanceCategory": "Compute-optimized",
      "CpuArchitecture": "X86",
      "LocalStorageCapacity": 40,
      "LocalStorageAmount": 8
    }
  ],
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "NextToken": "DD6B1B2A-5837-5237-ABE4-FF0C89568980",
  "MaxResults": 20,
  "TotalCount": 200
}

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.