本文为您介绍如何调用火山引擎 E-MapReduce（EMR）OpenAPI。

请求结构

客户调用火山引擎的OpenAPI接口，是通过向指定服务地址发送请求，并需满足火山引擎签名信息和具体接口的业务信息来完成的。火山引擎的OpenAPI的请求结构组织如下，以GetCluster一条未编码的URL请求示例：

POST /?Action=GetCluster&Version=2024-03-25&<接口请求参数> HTTP/1.1
Host: emr-serverless.cn-beijing.volcengineapi.com 
Region: cn-beijing
Service: emr_serverless

• POST表示请求方法。
• Action=GetCluster指定了要调用的API，Version=2024-03-25是API的版本。
• Host指定了火山引擎服务接入地址（Endpoint），具体请参见服务地址。
• Region和Service是请求的Region和服务名称，具体请参见公共参数。
• HTTP指定了请求通信协议。

通信协议

火山引擎 EMR OpenAPI 支持通过 HTTP 或 HTTPS 两种方式进行请求通信，推荐使用安全性更高的 HTTPS 方式发送请求。

请求方法

请求方法详见各个接口具体的需求。

请求参数

火山引擎 EMR OpenAPI 请求参数包含两类参数：

• 公共请求参数：需在每个请求中都必须包含，详见：公共参数。
• 接口请求参数：接口请求参数需参考各个服务的接口文档。

字符编码

请求及返回结果使用 UTF-8 的字符集进行编码。