文档

CreateCluster - 创建集群

更新时间:

创建一个按量付费或者预付费(包年包月)的集群。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
emr:CreateCluster
  • 全部资源
    *

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。

cn-hangzhou
ResourceGroupIdstring

资源组 ID。

rg-acfmzabjyop****
PaymentTypestring

付费类型。取值范围:

  • PayAsYouGo:后付费。
  • Subscription:预付费。

默认值:PayAsYouGo。

PayAsYouGo
SubscriptionConfigSubscriptionConfig

预付费配置。当 PaymentType 取值为 Subscription 时必填。

ClusterTypestring

集群类型。取值范围:

  • DATALAKE:新版数据湖。
  • OLAP:数据分析。
  • DATAFLOW:实时数据流。
  • DATASERVING:数据服务。
  • CUSTOM:自定义混部集群。
  • HADOOP:旧版数据湖(不推荐使用,建议使用新版数据湖)。

如果您在 2022 年 12 月 19 日 17 点(UTC+8)以后第一次创建 EMR 集群,不能选择 HADOOP、DATA_SCIENCE、PRESTO、ZOOKEEPER 集群类型。

DATALAKE
ReleaseVersionstring

EMR 发行版。可通过 EMR 集群售卖页面查看 EMR 发行版。

EMR-5.8.0
ClusterNamestring

集群名称。长度为 1~128 个字符,必须以大小字母或中文开头,不能以 http:// 和 https:// 开头。可以包含中文、英文、数字、半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)

emrtest
DeployModestring

集群中的应用部署模式。取值范围:

  • NORMAL(默认值):非高可用部署。集群 1 个 MASTER 节点。
  • HA:高可用部署。高可用部署要求至少 3 个 MASTER 节点。
HA
SecurityModestring

集群 Kerberos 安全模式。取值范围:

  • NORMAL(默认值):普通模式,不开启 Kerberos 模式。
  • KERBEROS:开启 Kerberos 模式。
NORMAL
Applicationsarray

应用列表。数组元素个数 N 的取值范围:1~100。

Application

应用。

ApplicationConfigsarray

应用配置。数组元素个数 N 的取值范围:1~1000。

ApplicationConfig

应用配置。

NodeAttributesNodeAttributes

节点属性。集群所有 ECS 节点基础属性。

NodeGroupsarray

节点组配置数组。数组元素个数 N 的取值范围:1~100。

NodeGroupConfig

节点组配置。

BootstrapScriptsarray

引导脚本数组。数组元素个数 N 的取值范围:1~10。

Script

引导脚本。

Tagsarray

标签。数组元数个数 N 的取值范围:0~20。

Tag

标签。

ClientTokenstring

幂等客户端 TOKEN。同一个 ClientToken 多次调用的返回结果一致,同一个 ClientToken 最多只创建一个集群。

A7D960FA-6DBA-5E07-8746-A63E3E4D****

返回参数

名称类型描述示例值
object

返回数据

ClusterIdstring

集群 ID。

c-b933c5aac7f7***
OperationIdstring

操作 ID。

op-13c37a77c505****
RequestIdstring

请求 ID。

DD6B1B2A-5837-5237-ABE4-FF0C8944****

示例

正常返回示例

JSON格式

{
  "ClusterId": "c-b933c5aac7f7***",
  "OperationId": "op-13c37a77c505****",
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

错误码

HTTP status code错误码错误信息描述
400OperationDeniedThe operation is invalid. %s操作被拒绝。
400OutOfStockThe requested resource is sold out in the specified zone, try other types of resources or other regions and zones.请求的资源库存不足,请尝试其他类型资源,或者其他可用区,或者其他区域。
400QuotaExceededRequest fail due to quota exceed. %s因配额超出导致请求失败。
400AccountExceptionAccount exception. %s账号异常。
400ConflictParametersParameters that must not be used together. %s多个参数间存在冲突。
400IncompleteSignatureThe request signature is invalid.API请求签名不合法。
400InvalidActionThe action %s requested is invalid.不合法的Action。
400InvalidParameterThe specified parameter %s is not valid.参数错误。
400InvalidParameterValueThe input parameter %s is invalid or out of range.参数值超出范围。
400MissingActionThe action %s requested is missing.缺少Action参数
400MissingParameterThe input parameter %s that is mandatory for processing this request is not supplied.参数缺失。
400NotAuthorizedYou do not have permission to perform this action. %s没有权限。
400ThrottlingExceptionThe request was denied due to request throttling. %s限流。
404ResourceNotFoundThe resource not found by %s.请求的资源未找到。
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.内部错误。
503ServiceFailureThe request has failed due to a temporary failure of %s service.依赖的阿里云其他服务不可用。
503ServiceUnavailableThe request has failed due to a temporary failure of the server.请求超时或者服务不可用。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-09-14OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2023-08-30OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2023-04-20OpenAPI 错误码发生变更查看变更详情