API版本选择建议
当前MRS服务对外API提供云服务自定义规范的API V1.1和V2两类接口，V2版本目前仅部分接口支持，主要用于提交作业和提交SQL语句。在接口功能相同的情况下，推荐您优先使用V2接口。
- MRS所有版本均支持V1.1接口。
- 针对MRS 1.X版本的集群，MRS 1.8.7及之后版本支持V2接口。
- 针对MRS 2.X版本的集群，MRS 2.0.3及之后版本支持V2接口。
在某些功能上V2接口以V1.1接口为基础，在功能上做了如下功能增强：
- 支持安全集群提交作业。
- 支持HiveSql、Spark python和Flink作业。
- 支持SparkSql和SparkScript结果查询。
整体API及对应功能列表详见API概览。
API接口调用流控说明
MapReduce服务对服务端API设置了调用次数限制，避免出现短时间内重复调用API导致服务中断的情况。
如果调用MRS API时，返回了“APIGW.0308”错误信息，是触发了API的流控限制，需要参考下表中的流控值，调整调用API的间隔时间，控制请求的发送速度；或者等待一段时间后，再发送API请求。
“APIGW”开头的错误码列表，详见错误码说明。
|
版本 |
接口分类 |
接口名称 |
单租户接口流控 |
|---|---|---|---|
|
V2 |
集群管理接口 |
创建集群 |
60次/分钟 |
|
修改集群名称 |
60次/分钟 |
||
|
创建集群并提交作业 |
60次/分钟 |
||
|
扩容集群 |
60次/分钟 |
||
|
缩容集群 |
60次/分钟 |
||
|
集群添加组件 |
60次/分钟 |
||
|
查询集群节点列表 |
200次/分钟 |
||
|
作业管理接口 |
新增并执行作业 |
60次/分钟 |
|
|
查询作业列表信息 |
1000次/分钟 |
||
|
查询单个作业信息 |
1000次/分钟 |
||
|
终止作业 |
60次/分钟 |
||
|
获取SQL结果 |
1000次/分钟 |
||
|
批量删除作业 |
60次/分钟 |
||
|
弹性伸缩接口 |
查看弹性伸缩策略 |
1000次/分钟 |
|
|
更新弹性伸缩策略 |
60次/分钟 |
||
|
删除弹性伸缩策略 |
60次/分钟 |
||
|
创建弹性伸缩策略 |
60次/分钟 |
||
|
集群HDFS文件接口 |
获取指定目录文件列表 |
1000次/分钟 |
|
|
SQL接口 |
提交SQL语句 |
60次/分钟 |
|
|
查询SQL结果 |
1000次/分钟 |
||
|
取消SQL执行任务 |
60次/分钟 |
||
|
委托管理 |
查询用户（组）与IAM委托的映射关系 |
1000次/分钟 |
|
|
更新用户（组）与IAM委托的映射关系 |
60次/分钟 |
||
|
数据连接管理 |
创建数据连接 |
60次/分钟 |
|
|
查询数据连接列表 |
1000次/分钟 |
||
|
更新数据连接 |
60次/分钟 |
||
|
删除数据连接 |
60次/分钟 |
||
|
版本元数据查询 |
展示MRS版本列表 |
1000次/分钟 |
|
|
查询MRS集群版本可用的规格 |
1000次/分钟 |
||
|
IAM同步管理接口 |
获取已经同步的IAM用户和用户组 |
1000次/分钟 |
|
|
IAM同步 |
60次/分钟 |
||
|
指定用户、用户组取消同步 |
60次/分钟 |
||
|
标签管理接口 |
集群操作默认标签 |
60次/分钟 |
|
|
查询默认标签状态 |
1000次/分钟 |
||
|
查询标签配额 |
1000次/分钟 |
||
|
V1.1 |
集群管理接口 |
创建集群并执行作业 |
60次/分钟 |
|
调整集群节点 |
60次/分钟 |
||
|
查询集群列表 |
1000次/分钟 |
||
|
查询集群详情 |
1000次/分钟 |
||
|
查询主机列表 |
1000次/分钟 |
||
|
删除集群 |
60次/分钟 |
||
|
弹性伸缩接口 |
配置弹性伸缩规则 |
60次/分钟 |
|
|
标签管理接口 |
给指定集群添加标签 |
60次/分钟 |
|
|
查询指定集群的标签 |
1000次/分钟 |
||
|
删除指定集群的标签 |
60次/分钟 |
||
|
批量添加集群标签 |
60次/分钟 |
||
|
批量删除集群标签 |
60次/分钟 |
||
|
查询所有标签 |
1000次/分钟 |
||
|
查询特定标签的集群列表 |
1000次/分钟 |
||
|
可用区 |
查询可用区信息 |
1000次/分钟 |
|
|
版本元数据查询 |
查询对应版本元数据 |
1000次/分钟 |
