E-MapReduce (EMR) exposes its management operations through a remote procedure call (RPC) API. Use this reference to identify the correct API version, endpoint, and calling method before you start integrating.
API versions
Use the recommended version for each product:
| Product | Version | Status |
|---|---|---|
| EMR | 2021-03-20 | Recommended |
| EMR Workbench | 2024-04-30 | Recommended |
Endpoints
For the full list of regional endpoints, see:
Calling methods
The following calling methods are supported. Use the Alibaba Cloud SDK when possible—it handles authentication, retries, and serialization automatically.
| Method | Supported | Notes |
|---|---|---|
| Alibaba Cloud SDK (recommended) | Yes | See EMR SDKs and EMR Workbench SDKs for supported languages and installation |
| Alibaba Cloud CLI | Yes | Use aliyun commands to call APIs directly. Add --force --version 2021-03-20 (EMR) or --force --version 2024-04-30 (EMR Workbench) to target the recommended API version |
| Resource Orchestration Service (ROS) | Yes | — |
| Terraform | Yes | Supports the alicloud_emrv2_cluster resource type |
If none of the above methods meet your requirements, you can construct raw HTTP requests instead, though this method is not recommended. See Request syntax and signature method for details.