API standard and pre-built SDKs in multi-language
The OpenAPI specification of this product (Emr/2021-03-20) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.
Custom signature
If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).
Before you begin
An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. Create a Resource Access Management (RAM) user with API-only access and use RAM policies to apply the principle of least privilege (PoLP). Alibaba Cloud accounts are only used when explicitly required.
To call APIs securely, configure the following:
A RAM user account
An AccessKey pair for the account
Foundation
|
API |
Title |
Description |
| ListReleaseVersions | ListReleaseVersions | Queries the major E-MapReduce (EMR) versions. |
| ListInstanceTypes | ListInstanceTypes | Retrieves a list of EMR instance types. |
Clusters
|
API |
Title |
Description |
| RunCluster | RunCluster | Creates a pay-as-you-go or subscription cluster. |
| CreateCluster | CreateCluster | Creates a pay-as-you-go or subscription cluster. |
| GetCluster | GetCluster | Obtains the details of a cluster. |
| UpdateClusterAttribute | UpdateClusterAttribute | Updates cluster attributes. |
| ListClusters | ListClusters | Lists EMR clusters. |
| DeleteCluster | DeleteCluster | Deletes a pay-as-you-go cluster. |
| GetClusterCloneMeta | GetClusterCloneMeta | Obtains metadata of the E-MapReduce (EMR) cluster that you want to clone. This helps you call the CreateCluster API operation to quickly create an EMR cluster. |
| UpdateClusterAutoRenew | UpdateClusterAutoRenew | Enables or disables auto-renewal for an EMR cluster and its Elastic Compute Service (ECS) instances. |
Cluster Templates
|
API |
Title |
Description |
| CreateApiTemplate | CreateApiTemplate | Creates a predefined API operation template. The template contains information about an API operation, including the basic structure, request method, URL path, request parameters, and response format. |
| UpdateApiTemplate | UpdateApiTemplate | Updates an API operation template. |
| ListApiTemplates | ListApiTemplates | Lists API templates. |
| GetApiTemplate | GetApiTemplate | Queries the detailed configuration information about an API operation template. |
| DeleteApiTemplate | DeleteApiTemplate | Deletes an API operation template. |
| RunApiTemplate | RunApiTemplate | Runs an API template. |
Node groups
|
API |
Title |
Description |
| CreateNodeGroup | CreateNodeGroup | Creates a node group. |
| ListNodeGroups | ListNodeGroups | Queries the list of node groups in an EMR cluster. |
| GetNodeGroup | GetNodeGroup | You can call this operation to obtain the details of a node group. |
| IncreaseNodes | IncreaseNodes | Scales out the node group. |
| DecreaseNodes | DecreaseNodes | Performs a scale-out operation on the target node group. |
| ListNodes | ListNodes | Queries the node list of an EMR cluster. |
Auto Scaling
|
API |
Title |
Description |
| PutAutoScalingPolicy | PutAutoScalingPolicy | Adds a custom auto scaling rule. |
| GetAutoScalingPolicy | GetAutoScalingPolicy | Queries custom auto scaling rules. |
| GetManagedScalingPolicy | GetManagedScalingPolicy | Retrieves the details of a managed scaling policy. |
| RemoveAutoScalingPolicy | RemoveAutoScalingPolicy | Removes an auto scaling policy. |
| ListAutoScalingActivities | ListAutoScalingActivities | Lists Auto Scaling activities. |
| GetAutoScalingActivity | GetAutoScalingActivity | Queries the information about an auto scaling activity. |
Applications
|
API |
Title |
Description |
| ListApplications | ListApplications | Queries a list of applications. |
| GetApplication | GetApplication | Retrieves the details of an application. |
| RunApplicationAction | RunApplicationAction | Manages a service deployed in a cluster. For example, you can call this operation to start pr stop a service. |
| ListApplicationConfigs | ListApplicationConfigs | Queries the configurations of the application. |
| UpdateApplicationConfigs | UpdateApplicationConfigs | Updates the application configurations. |
| ListComponents | ListComponents | Retrieves a list of components. |
| ListComponentInstances | ListComponentInstances | Retrieves the list of component instances. |
Operations
|
API |
Title |
Description |
| GetOperation | GetOperation | Gets the details of an asynchronous operation. |
Resource groups
|
API |
Title |
Description |
| JoinResourceGroup | JoinResourceGroup | Adds an EMR resource to a resource group. A resource can belong to only one resource group. |
Tags
|
API |
Title |
Description |
| TagResources | TagResources | Binds tags to a specified EMR cluster. |
| UntagResources | UntagResources | Unbinds tags from a specified column in an EMR cluster. If the tag is not bound to other resources, the tag is automatically deleted. |
| ListTagResources | ListTagResources | Queries the tags that are bound to an EMR cluster. |
Scripts
|
API |
Title |
Description |
| CreateScript | CreateScript | Adds a bootstrap action or a common script of an E-MapReduce (EMR) cluster. |
| ListScripts | ListScripts | Query EMR cluster bootstrap scripts or regular scripts. |
| UpdateScript | UpdateScript | Updates a bootstrap action or a common script of an E-MapReduce (EMR) cluster. |
| DeleteScript | DeleteScript | Deletes a bootstrap action or a common script of an E-MapReduce (EMR) cluster. |
Monitoring Diagnostics
|
API |
Title |
Description |
| ListDoctorHiveDatabases | ListDoctorHiveDatabases | Obtains the analysis results of multiple Hive databases at a time. |
| GetDoctorHiveDatabase | GetDoctorHiveDatabase | Obtains the analysis results of a Hive database. |
| GetDoctorHiveCluster | GetDoctorHiveCluster | Obtains the analysis results of a Hive cluster. |
| ListDoctorHiveTables | ListDoctorHiveTables | Obtains the analysis results of multiple Hive tables at a time on E-MapReduce (EMR) Doctor. |
| GetDoctorHiveTable | GetDoctorHiveTable | Obtains the analysis results of a specific Hive table in a cluster on E-MapReduce (EMR) Doctor. |
| ListDoctorHDFSUGI | ListDoctorHDFSUGI | Obtains the analysis results of Hadoop Distributed File System (HDFS) storage resources for multiple owners or groups at a time on E-MapReduce (EMR) Doctor. |
| ListDoctorHBaseTables | ListDoctorHBaseTables | Obtains the information about multiple HBase tables at a time. |
| ListDoctorHBaseRegionServers | ListDoctorHBaseRegionServers | Obtains the information about multiple HBase RegionServers at a time. |
| GetDoctorHBaseTable | GetDoctorHBaseTable | Get HBase Table information. |
| GetDoctorHBaseRegionServer | GetDoctorHBaseRegionServer | Obtains the information about an HBase region server. |
| GetDoctorHBaseRegion | GetDoctorHBaseRegion | Get HBase Region information. |
| GetDoctorHBaseCluster | GetDoctorHBaseCluster | Obtains the metrics of an HBase cluster. |
| GetDoctorHDFSDirectory | GetDoctorHDFSDirectory | Obtains the analysis results of a specific Hadoop Distributed File System (HDFS) directory of a cluster. The depth of the directory is not greater than five. |
| ListDoctorJobsStats | ListDoctorJobsStats | Obtains the summary of basic running information about multiple jobs at a time on E-MapReduce (EMR) Doctor. |
| ListDoctorReports | ListDoctorReports | Obtains the overall analysis result reports of E-MapReduce (EMR) Doctor at a time. |
| GetDoctorReportComponentSummary | GetDoctorReportComponentSummary | Obtain the analysis result report of a specified component from EMR Doctor. |
| ListDoctorJobs | ListDoctorJobs | Obtains the basic running information about multiple jobs at a time on E-MapReduce (EMR) Doctor. |
| ListDoctorComputeSummary | ListDoctorComputeSummary | Obtains the information about resource usage by resource type in a cluster on E-MapReduce (EMR) Doctor. |
| GetDoctorComputeSummary | GetDoctorComputeSummary | Obtains the information about resource usage in a cluster on E-MapReduce (EMR) Doctor. |
| GetDoctorJob | GetDoctorJob | Obtains the basic running information about a job on E-MapReduce (EMR) Doctor. |
| ListDoctorApplications | ListDoctorApplications | Obtains the analysis results of multiple jobs on E-MapReduce (EMR) Doctor. |
| ListDoctorHDFSDirectories | ListDoctorHDFSDirectories | Retrieves batch analysis results for specific directories using EMR Doctor. The directory depth cannot exceed five levels. |
| GetDoctorHDFSCluster | GetDoctorHDFSCluster | Obtains the analysis results of the Hadoop Distributed File System (HDFS) storage resources of a cluster on E-MapReduce (EMR) Doctor. |
| GetDoctorApplication | GetDoctorApplication | Obtains job analysis information on E-MapReduce (EMR) Doctor. |
OpenLDAP User Management
|
API |
Title |
Description |
| CreateUsers | CreateUsers | Creates users in a batch. |
| DeleteUsers | DeleteUsers | Deletes multiple users at a time. |
| UpdateUserAttribute | UpdateUserAttribute | Updates the information about a user. |
| ListUsers | ListUsers | Queries a user. |
Other
|
API |
Title |
Description |
| ExportApplicationConfigs | ExportApplicationConfigs | Exports the configurations of a specified service in a cluster. |