This article describes how to call the Volcano Engine E-MapReduce (EMR) OpenAPI.

Request structure #

To call the Volcano Engine OpenAPI, clients must send requests to the specified service endpoint, including both the Volcano Engine signature information and the business information required by the specific API. The request structure of the Volcano Engine OpenAPI is organized as follows, using an unencoded URL GetCluster sample request:

POST /?Action=GetCluster&Version=2023-08-15&<接口请求参数> HTTP/1.1
Host: emr.cn-beijing.volcengineapi.com 
Region: cn-beijing
Service: emr

• POST indicates the request method.
• Action=GetCluster specifies the API to be called, and Version=2023-08-15 is the API version.
• Host specifies the Volcano Engine service access address (Endpoint). For details, see Service address.
• Region and Service are the region and service name for the request. For details, see Public Parameters.
• HTTP specifies the request communication protocol.

Communication protocol #

Volcano Engine EMR OpenAPI supports request communication via HTTP or HTTPS. It is recommended to use HTTPS for enhanced security.

Request method #

For details on the request method, refer to the specific requirements of each API.

Request parameters #

Volcano Engine EMR OpenAPI request parameters include two types of parameters:

• Public request parameters: These must be included in every request. For details, see Public parameters.
• API request parameters: Refer to the API documentation for each service for details. See EMR API overview.

Character encoding #

Requests and responses use the UTF-8 character set for encoding.