You can call the ListEmrMainVersion operation to query the list of E-MapReduce versions.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ListEmrMainVersion

The operation that you want to perform. This parameter is required for API requests initiated by piecing together HTTP or HTTPS URLs. Set the value to ListEmrMainVersion.

RegionId String Yes cn-hangzhou

The ID of the region. You can call the DescribeRegions operation to query the most recent list of regions.

EmrVersion String No EMR-3.16.0

The EMR version.

StackName String No EMR

The name of the software stack. Set the value to EMR.

StackVersion String No 3.16.0.1.2

The version of the software stack.

PageNumber Integer No 1

The number of the page to return. Pages start from page 1.

PageSize Integer No 10

The number of entries returned per page.

Response parameters

Parameter Type Example Description
EmrMainVersionList Array of EmrMainVersion

The list of EMR versions.

EmrMainVersion
ClusterTypeInfoList Array of ClusterTypeInfo

The list of cluster types.

ClusterTypeInfo
ClusterType String HADOOP

The type of the cluster.

ServiceInfoList Array of ServiceInfo

An array that consists of the information of services.

ServiceInfo
Display Boolean true

Indicates whether the service is displayed.

Mandatory Boolean true

Indicates whether the request parameter is required.

ServiceDisplayName String Hive

The display name of the service.

ServiceDisplayVersion String 2.3.3

The display version of the service.

ServiceName String HIVE

The name of the service.

ServiceVersion String 2.3.3.0.1

The internal version of the service.

ClusterTypeWhiteUserList Array of ClusterTypeWhiteUser

The list of cluster whitelist information.

ClusterTypeWhiteUser
ClusterType String HADOOP

The type of the cluster. Valid values:

  • HADOOP
  • KAFKA
  • DATA SCIENCE
  • DRUID
  • FLINK
  • GATEWAY
  • CLICKHOUSE
  • SHUFFLE_SERVICE
  • EMR_STUDIO
UserId String 1528342356764****

The ID of the user.

Display Boolean true

Indicates whether the cluster type is available.

EcmVersion Boolean true

Indicates whether the cluster type supports the software stack version.

EmrVersion String EMR-3.29.1

The EMR version.

ImageId String m-bp1hdwryap03nxpl****

The ID of the image.

PublishType String None

A reserved parameter.

RegionId String cn-hangzhou

The ID of the region.

StackName String EMR

A reserved parameter.

StackVersion String 3.29.1.2.2

A reserved parameter.

WhiteUserList List ""

A reserved parameter.

PageNumber Integer 1

The number of the page to return.

PageSize Integer 10

The number of entries returned per page.

RequestId String BF4FBAC6-B03E-4BFB-B6DB-EB53C34F2E22

The ID of the request.

TotalCount Integer 12

The total number of returned entries.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListEmrMainVersion
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<TotalCount>98</TotalCount>
<RequestId>D97D7163-6F2E-47C5-AC16-D926BC3D2158</RequestId>
<PageSize>10</PageSize>
<PageNumber>1</PageNumber>
<EmrMainVersionList>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp1e4xw8ys8srxjp****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-3.29.0</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>3.29.0.0.109</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp11z0k3d593hr40****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-3.29.1</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>3.29.1.2.2</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp1ascs0tl4zdbai****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-4.4.0</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>4.4.0.1.2</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp1edp201fgcgf71****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-3.28.2</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>3.28.2.0.4</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp11wvscj5y1ggv8****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-3.28.1</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>3.28.1.0.4</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp1i4eha5b7cw8y6****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-4.2.5</EmrVersion>
        <StackName>EMR</StackName>
        <Display>false</Display>
        <StackVersion>4.2.5.0.5</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp18ez855bmwofqs****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-4.2.4</EmrVersion>
        <StackName>EMR</StackName>
        <Display>false</Display>
        <StackVersion>4.2.4.0.4</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp1ewvm4yos67dpk****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-3.28.0</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>3.28.0.1.10</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp14nzsz01vp4cd0****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-4.3.0</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>4.3.0.1.9</StackVersion>
    </EmrMainVersion>
    <EmrMainVersion>
        <ClusterTypeInfoList>
        </ClusterTypeInfoList>
        <ImageId>m-bp15nu6jo58t11nr****</ImageId>
        <EcmVersion>true</EcmVersion>
        <WhiteUserList>
        </WhiteUserList>
        <ClusterTypeWhiteUserList>
        </ClusterTypeWhiteUserList>
        <RegionId>cn-hangzhou</RegionId>
        <EmrVersion>EMR-3.24.100</EmrVersion>
        <StackName>EMR</StackName>
        <Display>true</Display>
        <StackVersion>3.24.100.5.12</StackVersion>
    </EmrMainVersion>
</EmrMainVersionList>

JSON format

{
	"TotalCount": 98,
	"RequestId": "D97D7163-6F2E-47C5-AC16-D926BC3D2158",
	"PageSize": 10,
	"PageNumber": 1,
	"EmrMainVersionList": {
		"EmrMainVersion": [
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp1e4xw8ys8srxjp****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-3.29.0",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "3.29.0.0.109"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp11z0k3d593hr40****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-3.29.1",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "3.29.1.2.2"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp1ascs0tl4zdbai****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-4.4.0",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "4.4.0.1.2"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp1edp201fgcgf71****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-3.28.2",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "3.28.2.0.4"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp11wvscj5y1ggv8****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-3.28.1",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "3.28.1.0.4"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp1i4eha5b7cw8y6****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-4.2.5",
				"StackName": "EMR",
				"Display": false,
				"StackVersion": "4.2.5.0.5"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp18ez855bmwofqs****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-4.2.4",
				"StackName": "EMR",
				"Display": false,
				"StackVersion": "4.2.4.0.4"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp1ewvm4yos67dpk****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-3.28.0",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "3.28.0.1.10"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp14nzsz01vp4cd0****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-4.3.0",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "4.3.0.1.9"
			},
			{
				"ClusterTypeInfoList": {
					"ClusterTypeInfo": []
				},
				"ImageId": "m-bp15nu6jo58t11nr****",
				"EcmVersion": true,
				"WhiteUserList": {
					"WhiteUser": []
				},
				"ClusterTypeWhiteUserList": {
					"ClusterTypeWhiteUser": []
				},
				"RegionId": "cn-hangzhou",
				"EmrVersion": "EMR-3.24.100",
				"StackName": "EMR",
				"Display": true,
				"StackVersion": "3.24.100.5.12"
			}
		]
	}
}