# Alibaba Cloud E-MapReduce API

> Alibaba Cloud E-MapReduce API on Apizie: 77 endpoints (Creates a predefined API operation template. The template contains information about an API operation,…, Creates a pay-as-you-go or subscription cluster, Creates a node group, Creates a bootstrap script or a script for common clusters, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-emr/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-emr`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/emr
- Page: https://apizie.tech/api/cloud/aliyun-emr
- OpenAPI: https://apizie.tech/api/cloud/aliyun-emr/openapi.json

Alibaba Cloud OpenAPI for E-MapReduce (emr, version 2021-03-20). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates a predefined API operation template. The template contains information about an API operation,…
`POST https://apizie.tech/v1/cloud:aliyun-emr/create-api-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| TemplateName | string | yes | Cluster template name |
| ApiName | string | yes | The name of the API operation. You can create only a cluster API operation template. Set the value to CreateCluster |
| Content | string | yes | The content of the cluster API operation template. Set the value to JSON strings of the request parameters of the… |
| ResourceGroupId | string | no | Resource group ID |

### Creates a pay-as-you-go or subscription cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/create-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ResourceGroupId | string | no | The resource group ID |
| PaymentType | string | no | The billing method. Valid values: PayAsYouGo: pay-as-you-go. Subscription: subscription. Default value: PayAsYouGo |
| SubscriptionConfig | string | no | The subscription configurations. This parameter is required if you set PaymentType to Subscription (JSON-encoded) |
| ClusterType | string | yes | The cluster type. Valid values: DATALAKE: new data lake. OLAP: data analytics. DATAFLOW: real-time data stream. DATASERVING: data serving.… |
| ReleaseVersion | string | yes | The EMR release version. You can find the EMR release versions on the EMR cluster purchase page |
| ClusterName | string | yes | The cluster name. The name must be 1 to 128 characters in length. It must start with a letter or a Chinese character. It cannot start with… |
| DeployMode | string | no | The deployment mode of applications in the cluster. Valid values: NORMAL (default): non-high availability (HA) deployment. The cluster has… |
| SecurityMode | string | no | The Kerberos security mode of the cluster. Valid values: NORMAL (default): normal mode. Kerberos is disabled. KERBEROS: Kerberos mode.… |
| Applications | string | yes | The list of applications. The number of array elements N must be in the range of 1 to 100 (JSON-encoded) |
| ApplicationConfigs | string | no | The application configurations. The number of array elements N must be in the range of 1 to 1000 (JSON-encoded) |
| NodeAttributes | string | yes | The node attributes. This parameter specifies the basic attributes of all Elastic Compute Service (ECS) nodes in the cluster (JSON-encoded) |
| NodeGroups | string | yes | The array of node group configurations. The number of array elements N must be in the range of 1 to 100 (JSON-encoded) |
| BootstrapScripts | string | no | The array of bootstrap scripts. The number of array elements N must be in the range of 1 to 10 (JSON-encoded) |
| Tags | string | no | The tags. The number of array elements N must be in the range of 0 to 20 (JSON-encoded) |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. The results of multiple calls that use the same client token are… |
| Description | string | no | The description of the cluster |
| DeletionProtection | string | no | Specifies whether to enable deletion protection for the cluster. Valid values: true: enables deletion protection. false: disables deletion… |

### Creates a node group
`POST https://apizie.tech/v1/cloud:aliyun-emr/create-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroup | string | no | The information about the machine group (JSON-encoded) |

### Creates a bootstrap script or a script for common clusters
`POST https://apizie.tech/v1/cloud:aliyun-emr/create-script` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ScriptType | string | yes | The script type. Valid values: BOOTSTRAP: bootstrap script for ECS instances NORMAL: normal script |
| Scripts | string | yes | The list of scripts (JSON-encoded) |
| TimeoutSecs | string | no | The timeout period for manually executing a script, in seconds. Valid values: 1 to 300. Default value: 180. This parameter is not… |

### Creates users in a batch
`POST https://apizie.tech/v1/cloud:aliyun-emr/create-users` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| Users | string | yes | The list of users. The number of users must be from 0 to 10 (JSON-encoded) |

### Scales in the specified node group
`POST https://apizie.tech/v1/cloud:aliyun-emr/decrease-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The node group ID |
| DecreaseNodeCount | integer | no | The number of nodes to scale in. The value must be less than the number of active nodes in the current node group |
| NodeIds | string | no | The array of node IDs. Valid values for N: 1 to 500 (JSON-encoded) |
| BatchInterval | integer | no | The cooldown time between batches |
| BatchSize | integer | no | The number of nodes to take offline concurrently per batch |

### Deletes an API operation template
`POST https://apizie.tech/v1/cloud:aliyun-emr/delete-api-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | Region ID |
| TemplateId | string | yes | Cluster template ID |
| ApiName | string | yes | Interface name |
| ResourceGroupId | string | no | Resource group ID |

### Deletes a pay-as-you-go cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/delete-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The ID of the region in which you want to create the instance |
| ClusterId | string | yes | The ID of the cluster |

### Deletes a created cluster node group
`POST https://apizie.tech/v1/cloud:aliyun-emr/delete-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID. You can call [ListRegions](url) to query available regions |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The node group ID |
| Description | string | no | The description |

### Deletes a bootstrap action or a common script of an E-MapReduce (EMR) cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/delete-script` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ScriptType | string | yes | The type of the script. Valid values: BOOTSTRAP: indicates a bootstrap action of the Elastic Compute Service (ECS) instance. NORMAL:… |
| ScriptId | string | yes | The script ID |

### Deletes multiple users at a time
`POST https://apizie.tech/v1/cloud:aliyun-emr/delete-users` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| UserNames | string | no | The usernames. Number of elements in the array: 0 to 10 (JSON-encoded) |
| RegionId | string | yes | The region ID |

### Exports the specified service configurations of a cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/export-application-configs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ApplicationConfigFiles | string | no | The list of application configurations to export (JSON-encoded) |
| FileFormat | string | no | The file format for exporting application configurations. Valid values: JSON XML |
| ExportMode | string | no | The export mode for service configurations. Valid values: MODIFICATION ALL |
| ConfigScope | string | no | The configuration scope. Valid values: CLUSTER, NODE_GROUP, NODE, and ALL |
| NodeGroupIds | string | no | The list of node group IDs (JSON-encoded) |
| NodeIds | string | no | The list of node IDs (JSON-encoded) |

### Queries the detailed configuration information about an API operation template
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-api-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | Region ID |
| TemplateId | string | yes | Cluster template ID |

### GetApplication
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | 地域ID |
| ClusterId | string | yes | 集群ID |
| ApplicationName | string | yes | 应用名称 |

### Retrieves the details of an elastic scaling activity
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-auto-scaling-activity` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ScalingActivityId | string | yes | The scaling activity ID |

### Queries the custom elastic scaling policy
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-auto-scaling-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The node group ID |

### Obtains the details of a cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The ID of the cluster |

### Retrieves the metadata for cloning an EMR cluster to facilitate quick cluster creation by using the…
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-cluster-clone-meta` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |

### Obtains job analysis information on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| AppId | string | yes | The ID of the job that is submitted to YARN |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |

### Obtains the information about resource usage in a cluster on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-compute-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |
| ComponentInfo | string | no | The resource information, which is used to filter the results (JSON-encoded) |

### Retrieves the cluster-level metrics for an HBase cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hbase-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | The date in the YYYY-MM-DD format |

### Retrieves HBase region information
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hbase-region` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | The date in YYYY-MM-DD format |
| HbaseRegionId | string | yes | The region ID |

### Retrieves HBase RegionServer information
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hbase-region-server` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | The date. Format: YYYY-MM-DD |
| RegionServerHost | string | yes | The host of the RegionServer |

### Retrieves HBase table information
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hbase-table` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | The date in the YYYY-MM-DD format |
| TableName | string | yes | The table name |

### Obtains the analysis results of the Hadoop Distributed File System (HDFS) storage resources of a cluster on…
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hdfscluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |

### Obtains the analysis results of a specific Hadoop Distributed File System (HDFS) directory of a cluster. The…
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hdfsdirectory` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |
| DirPath | string | yes | The directory name. The depth of the directory is not greater than five |

### Obtains the analysis results of a Hive cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hive-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |

### Retrieves the dimension analysis results of a Hive database
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hive-database` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | The date in the YYYY-MM-DD format |
| DatabaseName | string | yes | The name of the database |

### Obtains the analysis results of a specific Hive table in a cluster on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-hive-table` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |
| TableName | string | yes | The table name. The table name must follow the rule in Hive. A name in the {database name.table identifier} format uniquely identifies a… |

### Obtains the basic running information about a job on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| AppId | string | yes | The ID of the job that is submitted to YARN |

### Retrieves the analysis report for a specified component in EMR Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-doctor-report-component-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| DateTime | string | yes | The date in the YYYY-MM-DD format |
| ComponentType | string | yes | The component filter type. Valid values: compute hive hdfs yarn oss hbase |

### Retrieves the details of a managed scaling policy
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-managed-scaling-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |

### Retrieves the details of a node group
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The node group ID |

### Gets the details of an asynchronous operation
`POST https://apizie.tech/v1/cloud:aliyun-emr/get-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The district ID |
| ClusterId | string | yes | The ID of the cluster that you want to query |
| OperationId | string | yes | The operation ID. References: https://help.aliyun.com/document_detail/454393.html https://help.aliyun.com/document_detail/454397.html |

### Scales out the target node group
`POST https://apizie.tech/v1/cloud:aliyun-emr/increase-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The node group ID. The target node group to scale out |
| IncreaseNodeCount | integer | yes | The number of nodes. The number of nodes to add in this scale-out operation. Valid values: 1 to 500 |
| AutoPayOrder | string | no | Specifies whether to enable automatic payment for the orders involved in this scale-out operation. This parameter takes effect only when… |
| AutoRenew | string | no | Specifies whether to enable auto-renewal for the nodes added in this scale-out operation. Default value: false. Valid values: true:… |
| PaymentDuration | integer | no | The payment duration. When the PaymentDurationUnit parameter is set to Month, valid values are 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48,… |
| PaymentDurationUnit | string | no | The payment duration unit. Valid values: Month: month |
| ApplicationConfigs | string | no | The application configurations. The number of array elements N ranges from 1 to 1000 (JSON-encoded) |
| MinIncreaseNodeCount | integer | no | The minimum number of nodes accepted for this scale-out operation. Valid values: 1 to 500. If this parameter is specified and the ECS… |
| Promotions | string | no | The list of coupons (JSON-encoded) |

### Adds an EMR resource to a resource group. A resource can belong to only one resource group
`POST https://apizie.tech/v1/cloud:aliyun-emr/join-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The ID of the region in which you want to create the instance |
| ResourceType | string | yes | The type of the resource. Valid values: cluster: cluster |
| ResourceGroupId | string | yes | The ID of the resource group |
| ResourceId | string | yes | The ID of the resource |

### Lists API templates
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-api-templates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The starting position for the read operation |
| MaxResults | integer | no | The maximum number of records to return in a single request |
| TemplateId | string | no | The cluster template ID |
| TemplateIds | string | no | A list of API template IDs (JSON-encoded) |
| ApiName | string | yes | The API operation name |
| TemplateName | string | no | The name of the cluster template |
| ResourceGroupId | string | no | The ID of the resource group |

### Queries the configurations of the application
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-application-configs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The page number of the next page returned |
| MaxResults | integer | no | The number of entries per page |
| ApplicationName | string | no | The name of the application |
| NodeGroupId | string | no | The ID of the node group |
| ConfigFileName | string | no | The name of the configuration file |
| ConfigItemKey | string | no | The key of the configuration item |
| ConfigItemValue | string | no | The value of the configuration item |
| NodeId | string | no | The node ID |

### Queries a list of applications
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-applications` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The page number of the next page returned |
| MaxResults | integer | no | The total number of pages |
| ApplicationNames | string | no | The application names (JSON-encoded) |

### Queries elastic scaling activities
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-auto-scaling-activities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The token that specifies the starting position of the current read |
| MaxResults | integer | no | The maximum number of records to return in a single request |
| NodeGroupId | string | no | The node group ID |
| ScalingRuleName | string | no | The name of the scaling rule |
| ScalingActivityStates | string | no | The states of the scaling activities. The number of array elements N ranges from 1 to 20 (JSON-encoded) |
| ScalingActivityType | string | no | The type of the scaling activity. Valid values: SCALE_OUT: Scale-out. SCALE_IN: Scale-in |
| StartTime | integer | no | The start timestamp to query the creation time of scaling activities. Unit: milliseconds |
| EndTime | integer | no | The end timestamp to query the creation time of scaling activities. Unit: milliseconds |
| ScalingPolicyType | string | no | The type of the elastic policy |
| InstanceChargeTypes | string | no | The billing methods of the instances. Valid values: ONDEMAND: Pay-as-you-go instance. SPOT: Spot instance. Default value: null, which… |

### Queries a list of EMR clusters
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-clusters` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The token that specifies the position from which to start reading. If this parameter is left empty, the query starts from the beginning |
| MaxResults | integer | no | The maximum number of records to return in a single request. Valid values: 1 to 100 |
| ClusterName | string | no | The name of the cluster |
| ResourceGroupId | string | no | The ID of the resource group |
| ClusterIds | string | no | The list of cluster IDs. The number of array elements N ranges from 1 to 100 (JSON-encoded) |
| ClusterTypes | string | no | The list of cluster types. The number of array elements N ranges from 1 to 100 (JSON-encoded) |
| ClusterStates | string | no | The array of cluster states. The number of array elements N ranges from 1 to 100 (JSON-encoded) |
| PaymentTypes | string | no | The payment types. Valid values of N: 1 to 2 (JSON-encoded) |
| Tags | string | no | The list of labels. The number of array elements N ranges from 1 to 20 (JSON-encoded) |

### ListComponentInstances
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-component-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | 地域ID |
| ClusterId | string | yes | 集群ID |
| NextToken | string | no | 标记当前开始读取的位置，置空表示从头开始 |
| MaxResults | integer | no | 一次获取的最大记录数。取值范围：1~100 |
| ApplicationNames | string | no | 应用名称列表 (JSON-encoded) |
| NodeIds | string | no | 节点ID列表 (JSON-encoded) |
| NodeNames | string | no | 节点名称列表 (JSON-encoded) |
| ComponentNames | string | no | 组件名称列表 (JSON-encoded) |
| ComponentStates | string | no | The ComponentStates (JSON-encoded) |
| ZoneId | string | no | The ZoneId |

### ListComponents
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-components` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | 地域ID |
| ClusterId | string | yes | 集群ID |
| NextToken | string | no | 标记当前开始读取的位置，置空表示从头开始 |
| MaxResults | integer | no | 一次获取的最大记录数。取值范围：1~100 |
| ApplicationNames | string | no | 应用名称列表 (JSON-encoded) |
| ComponentNames | string | no | 组件名称列表 (JSON-encoded) |
| ComponentStates | string | no | The ComponentStates (JSON-encoded) |

### Obtains the analysis results of multiple jobs on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-applications` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that is used in the request to retrieve a new page of results |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |
| AppIds | string | no | The IDs of jobs that are submitted to YARN (JSON-encoded) |
| Users | string | no | The users who submit the jobs (JSON-encoded) |
| Queues | string | no | The YARN queues to which the jobs are submitted (JSON-encoded) |
| Types | string | no | The YARN engines to which the jobs are submitted (JSON-encoded) |
| OrderType | string | no | The order in which you want to sort the query results. Valid values: ASC: the ascending order DESC: the descending order |
| OrderBy | string | no | The field that you use to sort the query results. Valid values: startTime: the time when the job starts endTime: the time when the job… |

### Obtains the information about resource usage by resource type in a cluster on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-compute-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that is used in the request to retrieve a new page of results |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |
| ComponentTypes | string | no | The resource types, which are used to filter query results. Valid values: engine: filters results by engine. queue: filters results by… |
| OrderType | string | no | The order in which you want to sort the query results. Valid values: ASC: in ascending order. DESC: in descending order |
| OrderBy | string | no | The basis on which you want to sort the query results. Valid values: vcoreSeconds: the total CPU consumption over time in seconds.… |

### Retrieves HBase RegionServer information in batches
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-hbase-region-servers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that specifies the starting position for the query |
| MaxResults | integer | no | The maximum number of records to return in a single request |
| DateTime | string | yes | The date. Format: YYYY-MM-DD |
| RegionServerHosts | string | no | The list of RegionServer hosts (JSON-encoded) |
| OrderType | string | no | The sort order. Valid values: ASC: ascending order. DESC: descending order |
| OrderBy | string | no | The sort field. Valid values: regionCount: the number of regions |

### Retrieves HBase table information in batches
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-hbase-tables` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The token that indicates the starting position for reading |
| MaxResults | integer | no | The maximum number of records to retrieve at a time |
| DateTime | string | yes | The date in the YYYY-MM-DD format |
| TableNames | string | no | The list of table names (JSON-encoded) |
| OrderType | string | no | The sort order. Valid values: ASC: ascending order DESC: descending order |
| OrderBy | string | no | The sort field. Valid values: tableSize: table size |

### Retrieves batch analysis results for specific directories using EMR Doctor. The directory depth cannot…
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-hdfsdirectories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The ID of the region |
| ClusterId | string | yes | The ID of the cluster |
| NextToken | string | no | The token that is used to start the next query |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| DateTime | string | yes | The date. The value is in the ISO 8601 format. For example, 2023-01-01 represents January 1, 2023 |
| DirPath | string | no | The path of the directory. The directory depth cannot exceed five levels. If you do not specify this parameter, the analysis results of… |
| OrderType | string | no | The sort order. Valid values: ASC: ascending DESC: descending |
| OrderBy | string | no | The property based on which to sort the query results. Valid values: totalFileCount: the total number of files. largeFileCount: the number… |

### Obtains the analysis results of Hadoop Distributed File System (HDFS) storage resources for multiple owners…
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-hdfsugi` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that is used in the request to retrieve a new page of results |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |
| Type | string | yes | The filter condition. Valid values: user group |
| OrderType | string | no | The order in which you want to sort the query results. Valid values: ASC: in ascending order DESC: in descending order |
| OrderBy | string | no | The basis on which you want to sort the query results. Valid values: totalFileCount: the total number of files totalDataSize: the total… |

### Retrieves the dimension analysis results of Hive databases in batches
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-hive-databases` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The token that indicates the starting position for reading |
| MaxResults | integer | no | The maximum number of records to return per request |
| DateTime | string | yes | The date. Format: YYYY-MM-DD |
| DatabaseNames | string | no | The list of database names (JSON-encoded) |
| OrderType | string | no | The sort order. Valid values: ASC: ascending order DESC: descending order |
| OrderBy | string | no | The sort criterion. Valid values: tableCount: the number of tables |

### Obtains the analysis results of multiple Hive tables at a time on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-hive-tables` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that is used in the request to retrieve a new page of results |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| DateTime | string | yes | Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023 |
| TableNames | string | no | The table names, which are used to filter the query results (JSON-encoded) |
| OrderType | string | no | The order in which you want to sort the query results. Valid value: ASC: in ascending order DESC: in descending order |
| OrderBy | string | no | The basis on which you want to sort the query results. Valid values: partitionNum: the number of partitions. totalFileCount: the total… |

### Obtains the basic running information about multiple jobs at a time on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that is used in the request to retrieve a new page of results |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| StartRange | string | no | The range of start time. You can filter jobs whose start time falls within the specified time range (JSON-encoded) |
| EndRange | string | no | The range of end time. You can filter jobs whose end time falls within the specified time range (JSON-encoded) |
| AppIds | string | no | The IDs of the jobs that are submitted to YARN (JSON-encoded) |
| Users | string | no | The users who submit the jobs (JSON-encoded) |
| Queues | string | no | The YARN queues to which the jobs are submitted (JSON-encoded) |
| Types | string | no | The YARN engines to which the jobs are submitted (JSON-encoded) |
| OrderType | string | no | The order in which you want to sort the query results. Valid values: ASC: the ascending order DESC: the descending order |
| OrderBy | string | no | The field that you use to sort the query results. Valid values: vcoreSeconds: the aggregated number of vCPUs that are allocated to the job… |

### Obtains the summary of basic running information about multiple jobs at a time on E-MapReduce (EMR) Doctor
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-jobs-stats` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that is used in the request to retrieve a new page of results |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| StartRange | string | no | The range of start time. You can filter jobs whose start time falls within the specified time range (JSON-encoded) |
| EndRange | string | no | The range of end time. You can filter jobs whose end time falls within the specified time range (JSON-encoded) |
| GroupBy | string | no | The fields that are used for grouping data. Currently, only the first value is used for grouping data. Combinations of multiple values… |
| OrderType | string | no | The order in which you want to sort the query results. Valid values: ASC: in ascending order DESC: in descending order |
| OrderBy | string | no | The field that you use to sort the query results. Valid values: vcoreSeconds: the aggregated number of vCPUs that are allocated to the job… |

### Retrieves the overall analysis result reports of EMR Doctor in batches
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-doctor-reports` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token that marks the position from which to start reading |
| MaxResults | integer | no | The maximum number of records to return in a single request |

### Retrieves a list of EMR instance types
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-instance-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | no | The cluster ID |
| ZoneId | string | yes | The zone ID |
| NodeGroupId | string | no | The node group ID |
| ClusterType | string | yes | The cluster type |
| PaymentType | string | yes | The billing method |
| NodeGroupType | string | yes | The node group type |
| IsModification | string | no | Specifies whether the operation is a specification change |
| ReleaseVersion | string | no | The EMR release version |
| DeployMode | string | no | The deployment mode |
| InstanceType | string | no | The instance type |

### Queries the node groups of an EMR cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-node-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The position from which to start reading. An empty value indicates that the reading starts from the beginning |
| MaxResults | integer | no | The maximum number of records to return in a single request. Valid values: 1 to 100 |
| NodeGroupIds | string | no | The IDs of the node groups. The number of array elements N ranges from 1 to 100 (JSON-encoded) |
| NodeGroupNames | string | no | The names of the node groups. The number of array elements N ranges from 1 to 100 (JSON-encoded) |
| NodeGroupTypes | string | no | The types of the node groups. The number of array elements N ranges from 1 to 100 (JSON-encoded) |
| NodeGroupStates | string | no | The states of the node groups. The number of array elements N ranges from 1 to 100 (JSON-encoded) |
| ZoneId | string | no | The zone ID used to filter node groups |

### Queries the nodes in an EMR cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The token that specifies the starting position for the current read operation. If this parameter is left empty, the read operation starts… |
| MaxResults | integer | no | The maximum number of records to return in a single request. Valid values: 1 to 100 |
| NodeGroupIds | string | no | The list of node group IDs (JSON-encoded) |
| NodeIds | string | no | The list of node IDs (JSON-encoded) |
| NodeNames | string | no | The list of node names (JSON-encoded) |
| PrivateIps | string | no | The private IP addresses (JSON-encoded) |
| PublicIps | string | no | The public IP addresses (JSON-encoded) |
| NodeStates | string | no | The node states (JSON-encoded) |
| Tags | string | no | The list of bound tags (JSON-encoded) |

### Queries the major E-MapReduce (EMR) versions
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-release-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| IaasType | string | no | The type of the IaaS resource |
| ClusterType | string | yes | The type of the cluster |

### Queries bootstrap scripts or common scripts of an EMR cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-scripts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The token that specifies the starting position for the query |
| MaxResults | integer | no | The maximum number of entries to return in a single request |
| ScriptType | string | yes | The type of the cluster script. Valid values: BOOTSTRAP: bootstrap script. NORMAL: common clusters script |
| ScriptName | string | no | The name of the cluster script. This parameter applies only to NORMAL scripts and supports fuzzy search |
| ScriptId | string | no | The ID of the cluster script. This parameter applies only to NORMAL scripts |
| Statuses | string | no | The list of script statuses (JSON-encoded) |

### Queries the tags attached to E-MapReduce (EMR) clusters
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| NextToken | string | no | The token to start the query. Leave this parameter empty to start the query from the beginning |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| ResourceType | string | yes | The resource type. Set the value to \`cluster\` |
| ResourceIds | string | no | The list of resource IDs. The number of elements in the array N must be 1 (JSON-encoded) |
| Tags | string | no | The tags. The number of elements in the array N can be from 1 to 20 (JSON-encoded) |

### Queries users
`POST https://apizie.tech/v1/cloud:aliyun-emr/list-users` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The token that indicates the starting position for reading |
| MaxResults | integer | no | The maximum number of records to return per request |
| UserName | string | no | The username. Fuzzy match is supported |
| UserNames | string | no | The list of usernames. Valid values for N: 0 to 20 (JSON-encoded) |

### Creates a custom Auto Scaling policy
`POST https://apizie.tech/v1/cloud:aliyun-emr/put-auto-scaling-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The node group ID |
| ScalingRules | string | no | The scaling rules. The number of elements in the array can be from 0 to 100 (JSON-encoded) |
| Constraints | string | no | The maximum and minimum size constraints for the node group (JSON-encoded) |

### Configures a managed elastic scaling policy
`POST https://apizie.tech/v1/cloud:aliyun-emr/put-managed-scaling-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| Constraints | string | no | The maximum and minimum value constraints of the cluster (JSON-encoded) |

### Removes an auto scaling policy
`POST https://apizie.tech/v1/cloud:aliyun-emr/remove-auto-scaling-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The ID of the node group |

### Runs an API template
`POST https://apizie.tech/v1/cloud:aliyun-emr/run-api-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| TemplateId | string | yes | The cluster template ID |
| ApiName | string | yes | The API name |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request |

### Manages a service deployed in a cluster. For example, you can call this operation to start pr stop a service
`POST https://apizie.tech/v1/cloud:aliyun-emr/run-application-action` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ActionName | string | yes | The name of the action. Valid values: start stop config restart refresh_queues refresh_labels |
| ComponentInstanceSelector | string | yes | The operation object (JSON-encoded) |
| RollingExecute | string | no | Specifies whether to enable rolling execution |
| ExecuteStrategy | string | no | The execution policy. Valid values: FAILED_BLOCK: The system stops the execution if the execution fails. FAILED_CONTINUE: The system… |
| Interval | integer | no | The interval for rolling execution. Unit: seconds |
| BatchSize | integer | no | The number of applications in each batch |
| Description | string | no | The description of the execution |

### Creates a pay-as-you-go or subscription cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/run-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ResourceGroupId | string | no | The resource group ID |
| PaymentType | string | no | The billing method. Valid values: PayAsYouGo: pay-as-you-go Subscription: subscription Default value: PayAsYouGo |
| SubscriptionConfig | string | no | The subscription configuration. This parameter is required when PaymentType is set to Subscription (JSON-encoded) |
| ClusterType | string | yes | The cluster type. Valid values: DATALAKE: new data lake OLAP: data analytics DATAFLOW: real-time data streaming DATASERVING: data serving… |
| ReleaseVersion | string | yes | The EMR release version. You can view the EMR release versions on the EMR cluster buy page |
| ClusterName | string | yes | The cluster name. The name must be 1 to 128 characters in length. It must start with a letter or a Chinese character and cannot start with… |
| DeployMode | string | no | The application deployment mode in the cluster. Valid values: NORMAL (default): Non-high-availability deployment. The cluster has one… |
| SecurityMode | string | no | The Kerberos security mode of the cluster. Valid values: NORMAL (default): Normal mode. Safe mode is not enabled. KERBEROS: Safe mode.… |
| Applications | string | yes | The list of applications. The array element count N ranges from 1 to 100 (JSON-encoded) |
| ApplicationConfigs | string | no | The application configurations. The array element count N ranges from 1 to 1000 (JSON-encoded) |
| NodeAttributes | string | no | The node attributes. This parameter specifies the basic attributes of all ECS nodes in the cluster (JSON-encoded) |
| NodeGroups | string | yes | The node group configuration array. The array element count N ranges from 1 to 100 (JSON-encoded) |
| BootstrapScripts | string | no | The bootstrap script array. The array element count N ranges from 1 to 10 (JSON-encoded) |
| Tags | string | no | The tags. Valid values of N: 0 to 20 (JSON-encoded) |
| ClientToken | string | no | The client token for idempotence. Calls with the same client token return the same result, and a maximum of one cluster is created for the… |
| Description | string | no | The cluster description |
| DeletionProtection | string | no | Specifies whether to enable deletion protection for the cluster. Valid values: true: Enabled. false: Disabled. Default value: false |
| Promotions | string | no | The list of coupons. The array element count N ranges from 1 to 100 (JSON-encoded) |

### Binds tags to a specified EMR cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The ID of the region in which you want to create the instance |
| ResourceType | string | yes | The type of the resource to which the tag belongs. Valid values: cluster: cluster |
| ResourceIds | string | yes | The list of resource IDs. Valid values of N: 1 to 1 (JSON-encoded) |
| Tags | string | yes | The tags (JSON-encoded) |

### Unbinds tags from a specified column in an EMR cluster. If the tag is not bound to other resources, the tag…
`POST https://apizie.tech/v1/cloud:aliyun-emr/untag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The ID of the region in which you want to create the instance |
| ResourceType | string | yes | The type of the resource. Set the value to cluster |
| ResourceIds | string | yes | The list of resource IDs (JSON-encoded) |
| TagKeys | string | no | The key of the label. Valid values of N: 1 to 20 (JSON-encoded) |
| All | string | no | Specifies whether to remove all tags. This parameter is valid only when the Tagkeys is empty. Valid values: true: All the data is deleted.… |

### Updates an API operation template
`POST https://apizie.tech/v1/cloud:aliyun-emr/update-api-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| TemplateName | string | yes | The name of the template |
| ApiName | string | yes | The name of the API operation. You can create only a cluster API operation template. Set the value to CreateCluster |
| Content | string | yes | The content of the cluster API operation template. Set the value to JSON strings of the request parameters of the… |
| ResourceGroupId | string | no | Resource group ID |
| TemplateId | string | yes | Template ID (it is recommended to use the parameter TemplateId) |

### Updates the application configuration
`POST https://apizie.tech/v1/cloud:aliyun-emr/update-application-configs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ApplicationName | string | yes | The application name |
| RefreshConfig | string | no | Specifies whether to refresh the configuration. Default value: true |
| ConfigAction | string | no | The configuration item action. Valid values: ADD: Add. UPDATE: Update. DELETE: Delete |
| ConfigScope | string | no | The configuration scope. Valid values: CLUSTER: Cluster level. NODE_GROUP: Node group level |
| ApplicationConfigs | string | yes | The list of application configurations (JSON-encoded) |
| Description | string | no | The description |
| NodeGroupId | string | no | The node group ID |
| NodeId | string | no | The node ID |

### Updates cluster attributes
`POST https://apizie.tech/v1/cloud:aliyun-emr/update-cluster-attribute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ClusterName | string | no | The cluster name |
| Description | string | no | The cluster description |
| DeletionProtection | string | no | Specifies whether release protection is enabled |

### Modifies the auto-renewal attributes of an EMR cluster and its ECS instances, specifically enabling or…
`POST https://apizie.tech/v1/cloud:aliyun-emr/update-cluster-auto-renew` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ClusterAutoRenew | string | no | Specifies whether to enable auto-renewal for the cluster. Valid values: true: Enables auto-renewal. false: Disables auto-renewal. Default… |
| ClusterAutoRenewDuration | integer | no | The auto-renewal duration of the cluster. This parameter takes effect only when ClusterAutoRenew is set to true. If… |
| ClusterAutoRenewDurationUnit | string | no | The unit of the auto-renewal duration of the cluster. Valid values: Month: month. Year: year. Default value: Month |
| RenewAllInstances | string | no | Indicates whether auto-renewal is enabled for all ECS instances in the cluster. Valid values: true: Enables auto-renewal for all ECS… |
| AutoRenewInstances | string | no | The list of ECS instances for which auto-renewal is configured. This parameter takes effect only when RenewAllInstances is not set to true… |

### Updates the attributes of a node group
`POST https://apizie.tech/v1/cloud:aliyun-emr/update-node-group-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| NodeGroupId | string | yes | The node group ID |
| NodeGroupName | string | no | The node group name |
| Description | string | no | The node group description |
| VSwitchId | string | no | The vSwitch ID |
| AdditionalSecurityGroupIds | string | no | The list of security group IDs (JSON-encoded) |
| KeyPairName | string | no | The key pair for ECS logon |
| MinSize | integer | no | The minimum number of instances in the node group |
| MaxSize | integer | no | The maximum number of instances in the node group |
| EnableGracefulDecommission | string | no | Specifies whether to enable graceful decommission. When a cluster is created in V303, graceful decommission is disabled by default for… |
| SpotInstanceRemedy | string | no | Specifies whether to enable spot instance supplementation. If this feature is enabled, the scaling group attempts to create new instances… |
| NodeResizeStrategy | string | no | The node scale-out strategy. Valid values: COST_OPTIMIZED and PRIORITY. Default value: PRIORITY |
| CostOptimizedConfig | string | no | The cost-optimized mode configuration (JSON-encoded) |
| SpotBidPrices | string | no | The maximum bid prices for spot instances. This parameter takes effect only when spotStrategy is set to SpotWithPriceLimit (JSON-encoded) |
| EcsSpotStrategy | string | no | The spot instance strategy |
| InstanceTypeList | string | no | The list of ECS instance types (JSON-encoded) |
| AutoCompensateState | string | no | The automatic compensation state |
| NodeCount | integer | no | The target number of nodes in the node group |
| AckConfig | string | no | The ACK cluster configuration (JSON-encoded) |

### Updates a bootstrap action or a common script of an E-MapReduce (EMR) cluster
`POST https://apizie.tech/v1/cloud:aliyun-emr/update-script` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| ScriptId | string | yes | The script ID |
| ScriptType | string | yes | The type of the script. Valid values: BOOTSTRAP: indicates a bootstrap action of the Elastic Compute Service (ECS) instance. NORMAL:… |
| Script | string | yes | The script (JSON-encoded) |

### Updates the information about a user
`POST https://apizie.tech/v1/cloud:aliyun-emr/update-user-attribute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ClusterId | string | yes | The cluster ID |
| UserId | string | no | The user ID |
| UserName | string | no | The username |
| Password | string | no | The user password |
| Description | string | no | The remarks of the user |

### version
`POST https://apizie.tech/v1/cloud:aliyun-emr/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://emr.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-emr/create-api-template" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud E-MapReduce API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-emr/create-api-template with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud E-MapReduce API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud E-MapReduce itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud E-MapReduce API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-emr.

### What is the status of the Alibaba Cloud E-MapReduce API?
Needs your own provider key (bring your own key)